@od-oneapp/analytics 2026.1.1301

package/dist/client.d.mts

@@ -0,0 +1,30 @@
+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 { a as screen, i as page, n as group, o as track, r as identify, t as alias } from "./emitters-DldkVSPp.mjs";
+import { a as ContextBuilder, c as createAnonymousSession, d as isGroupPayload, f as isIdentifyPayload, g as withUTM, h as withMetadata, i as getDistinctIdFromCookies, l as createUserSession, m as isTrackPayload, n as createMinimalBootstrapData, o as EventBatch, p as isPagePayload, r as generateDistinctId, s as PayloadBuilder, t as createBootstrapData, u as isAliasPayload } from "./posthog-bootstrap-DWxFrxlt.mjs";
+import { d as EcommerceEventSpec, m as OrderProperties, p as ExtendedProductProperties, r as CartProperties, t as BaseProductProperties } from "./types-CBvxUEaF.mjs";
+import { t as index_d_exports$1 } from "./index-jPzXRn52.mjs";
+import { t as index_d_exports } from "./index-BkIWe--N.mjs";
+import { a as createEmitterProcessor, i as validateConfig, n as createConfigBuilder, o as processEmitterPayload, r as getAnalyticsConfig, s as trackEcommerceEvent, t as PROVIDER_REQUIREMENTS } from "./config-DPS6bSYo.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";
+import { n as createAnalyticsManager, t as AnalyticsManager$1 } from "./manager-DvRRjza6.mjs";
+
+//#region src/client/manager.d.ts
+declare function createClientAnalytics(config: AnalyticsConfig): Promise<AnalyticsManager>;
+declare function createClientAnalyticsUninitialized(config: AnalyticsConfig): AnalyticsManager;
+//#endregion
+//#region src/shared/utils/validation-client.d.ts
+interface ValidationError {
+  field: string;
+  message: string;
+  provider: string;
+}
+interface ValidationResult {
+  errors: ValidationError[];
+  isValid: boolean;
+  warnings: string[];
+}
+declare function validateAnalyticsConfig(config: unknown): ValidationResult;
+declare function validateProvider(providerName: string, config: ProviderConfig): ValidationError[];
+//#endregion
+export { AnalyticsConfig, AnalyticsContext, AnalyticsManager, AnalyticsManager$1 as AnalyticsManagerClass, AnalyticsProvider, BaseProductProperties, BootstrapData, CartProperties, ConsoleConfig, ConsoleOptions, ContextBuilder, EcommerceEventSpec, EmitterAliasPayload, EmitterContext, EmitterGroupPayload, EmitterIdentifyPayload, EmitterOptions, EmitterPagePayload, EmitterPayload, EmitterTrackPayload, EventBatch, ExtendedProductProperties, OrderProperties, PROVIDER_REQUIREMENTS, PayloadBuilder, PostHogConfig, PostHogOptions, ProviderConfig, ProviderRegistry, SegmentConfig, SegmentOptions, TrackingOptions, VercelConfig, VercelOptions, index_d_exports as ai, alias, createAnalyticsManager, createAnonymousSession, createBootstrapData, createClientAnalytics, createClientAnalyticsUninitialized, createConfigBuilder, createEmitterProcessor, createMinimalBootstrapData, createUserSession, index_d_exports$1 as ecommerce, generateDistinctId, getAnalyticsConfig, getDistinctIdFromCookies, group, identify, isAliasPayload, isGroupPayload, isIdentifyPayload, isPagePayload, isTrackPayload, page, processEmitterPayload, screen, track, trackEcommerceEvent, validateAnalyticsConfig, validateConfig, validateProvider, withMetadata, withUTM };
+//# sourceMappingURL=client.d.mts.map

package/dist/client.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client/manager.ts","../src/shared/utils/validation-client.ts"],"mappings":";;;;;;;;;;;iBAiDsB,qBAAA,CAAsB,MAAA,EAAQ,eAAA,GAAkB,OAAA,CAAQ,gBAAA;AAAA,iBAmB9D,kCAAA,CAAmC,MAAA,EAAQ,eAAA,GAAkB,gBAAA;;;UC1DnE,eAAA;EACR,KAAA;EACA,OAAA;EACA,QAAA;AAAA;AAAA,UAGQ,gBAAA;EACR,MAAA,EAAQ,eAAA;EACR,OAAA;EACA,QAAA;AAAA;AAAA,iBAOc,uBAAA,CAAwB,MAAA,YAAkB,gBAAA;AAAA,iBAuD1C,gBAAA,CAAiB,YAAA,UAAsB,MAAA,EAAQ,cAAA,GAAiB,eAAA"}

package/dist/client.mjs

@@ -0,0 +1,186 @@
+import { t as ConsoleProvider } from "./console-8bND3mMU.mjs";
+import { HttpClientProvider } from "./providers-http-client.mjs";
+import { _ as AnalyticsManager, a as ContextBuilder, c as createAnonymousSession, d as isGroupPayload, f as isIdentifyPayload, g as withUTM, h as withMetadata, i as getDistinctIdFromCookies, l as createUserSession, m as isTrackPayload, n as createMinimalBootstrapData, o as EventBatch, p as isPagePayload, r as generateDistinctId, s as PayloadBuilder, t as createBootstrapData, u as isAliasPayload, v as createAnalyticsManager } from "./posthog-bootstrap-CYfIy_WS.mjs";
+import { a as screen, i as page, n as group, o as track, r as identify, t as alias } from "./emitters-6-nKo8i-.mjs";
+import { t as ecommerce_exports } from "./ecommerce-Cgu4wlux.mjs";
+import { t as ai_exports } from "./ai-YMnynb-t.mjs";
+import { a as createEmitterProcessor, i as validateConfig, n as createConfigBuilder, o as processEmitterPayload, r as getAnalyticsConfig, s as trackEcommerceEvent, t as PROVIDER_REQUIREMENTS } from "./config-P6P5adJg.mjs";
+import { SegmentClientProvider } from "@integrations/segment/analytics-provider/client";
+import { VercelClientProvider } from "@integrations/vercel/analytics-provider/client";
+
+//#region src/client/manager.ts
+/**
+* @fileoverview Client Analytics Manager
+*
+* Client-side analytics manager with static provider registry. Provides
+* factory functions for creating client analytics instances with support
+* for multiple providers (Console, HTTP, Segment, Vercel).
+*
+* **Providers Supported**:
+* - `console`: Console logging provider (development/debugging)
+* - `http`: HTTP provider for remote ingestion (oneapp-api)
+* - `segment`: Segment.io analytics provider
+* - `vercel`: Vercel Analytics provider
+*
+* @module @od-oneapp/analytics/client/manager
+*/
+const CLIENT_PROVIDERS = {
+	console: (config) => new ConsoleProvider(config),
+	http: (config) => new HttpClientProvider(config),
+	segment: (config) => new SegmentClientProvider(config),
+	vercel: (config) => new VercelClientProvider(config)
+};
+/**
+* Create and initialize a client analytics instance
+* This is the primary way to create analytics for client-side applications
+*
+* @example
+* ```typescript
+* const analytics = await createClientAnalytics({
+*   providers: {
+*     http: { endpoint: '/api/v1/ingest' },
+*   },
+* });
+* await analytics.track('Button Clicked', { variant: 'primary' });
+* ```
+* @param config - Analytics configuration including providers and settings
+* @returns Promise resolving to initialized analytics manager
+*/
+async function createClientAnalytics(config) {
+	const manager = createAnalyticsManager(config, CLIENT_PROVIDERS);
+	await manager.initialize();
+	return manager;
+}
+/**
+* Create a client analytics instance without initializing
+* Useful when you need to control initialization timing
+*
+* @example
+* ```typescript
+* const analytics = createClientAnalyticsUninitialized(config);
+* // later inside a lazy effect
+* await analytics.initialize();
+* ```
+* @param config - Analytics configuration including providers and settings
+* @returns Uninitialized analytics manager instance
+*/
+function createClientAnalyticsUninitialized(config) {
+	return createAnalyticsManager(config, CLIENT_PROVIDERS);
+}
+
+//#endregion
+//#region src/shared/utils/validation-client.ts
+/**
+* @fileoverview Client-safe validation utilities for analytics configuration
+* Client-safe validation utilities for analytics configuration
+* This file contains only validation functions that are safe to use in browser environments
+*/
+/**
+* Comprehensive configuration validation (client-safe version)
+* Accepts unknown input for defensive validation of potentially malformed configs
+*/
+function validateAnalyticsConfig(config) {
+	const errors = [];
+	const warnings = [];
+	if (!config || typeof config !== "object") {
+		errors.push({
+			provider: "global",
+			field: "config",
+			message: "Analytics configuration is required and must be an object"
+		});
+		return {
+			isValid: false,
+			errors,
+			warnings
+		};
+	}
+	const typedConfig = config;
+	if (!typedConfig.providers || typeof typedConfig.providers !== "object") {
+		errors.push({
+			provider: "global",
+			field: "providers",
+			message: "Providers configuration is required and must be an object"
+		});
+		return {
+			isValid: false,
+			errors,
+			warnings
+		};
+	}
+	if (Object.keys(typedConfig.providers).length === 0) warnings.push("No providers configured. Analytics will not track any events.");
+	for (const [providerName, providerConfig] of Object.entries(typedConfig.providers)) {
+		const providerErrors = validateProvider(providerName, providerConfig);
+		errors.push(...providerErrors);
+	}
+	if (typedConfig.providers.mixpanel) warnings.push("Mixpanel provider configured on client-side. Consider using server-side for better performance.");
+	return {
+		isValid: errors.length === 0,
+		errors,
+		warnings
+	};
+}
+/**
+* Validate a single provider configuration
+*/
+function validateProvider(providerName, config) {
+	const errors = [];
+	const knownProviders = [
+		"segment",
+		"posthog",
+		"vercel",
+		"console",
+		"mixpanel"
+	];
+	if (!knownProviders.includes(providerName)) {
+		errors.push({
+			provider: providerName,
+			field: "name",
+			message: `Unknown provider '${providerName}'. Known providers: ${knownProviders.join(", ")}`
+		});
+		return errors;
+	}
+	const requiredFields = PROVIDER_REQUIREMENTS[providerName] ?? [];
+	for (const field of requiredFields) {
+		const value = config[field];
+		if (!value) errors.push({
+			provider: providerName,
+			field,
+			message: `Required field '${field}' is missing for provider '${providerName}'`
+		});
+		else if (typeof value === "string" && value.trim() === "") errors.push({
+			provider: providerName,
+			field,
+			message: `Required field '${field}' cannot be empty for provider '${providerName}'`
+		});
+	}
+	switch (providerName) {
+		case "segment":
+			if (config.writeKey && !isValidSegmentWriteKey(config.writeKey)) errors.push({
+				provider: providerName,
+				field: "writeKey",
+				message: "Segment writeKey appears to be invalid format"
+			});
+			break;
+		case "posthog":
+			if (config.apiKey && !isValidPostHogApiKey(config.apiKey)) errors.push({
+				provider: providerName,
+				field: "apiKey",
+				message: "PostHog apiKey appears to be invalid format"
+			});
+			break;
+	}
+	return errors;
+}
+/**
+* Helper functions for format validation
+*/
+function isValidSegmentWriteKey(writeKey) {
+	return /^[\dA-Za-z]{20,40}$/.test(writeKey);
+}
+function isValidPostHogApiKey(apiKey) {
+	return /^phc_[\dA-Za-z]{43}$/.test(apiKey);
+}
+
+//#endregion
+export { AnalyticsManager as AnalyticsManagerClass, ContextBuilder, EventBatch, PROVIDER_REQUIREMENTS, PayloadBuilder, ai_exports as ai, alias, createAnalyticsManager, createAnonymousSession, createBootstrapData, createClientAnalytics, createClientAnalyticsUninitialized, createConfigBuilder, createEmitterProcessor, createMinimalBootstrapData, createUserSession, ecommerce_exports as ecommerce, generateDistinctId, getAnalyticsConfig, getDistinctIdFromCookies, group, identify, isAliasPayload, isGroupPayload, isIdentifyPayload, isPagePayload, isTrackPayload, page, processEmitterPayload, screen, track, trackEcommerceEvent, validateAnalyticsConfig, validateConfig, validateProvider, withMetadata, withUTM };
+//# sourceMappingURL=client.mjs.map

package/dist/client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client/manager.ts","../src/shared/utils/validation-client.ts"],"sourcesContent":["/**\n * @fileoverview Client Analytics Manager\n *\n * Client-side analytics manager with static provider registry. Provides\n * factory functions for creating client analytics instances with support\n * for multiple providers (Console, HTTP, Segment, Vercel).\n *\n * **Providers Supported**:\n * - `console`: Console logging provider (development/debugging)\n * - `http`: HTTP provider for remote ingestion (oneapp-api)\n * - `segment`: Segment.io analytics provider\n * - `vercel`: Vercel Analytics provider\n *\n * @module @od-oneapp/analytics/client/manager\n */\n\nimport { SegmentClientProvider } from '@integrations/segment/analytics-provider/client';\nimport { VercelClientProvider } from '@integrations/vercel/analytics-provider/client';\n\nimport { ConsoleProvider } from '../providers/console/client';\nimport { HttpClientProvider } from '../providers/http/client';\nimport { createAnalyticsManager } from '../shared/utils/manager';\n\nimport type { AnalyticsConfig, AnalyticsManager, ProviderRegistry } from '../shared/types/types';\n\n// Static provider registry for client environments\nconst CLIENT_PROVIDERS: ProviderRegistry = {\n  console: config => new ConsoleProvider(config),\n  http: config => new HttpClientProvider(config),\n  segment: config => new SegmentClientProvider(config),\n  vercel: config => new VercelClientProvider(config),\n};\n\n/**\n * Create and initialize a client analytics instance\n * This is the primary way to create analytics for client-side applications\n *\n * @example\n * ```typescript\n * const analytics = await createClientAnalytics({\n *   providers: {\n *     http: { endpoint: '/api/v1/ingest' },\n *   },\n * });\n * await analytics.track('Button Clicked', { variant: 'primary' });\n * ```\n * @param config - Analytics configuration including providers and settings\n * @returns Promise resolving to initialized analytics manager\n */\nexport async function createClientAnalytics(config: AnalyticsConfig): Promise<AnalyticsManager> {\n  const manager = createAnalyticsManager(config, CLIENT_PROVIDERS);\n  await manager.initialize();\n  return manager;\n}\n\n/**\n * Create a client analytics instance without initializing\n * Useful when you need to control initialization timing\n *\n * @example\n * ```typescript\n * const analytics = createClientAnalyticsUninitialized(config);\n * // later inside a lazy effect\n * await analytics.initialize();\n * ```\n * @param config - Analytics configuration including providers and settings\n * @returns Uninitialized analytics manager instance\n */\nexport function createClientAnalyticsUninitialized(config: AnalyticsConfig): AnalyticsManager {\n  return createAnalyticsManager(config, CLIENT_PROVIDERS);\n}\n","/**\n * @fileoverview Client-safe validation utilities for analytics configuration\n * Client-safe validation utilities for analytics configuration\n * This file contains only validation functions that are safe to use in browser environments\n */\n\nimport { PROVIDER_REQUIREMENTS } from './config';\n\nimport type { AnalyticsConfig, ProviderConfig } from '../types/types';\n\ninterface ValidationError {\n  field: string;\n  message: string;\n  provider: string;\n}\n\ninterface ValidationResult {\n  errors: ValidationError[];\n  isValid: boolean;\n  warnings: string[];\n}\n\n/**\n * Comprehensive configuration validation (client-safe version)\n * Accepts unknown input for defensive validation of potentially malformed configs\n */\nexport function validateAnalyticsConfig(config: unknown): ValidationResult {\n  const errors: ValidationError[] = [];\n  const warnings: string[] = [];\n\n  // Check if config exists and is an object\n  if (!config || typeof config !== 'object') {\n    errors.push({\n      provider: 'global',\n      field: 'config',\n      message: 'Analytics configuration is required and must be an object',\n    });\n    return { isValid: false, errors, warnings };\n  }\n\n  const typedConfig = config as AnalyticsConfig;\n\n  // Check if providers object exists\n  if (!typedConfig.providers || typeof typedConfig.providers !== 'object') {\n    errors.push({\n      provider: 'global',\n      field: 'providers',\n      message: 'Providers configuration is required and must be an object',\n    });\n    return { isValid: false, errors, warnings };\n  }\n\n  // Check if at least one provider is configured\n  const providerCount = Object.keys(typedConfig.providers).length;\n  if (providerCount === 0) {\n    warnings.push('No providers configured. Analytics will not track any events.');\n  }\n\n  // Validate each provider\n  for (const [providerName, providerConfig] of Object.entries(typedConfig.providers)) {\n    const providerErrors = validateProvider(providerName, providerConfig);\n    errors.push(...providerErrors);\n  }\n\n  // Environment-specific warnings\n  if (typedConfig.providers.mixpanel) {\n    warnings.push(\n      'Mixpanel provider configured on client-side. Consider using server-side for better performance.',\n    );\n  }\n\n  return {\n    isValid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * Validate a single provider configuration\n */\nexport function validateProvider(providerName: string, config: ProviderConfig): ValidationError[] {\n  const errors: ValidationError[] = [];\n\n  // Check if provider is known\n  const knownProviders = ['segment', 'posthog', 'vercel', 'console', 'mixpanel'];\n  if (!knownProviders.includes(providerName)) {\n    errors.push({\n      provider: providerName,\n      field: 'name',\n      message: `Unknown provider '${providerName}'. Known providers: ${knownProviders.join(', ')}`,\n    });\n    return errors;\n  }\n\n  // Check required fields\n  const requiredFields = PROVIDER_REQUIREMENTS[providerName] ?? [];\n  for (const field of requiredFields) {\n    const value = config[field as keyof ProviderConfig];\n\n    if (!value) {\n      errors.push({\n        provider: providerName,\n        field,\n        message: `Required field '${field}' is missing for provider '${providerName}'`,\n      });\n    } else if (typeof value === 'string' && value.trim() === '') {\n      errors.push({\n        provider: providerName,\n        field,\n        message: `Required field '${field}' cannot be empty for provider '${providerName}'`,\n      });\n    }\n  }\n\n  // Provider-specific validation\n  switch (providerName) {\n    case 'segment':\n      if (config.writeKey && !isValidSegmentWriteKey(config.writeKey)) {\n        errors.push({\n          provider: providerName,\n          field: 'writeKey',\n          message: 'Segment writeKey appears to be invalid format',\n        });\n      }\n      break;\n\n    case 'posthog':\n      if (config.apiKey && !isValidPostHogApiKey(config.apiKey)) {\n        errors.push({\n          provider: providerName,\n          field: 'apiKey',\n          message: 'PostHog apiKey appears to be invalid format',\n        });\n      }\n      break;\n  }\n\n  return errors;\n}\n\n/**\n * Helper functions for format validation\n */\nfunction isValidSegmentWriteKey(writeKey: string): boolean {\n  // Segment write keys are typically 32 characters, alphanumeric\n  return /^[\\dA-Za-z]{20,40}$/.test(writeKey);\n}\n\nfunction isValidPostHogApiKey(apiKey: string): boolean {\n  // PostHog API keys start with 'phc_' followed by alphanumeric characters\n  return /^phc_[\\dA-Za-z]{43}$/.test(apiKey);\n}\n\n/**\n * Utility to validate configuration (client-safe version without throwing)\n * Returns validation result instead of throwing errors\n */\nexport function validateConfig(config: AnalyticsConfig): ValidationResult {\n  return validateAnalyticsConfig(config);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,MAAM,mBAAqC;CACzC,UAAS,WAAU,IAAI,gBAAgB,OAAO;CAC9C,OAAM,WAAU,IAAI,mBAAmB,OAAO;CAC9C,UAAS,WAAU,IAAI,sBAAsB,OAAO;CACpD,SAAQ,WAAU,IAAI,qBAAqB,OAAO;CACnD;;;;;;;;;;;;;;;;;AAkBD,eAAsB,sBAAsB,QAAoD;CAC9F,MAAM,UAAU,uBAAuB,QAAQ,iBAAiB;AAChE,OAAM,QAAQ,YAAY;AAC1B,QAAO;;;;;;;;;;;;;;;AAgBT,SAAgB,mCAAmC,QAA2C;AAC5F,QAAO,uBAAuB,QAAQ,iBAAiB;;;;;;;;;;;;;;AC3CzD,SAAgB,wBAAwB,QAAmC;CACzE,MAAM,SAA4B,EAAE;CACpC,MAAM,WAAqB,EAAE;AAG7B,KAAI,CAAC,UAAU,OAAO,WAAW,UAAU;AACzC,SAAO,KAAK;GACV,UAAU;GACV,OAAO;GACP,SAAS;GACV,CAAC;AACF,SAAO;GAAE,SAAS;GAAO;GAAQ;GAAU;;CAG7C,MAAM,cAAc;AAGpB,KAAI,CAAC,YAAY,aAAa,OAAO,YAAY,cAAc,UAAU;AACvE,SAAO,KAAK;GACV,UAAU;GACV,OAAO;GACP,SAAS;GACV,CAAC;AACF,SAAO;GAAE,SAAS;GAAO;GAAQ;GAAU;;AAK7C,KADsB,OAAO,KAAK,YAAY,UAAU,CAAC,WACnC,EACpB,UAAS,KAAK,gEAAgE;AAIhF,MAAK,MAAM,CAAC,cAAc,mBAAmB,OAAO,QAAQ,YAAY,UAAU,EAAE;EAClF,MAAM,iBAAiB,iBAAiB,cAAc,eAAe;AACrE,SAAO,KAAK,GAAG,eAAe;;AAIhC,KAAI,YAAY,UAAU,SACxB,UAAS,KACP,kGACD;AAGH,QAAO;EACL,SAAS,OAAO,WAAW;EAC3B;EACA;EACD;;;;;AAMH,SAAgB,iBAAiB,cAAsB,QAA2C;CAChG,MAAM,SAA4B,EAAE;CAGpC,MAAM,iBAAiB;EAAC;EAAW;EAAW;EAAU;EAAW;EAAW;AAC9E,KAAI,CAAC,eAAe,SAAS,aAAa,EAAE;AAC1C,SAAO,KAAK;GACV,UAAU;GACV,OAAO;GACP,SAAS,qBAAqB,aAAa,sBAAsB,eAAe,KAAK,KAAK;GAC3F,CAAC;AACF,SAAO;;CAIT,MAAM,iBAAiB,sBAAsB,iBAAiB,EAAE;AAChE,MAAK,MAAM,SAAS,gBAAgB;EAClC,MAAM,QAAQ,OAAO;AAErB,MAAI,CAAC,MACH,QAAO,KAAK;GACV,UAAU;GACV;GACA,SAAS,mBAAmB,MAAM,6BAA6B,aAAa;GAC7E,CAAC;WACO,OAAO,UAAU,YAAY,MAAM,MAAM,KAAK,GACvD,QAAO,KAAK;GACV,UAAU;GACV;GACA,SAAS,mBAAmB,MAAM,kCAAkC,aAAa;GAClF,CAAC;;AAKN,SAAQ,cAAR;EACE,KAAK;AACH,OAAI,OAAO,YAAY,CAAC,uBAAuB,OAAO,SAAS,CAC7D,QAAO,KAAK;IACV,UAAU;IACV,OAAO;IACP,SAAS;IACV,CAAC;AAEJ;EAEF,KAAK;AACH,OAAI,OAAO,UAAU,CAAC,qBAAqB,OAAO,OAAO,CACvD,QAAO,KAAK;IACV,UAAU;IACV,OAAO;IACP,SAAS;IACV,CAAC;AAEJ;;AAGJ,QAAO;;;;;AAMT,SAAS,uBAAuB,UAA2B;AAEzD,QAAO,sBAAsB,KAAK,SAAS;;AAG7C,SAAS,qBAAqB,QAAyB;AAErD,QAAO,uBAAuB,KAAK,OAAO"}

package/dist/config-DPS6bSYo.d.mts

@@ -0,0 +1,34 @@
+import { c as ProviderConfig, r as AnalyticsManager, t as AnalyticsConfig, w as EmitterPayload } from "./types-BxBnNQ0V.mjs";
+
+//#region src/shared/utils/emitter-adapter.d.ts
+declare function processEmitterPayload(analytics: AnalyticsManager, payload: EmitterPayload): Promise<void>;
+declare function createEmitterProcessor(analytics: AnalyticsManager): (payload: EmitterPayload) => Promise<void>;
+declare function trackEcommerceEvent(analytics: AnalyticsManager, eventSpec: {
+  name: string;
+  properties: Record<string, any>;
+}): Promise<void>;
+//#endregion
+//#region src/shared/utils/config.d.ts
+type ConfigRequirements = Record<string, string[]>;
+declare const PROVIDER_REQUIREMENTS: ConfigRequirements;
+declare function validateConfig(config: unknown): void;
+interface ConfigBuilder {
+  addConsole(options?: Record<string, unknown>): ConfigBuilder;
+  addPostHog(apiKey: string, options?: Record<string, unknown>): ConfigBuilder;
+  addProvider(name: string, config: ProviderConfig): ConfigBuilder;
+  addSegment(writeKey: string, options?: Record<string, unknown>): ConfigBuilder;
+  addVercel(options?: Record<string, unknown>): ConfigBuilder;
+  build(): AnalyticsConfig;
+  providers: Record<string, ProviderConfig>;
+}
+declare function createConfigBuilder(): ConfigBuilder;
+interface AnalyticsConfigOptions {
+  isDevelopment?: boolean;
+  isStaging?: boolean;
+  segmentWriteKey?: string;
+  posthogApiKey?: string;
+}
+declare function getAnalyticsConfig(options?: AnalyticsConfigOptions): AnalyticsConfig;
+//#endregion
+export { createEmitterProcessor as a, validateConfig as i, createConfigBuilder as n, processEmitterPayload as o, getAnalyticsConfig as r, trackEcommerceEvent as s, PROVIDER_REQUIREMENTS as t };
+//# sourceMappingURL=config-DPS6bSYo.d.mts.map

package/dist/config-DPS6bSYo.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-DPS6bSYo.d.mts","names":[],"sources":["../src/shared/utils/emitter-adapter.ts","../src/shared/utils/config.ts"],"mappings":";;;iBAoCsB,qBAAA,CACpB,SAAA,EAAW,gBAAA,EACX,OAAA,EAAS,cAAA,GACR,OAAA;AAAA,iBAsJa,sBAAA,CAAuB,SAAA,EAAW,gBAAA,IACxC,OAAA,EAAS,cAAA,KAAc,OAAA;AAAA,iBAgBX,mBAAA,CACpB,SAAA,EAAW,gBAAA,EACX,SAAA;EAAa,IAAA;EAAc,UAAA,EAAY,MAAA;AAAA,IACtC,OAAA;;;KCzLS,kBAAA,GAAqB,MAAA;AAAA,cAQpB,qBAAA,EAAuB,kBAAA;AAAA,iBA0BpB,cAAA,CAAe,MAAA;AAAA,UA8Cd,aAAA;EACf,UAAA,CAAW,OAAA,GAAU,MAAA,oBAA0B,aAAA;EAC/C,UAAA,CAAW,MAAA,UAAgB,OAAA,GAAU,MAAA,oBAA0B,aAAA;EAC/D,WAAA,CAAY,IAAA,UAAc,MAAA,EAAQ,cAAA,GAAiB,aAAA;EACnD,UAAA,CAAW,QAAA,UAAkB,OAAA,GAAU,MAAA,oBAA0B,aAAA;EACjE,SAAA,CAAU,OAAA,GAAU,MAAA,oBAA0B,aAAA;EAC9C,KAAA,IAAS,eAAA;EACT,SAAA,EAAW,MAAA,SAAe,cAAA;AAAA;AAAA,iBAoBZ,mBAAA,CAAA,GAAuB,aAAA;AAAA,UA0CtB,sBAAA;EACf,aAAA;EACA,SAAA;EACA,eAAA;EACA,aAAA;AAAA;AAAA,iBAyBc,kBAAA,CAAmB,OAAA,GAAU,sBAAA,GAAyB,eAAA"}

package/dist/config-P6P5adJg.mjs

@@ -0,0 +1,287 @@
+//#region src/shared/utils/emitter-adapter.ts
+/**
+* Routes any emitter payload to the matching analytics manager method.
+*
+* This function is deliberately small so that Codex/OpenAI powered tooling can
+* inspect a single switch statement and understand how each analytics verb maps
+* to the strongly typed helper below.
+*
+* @deprecated Use `analytics.emit(payload)` instead for simpler API usage.
+* This function remains available for compatibility and advanced use cases.
+*
+* @example Preferred approach:
+* ```typescript
+* await analytics.emit(track('Button Clicked', { color: 'blue' }));
+* ```
+*
+* @param analytics - The analytics manager implementation (client or server)
+* @param payload - Any emitter payload created by the Segment-style helpers
+* @throws Error when the payload type is unknown, protecting against silent drops
+*/
+async function processEmitterPayload(analytics, payload) {
+	switch (payload.type) {
+		case "identify": return processIdentifyPayload(analytics, payload);
+		case "track": return processTrackPayload(analytics, payload);
+		case "page": return processPagePayload(analytics, payload);
+		case "screen": return processScreenPayload(analytics, payload);
+		case "group": return processGroupPayload(analytics, payload);
+		case "alias": return processAliasPayload(analytics, payload);
+		default: {
+			const unknownPayload = payload;
+			throw new Error(`Unknown emitter payload type: ${unknownPayload.type}`);
+		}
+	}
+}
+/**
+* Pipes an identify payload into `analytics.identify`, preserving context.
+*
+* @param analytics - Active analytics manager
+* @param payload - Identify payload produced by the emitter factory
+*/
+async function processIdentifyPayload(analytics, payload) {
+	const { traits, userId, ...options } = payload;
+	const trackingOptions = { context: options.context };
+	await analytics.identify(userId, traits, trackingOptions);
+}
+/**
+* Pipes a track payload into `analytics.track`, preserving context metadata.
+*
+* @param analytics - Active analytics manager
+* @param payload - Track payload produced by the emitter factory
+*/
+async function processTrackPayload(analytics, payload) {
+	const { event, properties, ...options } = payload;
+	const trackingOptions = { context: options.context };
+	await analytics.track(event, properties, trackingOptions);
+}
+/**
+* Pipes a page payload into `analytics.page`.
+*
+* @param analytics - Active analytics manager
+* @param payload - Page payload produced by the emitter factory
+*/
+async function processPagePayload(analytics, payload) {
+	const { name, properties, ...options } = payload;
+	const trackingOptions = { context: options.context };
+	await analytics.page(name, properties, trackingOptions);
+}
+/**
+* Pipes a screen payload into `analytics.screen` (mobile equivalent of page).
+*
+* @param analytics - Active analytics manager
+* @param payload - Screen payload produced by the emitter factory
+*/
+async function processScreenPayload(analytics, payload) {
+	const { name, properties, ...options } = payload;
+	const trackingOptions = { context: options.context };
+	await analytics.screen?.(name, properties, trackingOptions);
+}
+/**
+* Pipes a group payload into `analytics.group`.
+*
+* @param analytics - Active analytics manager
+* @param payload - Group payload produced by the emitter factory
+*/
+async function processGroupPayload(analytics, payload) {
+	const { groupId, traits, ...options } = payload;
+	const trackingOptions = { context: options.context };
+	await analytics.group(groupId, traits, trackingOptions);
+}
+/**
+* Pipes an alias payload into `analytics.alias`.
+*
+* @param analytics - Active analytics manager
+* @param payload - Alias payload produced by the emitter factory
+*/
+async function processAliasPayload(analytics, payload) {
+	const { previousId, userId, ...options } = payload;
+	const trackingOptions = { context: options.context };
+	await analytics.alias(userId, previousId ?? "", trackingOptions);
+}
+/**
+* Creates a pre-bound emitter processor for repeated usage.
+*
+* @example
+* ```ts
+* const processor = createEmitterProcessor(analytics);
+* queue.forEach(processor);
+* ```
+*
+* @param analytics - Active analytics manager
+* @returns Function that accepts any emitter payload and routes it correctly
+*/
+function createEmitterProcessor(analytics) {
+	return (payload) => processEmitterPayload(analytics, payload);
+}
+/**
+* Minimal helper for wiring ecommerce event specs into analytics.track.
+*
+* @deprecated Use `analytics.emit(ecommerce.EVENT_NAME(...))` instead.
+*
+* @example Preferred approach:
+* ```typescript
+* await analytics.emit(ecommerce.productViewed({ product_id: '123' }));
+* ```
+*
+* @param analytics - Active analytics manager
+* @param eventSpec - Object that contains the `name` and `properties` fields
+*/
+async function trackEcommerceEvent(analytics, eventSpec) {
+	await analytics.track(eventSpec.name, eventSpec.properties);
+}
+
+//#endregion
+//#region src/shared/utils/config.ts
+/**
+* Provider requirements map - defines required fields for each provider.
+*
+* Used during configuration validation to ensure all required fields are present.
+* Providers not listed here have no required fields.
+*/
+const PROVIDER_REQUIREMENTS = {
+	console: [],
+	mixpanel: [],
+	posthog: ["apiKey"],
+	segment: ["writeKey"],
+	vercel: []
+};
+/**
+* Validates analytics configuration.
+*
+* Accepts `unknown` for runtime validation of potentially malformed configs.
+* Throws descriptive errors if configuration is invalid.
+*
+* @param {unknown} config - Configuration object to validate
+* @throws {Error} If configuration is invalid or missing required fields
+*
+* @example
+* ```typescript
+* try {
+*   validateConfig(config);
+* } catch (error) {
+*   console.error('Invalid config:', error.message);
+* }
+* ```
+*/
+function validateConfig(config) {
+	if (!config || typeof config !== "object") throw new Error("Analytics config must be an object");
+	const typedConfig = config;
+	if (!typedConfig.providers || typeof typedConfig.providers !== "object") throw new Error("Analytics config must have a providers object");
+	for (const [providerName, providerConfig] of Object.entries(typedConfig.providers)) validateProviderConfig(providerName, providerConfig);
+}
+/**
+* Validates a single provider configuration.
+*
+* Checks that all required fields for the provider are present in the configuration.
+*
+* @param {string} providerName - Name of the provider to validate
+* @param {ProviderConfig} config - Provider configuration to validate
+* @throws {Error} If required fields are missing
+*
+* @internal
+*/
+function validateProviderConfig(providerName, config) {
+	const requiredFields = PROVIDER_REQUIREMENTS[providerName] ?? [];
+	for (const field of requiredFields) if (!config[field]) throw new Error(`Provider '${providerName}' missing required field '${field}'. Remove the provider from config or provide the required field.`);
+}
+/**
+* Creates a fluent configuration builder.
+*
+* Returns a builder instance that allows chaining provider configuration methods.
+* Call `build()` at the end to get the final configuration object.
+*
+* @returns {ConfigBuilder} Configuration builder instance
+*
+* @example
+* ```typescript
+* const config = createConfigBuilder()
+*   .addPostHog('phc_xxx')
+*   .addSegment('xxx')
+*   .addConsole({ pretty: true })
+*   .build();
+* ```
+*/
+function createConfigBuilder() {
+	return {
+		providers: {},
+		addProvider(name, config) {
+			this.providers[name] = config;
+			return this;
+		},
+		addSegment(writeKey, options) {
+			return this.addProvider("segment", {
+				options,
+				writeKey
+			});
+		},
+		addPostHog(apiKey, options) {
+			return this.addProvider("posthog", {
+				apiKey,
+				options
+			});
+		},
+		addVercel(options) {
+			return this.addProvider("vercel", { options });
+		},
+		addConsole(options) {
+			return this.addProvider("console", { options });
+		},
+		build() {
+			const config = { providers: { ...this.providers } };
+			validateConfig(config);
+			return config;
+		}
+	};
+}
+/**
+* Get analytics configuration
+*
+* When called with options (client-safe), uses the provided values.
+* When called without options (server), reads from process.env.
+*
+* @param options - Optional configuration options for client-side usage
+* @returns Analytics configuration object
+*
+* @example Server usage (reads from process.env):
+* ```typescript
+* const config = getAnalyticsConfig();
+* ```
+*
+* @example Client usage (explicit options):
+* ```typescript
+* const config = getAnalyticsConfig({
+*   isDevelopment: process.env.NODE_ENV === 'development',
+*   posthogApiKey: process.env.NEXT_PUBLIC_POSTHOG_KEY,
+* });
+* ```
+*/
+function getAnalyticsConfig(options) {
+	const builder = createConfigBuilder();
+	const isDevelopment = options?.isDevelopment ?? true;
+	const isStaging = options?.isStaging ?? process.env.APP_ENV === "staging";
+	const posthogApiKey = options?.posthogApiKey ?? process.env.POSTHOG_API_KEY;
+	const segmentWriteKey = options?.segmentWriteKey ?? process.env.SEGMENT_WRITE_KEY;
+	if (isDevelopment) {
+		builder.addConsole({
+			prefix: "[Dev Analytics]",
+			pretty: true
+		});
+		return builder.build();
+	}
+	if (isStaging) {
+		if (posthogApiKey) builder.addPostHog(posthogApiKey);
+		builder.addConsole({
+			prefix: "[Staging Analytics]",
+			pretty: true
+		});
+		return builder.build();
+	}
+	if (segmentWriteKey) builder.addSegment(segmentWriteKey);
+	if (posthogApiKey) builder.addPostHog(posthogApiKey);
+	builder.addVercel();
+	return builder.build();
+}
+
+//#endregion
+export { createEmitterProcessor as a, validateConfig as i, createConfigBuilder as n, processEmitterPayload as o, getAnalyticsConfig as r, trackEcommerceEvent as s, PROVIDER_REQUIREMENTS as t };
+//# sourceMappingURL=config-P6P5adJg.mjs.map

package/dist/config-P6P5adJg.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-P6P5adJg.mjs","names":[],"sources":["../src/shared/utils/emitter-adapter.ts","../src/shared/utils/config.ts"],"sourcesContent":["/**\n * @fileoverview Adapter functions to convert emitter payloads to analytics method calls\n * Adapter functions to convert emitter payloads to analytics method calls\n * This bridges the gap between the Segment.io spec emitters and the analytics manager\n */\n\nimport type {\n  EmitterAliasPayload,\n  EmitterGroupPayload,\n  EmitterIdentifyPayload,\n  EmitterPagePayload,\n  EmitterPayload,\n  EmitterScreenPayload,\n  EmitterTrackPayload,\n} from '../emitters/emitter-types';\nimport type { AnalyticsManager } from '../types/types';\n\n/**\n * Routes any emitter payload to the matching analytics manager method.\n *\n * This function is deliberately small so that Codex/OpenAI powered tooling can\n * inspect a single switch statement and understand how each analytics verb maps\n * to the strongly typed helper below.\n *\n * @deprecated Use `analytics.emit(payload)` instead for simpler API usage.\n * This function remains available for compatibility and advanced use cases.\n *\n * @example Preferred approach:\n * ```typescript\n * await analytics.emit(track('Button Clicked', { color: 'blue' }));\n * ```\n *\n * @param analytics - The analytics manager implementation (client or server)\n * @param payload - Any emitter payload created by the Segment-style helpers\n * @throws Error when the payload type is unknown, protecting against silent drops\n */\nexport async function processEmitterPayload(\n  analytics: AnalyticsManager,\n  payload: EmitterPayload,\n): Promise<void> {\n  switch (payload.type) {\n    case 'identify':\n      return processIdentifyPayload(analytics, payload);\n    case 'track':\n      return processTrackPayload(analytics, payload);\n    case 'page':\n      return processPagePayload(analytics, payload);\n    case 'screen':\n      return processScreenPayload(analytics, payload);\n    case 'group':\n      return processGroupPayload(analytics, payload);\n    case 'alias':\n      return processAliasPayload(analytics, payload);\n    default: {\n      // Runtime safety for unknown payload types (e.g., from untyped JavaScript code)\n      const unknownPayload = payload as { type: string };\n      throw new Error(`Unknown emitter payload type: ${unknownPayload.type}`);\n    }\n  }\n}\n\n/**\n * Pipes an identify payload into `analytics.identify`, preserving context.\n *\n * @param analytics - Active analytics manager\n * @param payload - Identify payload produced by the emitter factory\n */\nexport async function processIdentifyPayload(\n  analytics: AnalyticsManager,\n  payload: EmitterIdentifyPayload,\n): Promise<void> {\n  const { traits, userId, ...options } = payload;\n\n  // Convert emitter options to tracking options\n  const trackingOptions = {\n    context: options.context,\n    // Add other options as needed\n  };\n\n  await analytics.identify(userId, traits, trackingOptions);\n}\n\n/**\n * Pipes a track payload into `analytics.track`, preserving context metadata.\n *\n * @param analytics - Active analytics manager\n * @param payload - Track payload produced by the emitter factory\n */\nexport async function processTrackPayload(\n  analytics: AnalyticsManager,\n  payload: EmitterTrackPayload,\n): Promise<void> {\n  const { event, properties, ...options } = payload;\n\n  const trackingOptions = {\n    context: options.context,\n  };\n\n  await analytics.track(event, properties, trackingOptions);\n}\n\n/**\n * Pipes a page payload into `analytics.page`.\n *\n * @param analytics - Active analytics manager\n * @param payload - Page payload produced by the emitter factory\n */\nexport async function processPagePayload(\n  analytics: AnalyticsManager,\n  payload: EmitterPagePayload,\n): Promise<void> {\n  const { name, properties, ...options } = payload;\n\n  const trackingOptions = {\n    context: options.context,\n  };\n\n  await analytics.page(name, properties, trackingOptions);\n}\n\n/**\n * Pipes a screen payload into `analytics.screen` (mobile equivalent of page).\n *\n * @param analytics - Active analytics manager\n * @param payload - Screen payload produced by the emitter factory\n */\nexport async function processScreenPayload(\n  analytics: AnalyticsManager,\n  payload: EmitterScreenPayload,\n): Promise<void> {\n  const { name, properties, ...options } = payload;\n\n  const trackingOptions = {\n    context: options.context,\n  };\n\n  await analytics.screen?.(name, properties, trackingOptions);\n}\n\n/**\n * Pipes a group payload into `analytics.group`.\n *\n * @param analytics - Active analytics manager\n * @param payload - Group payload produced by the emitter factory\n */\nexport async function processGroupPayload(\n  analytics: AnalyticsManager,\n  payload: EmitterGroupPayload,\n): Promise<void> {\n  const { groupId, traits, ...options } = payload;\n\n  const trackingOptions = {\n    context: options.context,\n  };\n\n  await analytics.group(groupId, traits, trackingOptions);\n}\n\n/**\n * Pipes an alias payload into `analytics.alias`.\n *\n * @param analytics - Active analytics manager\n * @param payload - Alias payload produced by the emitter factory\n */\nexport async function processAliasPayload(\n  analytics: AnalyticsManager,\n  payload: EmitterAliasPayload,\n): Promise<void> {\n  const { previousId, userId, ...options } = payload;\n\n  const trackingOptions = {\n    context: options.context,\n  };\n\n  await analytics.alias(userId, previousId ?? '', trackingOptions);\n}\n\n/**\n * Creates a pre-bound emitter processor for repeated usage.\n *\n * @example\n * ```ts\n * const processor = createEmitterProcessor(analytics);\n * queue.forEach(processor);\n * ```\n *\n * @param analytics - Active analytics manager\n * @returns Function that accepts any emitter payload and routes it correctly\n */\nexport function createEmitterProcessor(analytics: AnalyticsManager) {\n  return (payload: EmitterPayload) => processEmitterPayload(analytics, payload);\n}\n\n/**\n * Minimal helper for wiring ecommerce event specs into analytics.track.\n *\n * @deprecated Use `analytics.emit(ecommerce.EVENT_NAME(...))` instead.\n *\n * @example Preferred approach:\n * ```typescript\n * await analytics.emit(ecommerce.productViewed({ product_id: '123' }));\n * ```\n *\n * @param analytics - Active analytics manager\n * @param eventSpec - Object that contains the `name` and `properties` fields\n */\nexport async function trackEcommerceEvent(\n  analytics: AnalyticsManager,\n  eventSpec: { name: string; properties: Record<string, any> },\n): Promise<void> {\n  await analytics.track(eventSpec.name, eventSpec.properties);\n}\n","/**\n * @fileoverview Configuration utilities for the analytics system\n *\n * This module provides configuration utilities that work in both client and server\n * environments. It includes:\n *\n * - **Provider Requirements**: Required fields for each provider type\n * - **Configuration Validation**: Validates provider configurations\n * - **Config Builder**: Fluent API for building configurations\n * - **Config Factory**: Environment-aware configuration factory\n *\n * **Usage**: Use `createConfigBuilder()` for programmatic config creation or\n * `getAnalyticsConfig()` for environment-aware configuration.\n *\n * @module @od-oneapp/analytics/shared/utils/config\n */\n\nimport type { AnalyticsConfig, ProviderConfig } from '../types/types';\n\n/**\n * Type for provider requirements mapping.\n *\n * Maps provider names to arrays of required configuration field names.\n */\nexport type ConfigRequirements = Record<string, string[]>;\n\n/**\n * Provider requirements map - defines required fields for each provider.\n *\n * Used during configuration validation to ensure all required fields are present.\n * Providers not listed here have no required fields.\n */\nexport const PROVIDER_REQUIREMENTS: ConfigRequirements = {\n  console: [], // No required fields\n  mixpanel: [], // Server-only provider\n  posthog: ['apiKey'],\n  segment: ['writeKey'],\n  vercel: [], // No required fields\n};\n\n/**\n * Validates analytics configuration.\n *\n * Accepts `unknown` for runtime validation of potentially malformed configs.\n * Throws descriptive errors if configuration is invalid.\n *\n * @param {unknown} config - Configuration object to validate\n * @throws {Error} If configuration is invalid or missing required fields\n *\n * @example\n * ```typescript\n * try {\n *   validateConfig(config);\n * } catch (error) {\n *   console.error('Invalid config:', error.message);\n * }\n * ```\n */\nexport function validateConfig(config: unknown): void {\n  if (!config || typeof config !== 'object') {\n    throw new Error('Analytics config must be an object');\n  }\n\n  const typedConfig = config as AnalyticsConfig;\n\n  if (!typedConfig.providers || typeof typedConfig.providers !== 'object') {\n    throw new Error('Analytics config must have a providers object');\n  }\n\n  for (const [providerName, providerConfig] of Object.entries(typedConfig.providers)) {\n    validateProviderConfig(providerName, providerConfig);\n  }\n}\n\n/**\n * Validates a single provider configuration.\n *\n * Checks that all required fields for the provider are present in the configuration.\n *\n * @param {string} providerName - Name of the provider to validate\n * @param {ProviderConfig} config - Provider configuration to validate\n * @throws {Error} If required fields are missing\n *\n * @internal\n */\nfunction validateProviderConfig(providerName: string, config: ProviderConfig): void {\n  const requiredFields = PROVIDER_REQUIREMENTS[providerName] ?? [];\n\n  for (const field of requiredFields) {\n    if (!config[field as keyof ProviderConfig]) {\n      throw new Error(\n        `Provider '${providerName}' missing required field '${field}'. ` +\n          `Remove the provider from config or provide the required field.`,\n      );\n    }\n  }\n}\n\n/**\n * Configuration builder interface.\n *\n * Provides a fluent API for building analytics configurations programmatically.\n * Methods return `this` to enable method chaining.\n */\nexport interface ConfigBuilder {\n  addConsole(options?: Record<string, unknown>): ConfigBuilder;\n  addPostHog(apiKey: string, options?: Record<string, unknown>): ConfigBuilder;\n  addProvider(name: string, config: ProviderConfig): ConfigBuilder;\n  addSegment(writeKey: string, options?: Record<string, unknown>): ConfigBuilder;\n  addVercel(options?: Record<string, unknown>): ConfigBuilder;\n  build(): AnalyticsConfig;\n  providers: Record<string, ProviderConfig>;\n}\n\n/**\n * Creates a fluent configuration builder.\n *\n * Returns a builder instance that allows chaining provider configuration methods.\n * Call `build()` at the end to get the final configuration object.\n *\n * @returns {ConfigBuilder} Configuration builder instance\n *\n * @example\n * ```typescript\n * const config = createConfigBuilder()\n *   .addPostHog('phc_xxx')\n *   .addSegment('xxx')\n *   .addConsole({ pretty: true })\n *   .build();\n * ```\n */\nexport function createConfigBuilder(): ConfigBuilder {\n  const builder: ConfigBuilder = {\n    providers: {},\n\n    addProvider(name: string, config: ProviderConfig): ConfigBuilder {\n      this.providers[name] = config;\n      return this;\n    },\n\n    addSegment(writeKey: string, options?: Record<string, unknown>): ConfigBuilder {\n      return this.addProvider('segment', { options, writeKey });\n    },\n\n    addPostHog(apiKey: string, options?: Record<string, unknown>): ConfigBuilder {\n      return this.addProvider('posthog', { apiKey, options });\n    },\n\n    addVercel(options?: Record<string, unknown>): ConfigBuilder {\n      return this.addProvider('vercel', { options });\n    },\n\n    addConsole(options?: Record<string, unknown>): ConfigBuilder {\n      return this.addProvider('console', { options });\n    },\n\n    build(): AnalyticsConfig {\n      const config = { providers: { ...this.providers } };\n      validateConfig(config);\n      return config;\n    },\n  };\n\n  return builder;\n}\n\n/**\n * Options for client-side configuration.\n *\n * Allows explicit configuration values to be passed instead of reading from\n * environment variables. Useful for client-side code where environment variables\n * may not be available.\n */\nexport interface AnalyticsConfigOptions {\n  isDevelopment?: boolean;\n  isStaging?: boolean;\n  segmentWriteKey?: string;\n  posthogApiKey?: string;\n}\n\n/**\n * Get analytics configuration\n *\n * When called with options (client-safe), uses the provided values.\n * When called without options (server), reads from process.env.\n *\n * @param options - Optional configuration options for client-side usage\n * @returns Analytics configuration object\n *\n * @example Server usage (reads from process.env):\n * ```typescript\n * const config = getAnalyticsConfig();\n * ```\n *\n * @example Client usage (explicit options):\n * ```typescript\n * const config = getAnalyticsConfig({\n *   isDevelopment: process.env.NODE_ENV === 'development',\n *   posthogApiKey: process.env.NEXT_PUBLIC_POSTHOG_KEY,\n * });\n * ```\n */\nexport function getAnalyticsConfig(options?: AnalyticsConfigOptions): AnalyticsConfig {\n  const builder = createConfigBuilder();\n\n  // Determine environment from options or process.env\n  const isDevelopment = options?.isDevelopment ?? process.env.NODE_ENV === 'development';\n  const isStaging = options?.isStaging ?? process.env.APP_ENV === 'staging';\n\n  // Get API keys from options or process.env\n  const posthogApiKey = options?.posthogApiKey ?? process.env.POSTHOG_API_KEY;\n  const segmentWriteKey = options?.segmentWriteKey ?? process.env.SEGMENT_WRITE_KEY;\n\n  // Development - minimal providers\n  if (isDevelopment) {\n    builder.addConsole({\n      prefix: '[Dev Analytics]',\n      pretty: true,\n    });\n    return builder.build();\n  }\n\n  // Staging - selective providers\n  if (isStaging) {\n    if (posthogApiKey) {\n      builder.addPostHog(posthogApiKey);\n    }\n\n    builder.addConsole({\n      prefix: '[Staging Analytics]',\n      pretty: true,\n    });\n\n    return builder.build();\n  }\n\n  // Production - multiple providers\n  if (segmentWriteKey) {\n    builder.addSegment(segmentWriteKey);\n  }\n\n  if (posthogApiKey) {\n    builder.addPostHog(posthogApiKey);\n  }\n\n  // Add Vercel Analytics in production\n  builder.addVercel();\n\n  return builder.build();\n}\n"],"mappings":"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"}