@od-oneapp/analytics 2026.1.1301

package/dist/providers-http-client.mjs

@@ -0,0 +1,320 @@
+import { logError, logInfo, logWarn } from "@od-oneapp/shared/logs";
+
+//#region src/providers/http/client.ts
+/**
+* @fileoverview HTTP provider for browser/client environments
+*
+* Provides HTTP-based analytics event sending for client-side applications.
+* Sends events to a remote ingestion endpoint (e.g., oneapp-api/ingest).
+*
+* Features:
+* - Event batching for efficiency
+* - Automatic flush on interval, batch size, or page unload
+* - Retry with exponential backoff
+* - Anonymous ID persistence in localStorage
+* - Offline queue support (events queued when offline)
+*
+* @module @od-oneapp/analytics/providers/http/client
+*/
+/** Default configuration values */
+const DEFAULTS = {
+	batchSize: 10,
+	flushInterval: 5e3,
+	timeout: 1e4,
+	retries: 3
+};
+/** Base delay for exponential backoff in ms */
+const BACKOFF_BASE_MS = 1e3;
+/** LocalStorage key for anonymous ID */
+const ANON_ID_KEY = "analytics_anonymous_id";
+/**
+* HTTP Analytics Provider for browser environments.
+*
+* Sends analytics events to a remote endpoint via HTTP POST requests.
+* Events are batched and flushed periodically for efficiency.
+*
+* @example
+* ```typescript
+* const provider = new HttpClientProvider({
+*   options: {
+*     endpoint: 'https://api.oneapp.dev/v1/ingest',
+*     apiKey: process.env.NEXT_PUBLIC_ANALYTICS_API_KEY,
+*   },
+* });
+* await provider.initialize();
+* await provider.track('Button Clicked', { button: 'signup' });
+* ```
+*/
+var HttpClientProvider = class {
+	name = "http";
+	config;
+	isInitialized = false;
+	queue = [];
+	flushTimer = null;
+	userId;
+	anonymousId;
+	isFlushing = false;
+	constructor(providerConfig) {
+		const options = providerConfig.options ?? {};
+		if (!options.endpoint) throw new Error("HttpProvider requires an endpoint URL");
+		this.config = {
+			...options,
+			batchSize: options.batchSize ?? DEFAULTS.batchSize,
+			flushInterval: options.flushInterval ?? DEFAULTS.flushInterval,
+			timeout: options.timeout ?? DEFAULTS.timeout,
+			retries: options.retries ?? DEFAULTS.retries
+		};
+		this.userId = options.userId;
+		this.anonymousId = options.anonymousId ?? this.getOrCreateAnonymousId();
+	}
+	async initialize() {
+		if (this.isInitialized) return;
+		if (this.config.flushInterval > 0) this.flushTimer = setInterval(() => {
+			this.flush();
+		}, this.config.flushInterval);
+		if (typeof document !== "undefined") document.addEventListener("visibilitychange", this.handleVisibilityChange);
+		if (typeof window !== "undefined") window.addEventListener("beforeunload", this.handleBeforeUnload);
+		if (this.config.debug) this.log("HTTP Analytics Provider initialized", {
+			endpoint: this.config.endpoint,
+			batchSize: this.config.batchSize,
+			flushInterval: this.config.flushInterval
+		});
+		this.isInitialized = true;
+	}
+	async track(event, properties = {}, _context) {
+		if (!this.isInitialized) {
+			this.warn("HTTP provider not initialized", {
+				operation: "track",
+				event
+			});
+			return;
+		}
+		this.enqueue({
+			type: "track",
+			event,
+			properties,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			userId: this.userId,
+			anonymousId: this.anonymousId
+		});
+	}
+	async identify(userId, traits = {}, _context) {
+		if (!this.isInitialized) {
+			this.warn("HTTP provider not initialized", {
+				operation: "identify",
+				userId
+			});
+			return;
+		}
+		this.userId = userId;
+		this.enqueue({
+			type: "identify",
+			userId,
+			traits,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			anonymousId: this.anonymousId
+		});
+	}
+	async page(name, properties = {}, _context) {
+		if (!this.isInitialized) {
+			this.warn("HTTP provider not initialized", {
+				operation: "page",
+				name
+			});
+			return;
+		}
+		this.enqueue({
+			type: "page",
+			name,
+			properties,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			userId: this.userId,
+			anonymousId: this.anonymousId
+		});
+	}
+	async group(groupId, traits = {}, _context) {
+		if (!this.isInitialized) {
+			this.warn("HTTP provider not initialized", {
+				operation: "group",
+				groupId
+			});
+			return;
+		}
+		this.enqueue({
+			type: "group",
+			groupId,
+			traits,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			userId: this.userId,
+			anonymousId: this.anonymousId
+		});
+	}
+	async alias(userId, previousId, _context) {
+		if (!this.isInitialized) {
+			this.warn("HTTP provider not initialized", {
+				operation: "alias",
+				userId,
+				previousId
+			});
+			return;
+		}
+		this.enqueue({
+			type: "alias",
+			userId,
+			previousId,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			anonymousId: this.anonymousId
+		});
+	}
+	/**
+	* Flush all queued events to the remote endpoint.
+	* Called automatically on interval, batch size, or page events.
+	*/
+	async flush() {
+		if (this.queue.length === 0 || this.isFlushing) return;
+		this.isFlushing = true;
+		const events = [...this.queue];
+		this.queue = [];
+		try {
+			await this.sendBatch(events);
+		} catch (error) {
+			this.queue.unshift(...events);
+			this.error("Failed to flush events, re-queued for retry", {
+				eventCount: events.length,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		} finally {
+			this.isFlushing = false;
+		}
+	}
+	/**
+	* Shutdown the provider gracefully.
+	* Flushes remaining events and removes event listeners.
+	*/
+	async shutdown() {
+		if (this.flushTimer) {
+			clearInterval(this.flushTimer);
+			this.flushTimer = null;
+		}
+		if (typeof document !== "undefined") document.removeEventListener("visibilitychange", this.handleVisibilityChange);
+		if (typeof window !== "undefined") window.removeEventListener("beforeunload", this.handleBeforeUnload);
+		await this.flush();
+		this.isInitialized = false;
+	}
+	/**
+	* Get the current queue length (for testing/monitoring).
+	*/
+	getQueueLength() {
+		return this.queue.length;
+	}
+	handleVisibilityChange = () => {
+		if (document.visibilityState === "hidden") this.flush();
+	};
+	handleBeforeUnload = () => {
+		if (this.queue.length > 0 && typeof navigator?.sendBeacon === "function") {
+			const payload = JSON.stringify({ batch: this.queue });
+			const blob = new Blob([payload], { type: "application/json" });
+			navigator.sendBeacon(this.config.endpoint, blob);
+			this.queue = [];
+		}
+	};
+	enqueue(event) {
+		this.queue.push(event);
+		if (this.config.debug) this.log("Event queued", {
+			type: event.type,
+			queueLength: this.queue.length
+		});
+		if (this.queue.length >= this.config.batchSize) this.flush();
+	}
+	async sendBatch(events) {
+		const payload = { batch: events };
+		let lastError = null;
+		for (let attempt = 0; attempt <= this.config.retries; attempt++) try {
+			const response = await this.sendRequest(payload);
+			if (response.success) {
+				if (this.config.debug) this.log("Batch sent successfully", {
+					accepted: response.accepted,
+					rejected: response.rejected
+				});
+				return;
+			}
+			this.warn("Batch partially rejected", {
+				accepted: response.accepted,
+				rejected: response.rejected,
+				error: response.error
+			});
+			return;
+		} catch (error) {
+			lastError = error instanceof Error ? error : new Error(String(error));
+			if (attempt < this.config.retries) {
+				const delay = BACKOFF_BASE_MS * Math.pow(2, attempt);
+				if (this.config.debug) this.log("Retrying batch send", {
+					attempt: attempt + 1,
+					maxRetries: this.config.retries,
+					delayMs: delay
+				});
+				await this.sleep(delay);
+			}
+		}
+		throw lastError ?? /* @__PURE__ */ new Error("Failed to send batch after retries");
+	}
+	async sendRequest(payload) {
+		const headers = {
+			"Content-Type": "application/json",
+			...this.config.headers
+		};
+		if (this.config.apiKey) headers["X-API-Key"] = this.config.apiKey;
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+		try {
+			const response = await fetch(this.config.endpoint, {
+				method: "POST",
+				headers,
+				body: JSON.stringify(payload),
+				signal: controller.signal,
+				credentials: "omit"
+			});
+			if (!response.ok) {
+				if (response.status === 429) {
+					const retryAfter = response.headers.get("Retry-After");
+					throw new Error(`Rate limited. Retry after ${retryAfter ?? "unknown"} seconds`);
+				}
+				const errorBody = await response.text();
+				throw new Error(`HTTP ${response.status}: ${errorBody}`);
+			}
+			return await response.json();
+		} finally {
+			clearTimeout(timeoutId);
+		}
+	}
+	getOrCreateAnonymousId() {
+		if (typeof localStorage !== "undefined") try {
+			const stored = localStorage.getItem(ANON_ID_KEY);
+			if (stored) return stored;
+			const newId = this.generateAnonymousId();
+			localStorage.setItem(ANON_ID_KEY, newId);
+			return newId;
+		} catch {}
+		return this.generateAnonymousId();
+	}
+	generateAnonymousId() {
+		if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
+		return `anon_${Date.now().toString(36)}${Math.random().toString(36).slice(2, 9)}`;
+	}
+	sleep(ms) {
+		return new Promise((resolve) => setTimeout(resolve, ms));
+	}
+	log(message, data) {
+		if (this.config.debug) logInfo(`[Analytics:HTTP] ${message}`, data);
+	}
+	warn(message, data) {
+		logWarn(`[Analytics:HTTP] ${message}`, data);
+	}
+	error(message, data) {
+		logError(`[Analytics:HTTP] ${message}`, data);
+	}
+};
+
+//#endregion
+export { HttpClientProvider };
+//# sourceMappingURL=providers-http-client.mjs.map

package/dist/providers-http-client.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers-http-client.mjs","names":[],"sources":["../src/providers/http/client.ts"],"sourcesContent":["/**\n * @fileoverview HTTP provider for browser/client environments\n *\n * Provides HTTP-based analytics event sending for client-side applications.\n * Sends events to a remote ingestion endpoint (e.g., oneapp-api/ingest).\n *\n * Features:\n * - Event batching for efficiency\n * - Automatic flush on interval, batch size, or page unload\n * - Retry with exponential backoff\n * - Anonymous ID persistence in localStorage\n * - Offline queue support (events queued when offline)\n *\n * @module @od-oneapp/analytics/providers/http/client\n */\n\nimport { logInfo, logWarn, logError } from '@repo/shared/logs';\n\nimport type { HttpProviderConfig, IngestionResponse, QueuedEvent } from './types';\nimport type {\n  AnalyticsContext,\n  AnalyticsProvider,\n  GroupTraits,\n  PageProperties,\n  Properties,\n  ProviderConfig,\n  UserTraits,\n} from '../../shared/types/types';\n\n/** Default configuration values */\nconst DEFAULTS = {\n  batchSize: 10,\n  flushInterval: 5000,\n  timeout: 10000,\n  retries: 3,\n} as const;\n\n/** Base delay for exponential backoff in ms */\nconst BACKOFF_BASE_MS = 1000;\n\n/** LocalStorage key for anonymous ID */\nconst ANON_ID_KEY = 'analytics_anonymous_id';\n\n/**\n * HTTP Analytics Provider for browser environments.\n *\n * Sends analytics events to a remote endpoint via HTTP POST requests.\n * Events are batched and flushed periodically for efficiency.\n *\n * @example\n * ```typescript\n * const provider = new HttpClientProvider({\n *   options: {\n *     endpoint: 'https://api.oneapp.dev/v1/ingest',\n *     apiKey: process.env.NEXT_PUBLIC_ANALYTICS_API_KEY,\n *   },\n * });\n * await provider.initialize();\n * await provider.track('Button Clicked', { button: 'signup' });\n * ```\n */\nexport class HttpClientProvider implements AnalyticsProvider {\n  readonly name = 'http';\n\n  private config: Required<\n    Pick<HttpProviderConfig, 'batchSize' | 'flushInterval' | 'timeout' | 'retries'>\n  > &\n    HttpProviderConfig;\n  private isInitialized = false;\n  private queue: QueuedEvent[] = [];\n  private flushTimer: ReturnType<typeof setInterval> | null = null;\n  private userId?: string;\n  private anonymousId: string;\n  private isFlushing = false;\n\n  constructor(providerConfig: ProviderConfig) {\n    const options = (providerConfig.options ?? {}) as unknown as HttpProviderConfig;\n\n    if (!options.endpoint) {\n      throw new Error('HttpProvider requires an endpoint URL');\n    }\n\n    this.config = {\n      ...options,\n      batchSize: options.batchSize ?? DEFAULTS.batchSize,\n      flushInterval: options.flushInterval ?? DEFAULTS.flushInterval,\n      timeout: options.timeout ?? DEFAULTS.timeout,\n      retries: options.retries ?? DEFAULTS.retries,\n    };\n\n    this.userId = options.userId;\n    this.anonymousId = options.anonymousId ?? this.getOrCreateAnonymousId();\n  }\n\n  async initialize(): Promise<void> {\n    if (this.isInitialized) return;\n\n    // Start auto-flush timer if interval > 0\n    if (this.config.flushInterval > 0) {\n      this.flushTimer = setInterval(() => {\n        void this.flush();\n      }, this.config.flushInterval);\n    }\n\n    // Flush on page unload/visibility change\n    if (typeof document !== 'undefined') {\n      document.addEventListener('visibilitychange', this.handleVisibilityChange);\n    }\n\n    if (typeof window !== 'undefined') {\n      window.addEventListener('beforeunload', this.handleBeforeUnload);\n    }\n\n    if (this.config.debug) {\n      this.log('HTTP Analytics Provider initialized', {\n        endpoint: this.config.endpoint,\n        batchSize: this.config.batchSize,\n        flushInterval: this.config.flushInterval,\n      });\n    }\n\n    this.isInitialized = true;\n  }\n\n  async track(\n    event: string,\n    properties: Properties = {},\n    _context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.isInitialized) {\n      this.warn('HTTP provider not initialized', { operation: 'track', event });\n      return;\n    }\n\n    this.enqueue({\n      type: 'track',\n      event,\n      properties,\n      timestamp: new Date().toISOString(),\n      userId: this.userId,\n      anonymousId: this.anonymousId,\n    });\n  }\n\n  async identify(\n    userId: string,\n    traits: UserTraits = {},\n    _context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.isInitialized) {\n      this.warn('HTTP provider not initialized', { operation: 'identify', userId });\n      return;\n    }\n\n    // Update stored user ID\n    this.userId = userId;\n\n    this.enqueue({\n      type: 'identify',\n      userId,\n      traits,\n      timestamp: new Date().toISOString(),\n      anonymousId: this.anonymousId,\n    });\n  }\n\n  async page(\n    name?: string,\n    properties: PageProperties = {},\n    _context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.isInitialized) {\n      this.warn('HTTP provider not initialized', { operation: 'page', name });\n      return;\n    }\n\n    this.enqueue({\n      type: 'page',\n      name,\n      properties,\n      timestamp: new Date().toISOString(),\n      userId: this.userId,\n      anonymousId: this.anonymousId,\n    });\n  }\n\n  async group(\n    groupId: string,\n    traits: GroupTraits = {},\n    _context?: AnalyticsContext,\n  ): Promise<void> {\n    if (!this.isInitialized) {\n      this.warn('HTTP provider not initialized', { operation: 'group', groupId });\n      return;\n    }\n\n    this.enqueue({\n      type: 'group',\n      groupId,\n      traits,\n      timestamp: new Date().toISOString(),\n      userId: this.userId,\n      anonymousId: this.anonymousId,\n    });\n  }\n\n  async alias(userId: string, previousId: string, _context?: AnalyticsContext): Promise<void> {\n    if (!this.isInitialized) {\n      this.warn('HTTP provider not initialized', { operation: 'alias', userId, previousId });\n      return;\n    }\n\n    this.enqueue({\n      type: 'alias',\n      userId,\n      previousId,\n      timestamp: new Date().toISOString(),\n      anonymousId: this.anonymousId,\n    });\n  }\n\n  /**\n   * Flush all queued events to the remote endpoint.\n   * Called automatically on interval, batch size, or page events.\n   */\n  async flush(): Promise<void> {\n    if (this.queue.length === 0 || this.isFlushing) return;\n\n    this.isFlushing = true;\n\n    // Take all events from queue\n    const events = [...this.queue];\n    this.queue = [];\n\n    try {\n      await this.sendBatch(events);\n    } catch (error) {\n      // Re-queue events on failure (they'll be retried on next flush)\n      this.queue.unshift(...events);\n      this.error('Failed to flush events, re-queued for retry', {\n        eventCount: events.length,\n        error: error instanceof Error ? error.message : String(error),\n      });\n    } finally {\n      this.isFlushing = false;\n    }\n  }\n\n  /**\n   * Shutdown the provider gracefully.\n   * Flushes remaining events and removes event listeners.\n   */\n  async shutdown(): Promise<void> {\n    if (this.flushTimer) {\n      clearInterval(this.flushTimer);\n      this.flushTimer = null;\n    }\n\n    if (typeof document !== 'undefined') {\n      document.removeEventListener('visibilitychange', this.handleVisibilityChange);\n    }\n\n    if (typeof window !== 'undefined') {\n      window.removeEventListener('beforeunload', this.handleBeforeUnload);\n    }\n\n    // Final flush\n    await this.flush();\n    this.isInitialized = false;\n  }\n\n  /**\n   * Get the current queue length (for testing/monitoring).\n   */\n  getQueueLength(): number {\n    return this.queue.length;\n  }\n\n  // ============================================================================\n  // Event Handlers\n  // ============================================================================\n\n  private handleVisibilityChange = (): void => {\n    if (document.visibilityState === 'hidden') {\n      void this.flush();\n    }\n  };\n\n  private handleBeforeUnload = (): void => {\n    // Use sendBeacon for reliable delivery on page unload\n    if (this.queue.length > 0 && typeof navigator?.sendBeacon === 'function') {\n      const payload = JSON.stringify({ batch: this.queue });\n      const headers: Record<string, string> = {\n        type: 'application/json',\n      };\n\n      // Note: sendBeacon doesn't support custom headers, so we include API key in payload\n      // The server should accept it from either header or body\n      const blob = new Blob([payload], headers);\n      navigator.sendBeacon(this.config.endpoint, blob);\n      this.queue = [];\n    }\n  };\n\n  // ============================================================================\n  // Private Methods\n  // ============================================================================\n\n  private enqueue(event: QueuedEvent): void {\n    this.queue.push(event);\n\n    if (this.config.debug) {\n      this.log('Event queued', {\n        type: event.type,\n        queueLength: this.queue.length,\n      });\n    }\n\n    // Flush if batch size reached\n    if (this.queue.length >= this.config.batchSize) {\n      void this.flush();\n    }\n  }\n\n  private async sendBatch(events: QueuedEvent[]): Promise<void> {\n    const payload = { batch: events };\n\n    let lastError: Error | null = null;\n\n    for (let attempt = 0; attempt <= this.config.retries; attempt++) {\n      try {\n        const response = await this.sendRequest(payload);\n\n        if (response.success) {\n          if (this.config.debug) {\n            this.log('Batch sent successfully', {\n              accepted: response.accepted,\n              rejected: response.rejected,\n            });\n          }\n          return;\n        }\n\n        // Request succeeded but ingestion failed\n        this.warn('Batch partially rejected', {\n          accepted: response.accepted,\n          rejected: response.rejected,\n          error: response.error,\n        });\n        return;\n      } catch (error) {\n        lastError = error instanceof Error ? error : new Error(String(error));\n\n        if (attempt < this.config.retries) {\n          // Exponential backoff: 1s, 2s, 4s, ...\n          const delay = BACKOFF_BASE_MS * Math.pow(2, attempt);\n\n          if (this.config.debug) {\n            this.log('Retrying batch send', {\n              attempt: attempt + 1,\n              maxRetries: this.config.retries,\n              delayMs: delay,\n            });\n          }\n\n          await this.sleep(delay);\n        }\n      }\n    }\n\n    // All retries exhausted\n    throw lastError ?? new Error('Failed to send batch after retries');\n  }\n\n  private async sendRequest(payload: { batch: QueuedEvent[] }): Promise<IngestionResponse> {\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n      ...this.config.headers,\n    };\n\n    if (this.config.apiKey) {\n      headers['X-API-Key'] = this.config.apiKey;\n    }\n\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\n\n    try {\n      const response = await fetch(this.config.endpoint, {\n        method: 'POST',\n        headers,\n        body: JSON.stringify(payload),\n        signal: controller.signal,\n        // Include credentials for cross-origin requests if needed\n        credentials: 'omit',\n      });\n\n      if (!response.ok) {\n        // Handle rate limiting\n        if (response.status === 429) {\n          const retryAfter = response.headers.get('Retry-After');\n          throw new Error(`Rate limited. Retry after ${retryAfter ?? 'unknown'} seconds`);\n        }\n\n        const errorBody = await response.text();\n        throw new Error(`HTTP ${response.status}: ${errorBody}`);\n      }\n\n      return (await response.json()) as IngestionResponse;\n    } finally {\n      clearTimeout(timeoutId);\n    }\n  }\n\n  private getOrCreateAnonymousId(): string {\n    // Try to get from localStorage\n    if (typeof localStorage !== 'undefined') {\n      try {\n        const stored = localStorage.getItem(ANON_ID_KEY);\n        if (stored) return stored;\n\n        const newId = this.generateAnonymousId();\n        localStorage.setItem(ANON_ID_KEY, newId);\n        return newId;\n      } catch {\n        // localStorage not available or blocked\n      }\n    }\n\n    return this.generateAnonymousId();\n  }\n\n  private generateAnonymousId(): string {\n    // Use crypto.randomUUID if available\n    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {\n      return crypto.randomUUID();\n    }\n\n    // Fallback\n    return `anon_${Date.now().toString(36)}${Math.random().toString(36).slice(2, 9)}`;\n  }\n\n  private sleep(ms: number): Promise<void> {\n    return new Promise(resolve => setTimeout(resolve, ms));\n  }\n\n  // ============================================================================\n  // Logging (browser-compatible)\n  // ============================================================================\n\n  private log(message: string, data?: Record<string, unknown>): void {\n    if (this.config.debug) {\n      logInfo(`[Analytics:HTTP] ${message}`, data);\n    }\n  }\n\n  private warn(message: string, data?: Record<string, unknown>): void {\n    logWarn(`[Analytics:HTTP] ${message}`, data);\n  }\n\n  private error(message: string, data?: Record<string, unknown>): void {\n    logError(`[Analytics:HTTP] ${message}`, data);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA8BA,MAAM,WAAW;CACf,WAAW;CACX,eAAe;CACf,SAAS;CACT,SAAS;CACV;;AAGD,MAAM,kBAAkB;;AAGxB,MAAM,cAAc;;;;;;;;;;;;;;;;;;;AAoBpB,IAAa,qBAAb,MAA6D;CAC3D,AAAS,OAAO;CAEhB,AAAQ;CAIR,AAAQ,gBAAgB;CACxB,AAAQ,QAAuB,EAAE;CACjC,AAAQ,aAAoD;CAC5D,AAAQ;CACR,AAAQ;CACR,AAAQ,aAAa;CAErB,YAAY,gBAAgC;EAC1C,MAAM,UAAW,eAAe,WAAW,EAAE;AAE7C,MAAI,CAAC,QAAQ,SACX,OAAM,IAAI,MAAM,wCAAwC;AAG1D,OAAK,SAAS;GACZ,GAAG;GACH,WAAW,QAAQ,aAAa,SAAS;GACzC,eAAe,QAAQ,iBAAiB,SAAS;GACjD,SAAS,QAAQ,WAAW,SAAS;GACrC,SAAS,QAAQ,WAAW,SAAS;GACtC;AAED,OAAK,SAAS,QAAQ;AACtB,OAAK,cAAc,QAAQ,eAAe,KAAK,wBAAwB;;CAGzE,MAAM,aAA4B;AAChC,MAAI,KAAK,cAAe;AAGxB,MAAI,KAAK,OAAO,gBAAgB,EAC9B,MAAK,aAAa,kBAAkB;AAClC,GAAK,KAAK,OAAO;KAChB,KAAK,OAAO,cAAc;AAI/B,MAAI,OAAO,aAAa,YACtB,UAAS,iBAAiB,oBAAoB,KAAK,uBAAuB;AAG5E,MAAI,OAAO,WAAW,YACpB,QAAO,iBAAiB,gBAAgB,KAAK,mBAAmB;AAGlE,MAAI,KAAK,OAAO,MACd,MAAK,IAAI,uCAAuC;GAC9C,UAAU,KAAK,OAAO;GACtB,WAAW,KAAK,OAAO;GACvB,eAAe,KAAK,OAAO;GAC5B,CAAC;AAGJ,OAAK,gBAAgB;;CAGvB,MAAM,MACJ,OACA,aAAyB,EAAE,EAC3B,UACe;AACf,MAAI,CAAC,KAAK,eAAe;AACvB,QAAK,KAAK,iCAAiC;IAAE,WAAW;IAAS;IAAO,CAAC;AACzE;;AAGF,OAAK,QAAQ;GACX,MAAM;GACN;GACA;GACA,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,QAAQ,KAAK;GACb,aAAa,KAAK;GACnB,CAAC;;CAGJ,MAAM,SACJ,QACA,SAAqB,EAAE,EACvB,UACe;AACf,MAAI,CAAC,KAAK,eAAe;AACvB,QAAK,KAAK,iCAAiC;IAAE,WAAW;IAAY;IAAQ,CAAC;AAC7E;;AAIF,OAAK,SAAS;AAEd,OAAK,QAAQ;GACX,MAAM;GACN;GACA;GACA,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,aAAa,KAAK;GACnB,CAAC;;CAGJ,MAAM,KACJ,MACA,aAA6B,EAAE,EAC/B,UACe;AACf,MAAI,CAAC,KAAK,eAAe;AACvB,QAAK,KAAK,iCAAiC;IAAE,WAAW;IAAQ;IAAM,CAAC;AACvE;;AAGF,OAAK,QAAQ;GACX,MAAM;GACN;GACA;GACA,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,QAAQ,KAAK;GACb,aAAa,KAAK;GACnB,CAAC;;CAGJ,MAAM,MACJ,SACA,SAAsB,EAAE,EACxB,UACe;AACf,MAAI,CAAC,KAAK,eAAe;AACvB,QAAK,KAAK,iCAAiC;IAAE,WAAW;IAAS;IAAS,CAAC;AAC3E;;AAGF,OAAK,QAAQ;GACX,MAAM;GACN;GACA;GACA,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,QAAQ,KAAK;GACb,aAAa,KAAK;GACnB,CAAC;;CAGJ,MAAM,MAAM,QAAgB,YAAoB,UAA4C;AAC1F,MAAI,CAAC,KAAK,eAAe;AACvB,QAAK,KAAK,iCAAiC;IAAE,WAAW;IAAS;IAAQ;IAAY,CAAC;AACtF;;AAGF,OAAK,QAAQ;GACX,MAAM;GACN;GACA;GACA,4BAAW,IAAI,MAAM,EAAC,aAAa;GACnC,aAAa,KAAK;GACnB,CAAC;;;;;;CAOJ,MAAM,QAAuB;AAC3B,MAAI,KAAK,MAAM,WAAW,KAAK,KAAK,WAAY;AAEhD,OAAK,aAAa;EAGlB,MAAM,SAAS,CAAC,GAAG,KAAK,MAAM;AAC9B,OAAK,QAAQ,EAAE;AAEf,MAAI;AACF,SAAM,KAAK,UAAU,OAAO;WACrB,OAAO;AAEd,QAAK,MAAM,QAAQ,GAAG,OAAO;AAC7B,QAAK,MAAM,+CAA+C;IACxD,YAAY,OAAO;IACnB,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAC9D,CAAC;YACM;AACR,QAAK,aAAa;;;;;;;CAQtB,MAAM,WAA0B;AAC9B,MAAI,KAAK,YAAY;AACnB,iBAAc,KAAK,WAAW;AAC9B,QAAK,aAAa;;AAGpB,MAAI,OAAO,aAAa,YACtB,UAAS,oBAAoB,oBAAoB,KAAK,uBAAuB;AAG/E,MAAI,OAAO,WAAW,YACpB,QAAO,oBAAoB,gBAAgB,KAAK,mBAAmB;AAIrE,QAAM,KAAK,OAAO;AAClB,OAAK,gBAAgB;;;;;CAMvB,iBAAyB;AACvB,SAAO,KAAK,MAAM;;CAOpB,AAAQ,+BAAqC;AAC3C,MAAI,SAAS,oBAAoB,SAC/B,CAAK,KAAK,OAAO;;CAIrB,AAAQ,2BAAiC;AAEvC,MAAI,KAAK,MAAM,SAAS,KAAK,OAAO,WAAW,eAAe,YAAY;GACxE,MAAM,UAAU,KAAK,UAAU,EAAE,OAAO,KAAK,OAAO,CAAC;GAOrD,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EANS,EACtC,MAAM,oBACP,CAIwC;AACzC,aAAU,WAAW,KAAK,OAAO,UAAU,KAAK;AAChD,QAAK,QAAQ,EAAE;;;CAQnB,AAAQ,QAAQ,OAA0B;AACxC,OAAK,MAAM,KAAK,MAAM;AAEtB,MAAI,KAAK,OAAO,MACd,MAAK,IAAI,gBAAgB;GACvB,MAAM,MAAM;GACZ,aAAa,KAAK,MAAM;GACzB,CAAC;AAIJ,MAAI,KAAK,MAAM,UAAU,KAAK,OAAO,UACnC,CAAK,KAAK,OAAO;;CAIrB,MAAc,UAAU,QAAsC;EAC5D,MAAM,UAAU,EAAE,OAAO,QAAQ;EAEjC,IAAI,YAA0B;AAE9B,OAAK,IAAI,UAAU,GAAG,WAAW,KAAK,OAAO,SAAS,UACpD,KAAI;GACF,MAAM,WAAW,MAAM,KAAK,YAAY,QAAQ;AAEhD,OAAI,SAAS,SAAS;AACpB,QAAI,KAAK,OAAO,MACd,MAAK,IAAI,2BAA2B;KAClC,UAAU,SAAS;KACnB,UAAU,SAAS;KACpB,CAAC;AAEJ;;AAIF,QAAK,KAAK,4BAA4B;IACpC,UAAU,SAAS;IACnB,UAAU,SAAS;IACnB,OAAO,SAAS;IACjB,CAAC;AACF;WACO,OAAO;AACd,eAAY,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,OAAO,MAAM,CAAC;AAErE,OAAI,UAAU,KAAK,OAAO,SAAS;IAEjC,MAAM,QAAQ,kBAAkB,KAAK,IAAI,GAAG,QAAQ;AAEpD,QAAI,KAAK,OAAO,MACd,MAAK,IAAI,uBAAuB;KAC9B,SAAS,UAAU;KACnB,YAAY,KAAK,OAAO;KACxB,SAAS;KACV,CAAC;AAGJ,UAAM,KAAK,MAAM,MAAM;;;AAM7B,QAAM,6BAAa,IAAI,MAAM,qCAAqC;;CAGpE,MAAc,YAAY,SAA+D;EACvF,MAAM,UAAkC;GACtC,gBAAgB;GAChB,GAAG,KAAK,OAAO;GAChB;AAED,MAAI,KAAK,OAAO,OACd,SAAQ,eAAe,KAAK,OAAO;EAGrC,MAAM,aAAa,IAAI,iBAAiB;EACxC,MAAM,YAAY,iBAAiB,WAAW,OAAO,EAAE,KAAK,OAAO,QAAQ;AAE3E,MAAI;GACF,MAAM,WAAW,MAAM,MAAM,KAAK,OAAO,UAAU;IACjD,QAAQ;IACR;IACA,MAAM,KAAK,UAAU,QAAQ;IAC7B,QAAQ,WAAW;IAEnB,aAAa;IACd,CAAC;AAEF,OAAI,CAAC,SAAS,IAAI;AAEhB,QAAI,SAAS,WAAW,KAAK;KAC3B,MAAM,aAAa,SAAS,QAAQ,IAAI,cAAc;AACtD,WAAM,IAAI,MAAM,6BAA6B,cAAc,UAAU,UAAU;;IAGjF,MAAM,YAAY,MAAM,SAAS,MAAM;AACvC,UAAM,IAAI,MAAM,QAAQ,SAAS,OAAO,IAAI,YAAY;;AAG1D,UAAQ,MAAM,SAAS,MAAM;YACrB;AACR,gBAAa,UAAU;;;CAI3B,AAAQ,yBAAiC;AAEvC,MAAI,OAAO,iBAAiB,YAC1B,KAAI;GACF,MAAM,SAAS,aAAa,QAAQ,YAAY;AAChD,OAAI,OAAQ,QAAO;GAEnB,MAAM,QAAQ,KAAK,qBAAqB;AACxC,gBAAa,QAAQ,aAAa,MAAM;AACxC,UAAO;UACD;AAKV,SAAO,KAAK,qBAAqB;;CAGnC,AAAQ,sBAA8B;AAEpC,MAAI,OAAO,WAAW,eAAe,OAAO,OAAO,eAAe,WAChE,QAAO,OAAO,YAAY;AAI5B,SAAO,QAAQ,KAAK,KAAK,CAAC,SAAS,GAAG,GAAG,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE;;CAGjF,AAAQ,MAAM,IAA2B;AACvC,SAAO,IAAI,SAAQ,YAAW,WAAW,SAAS,GAAG,CAAC;;CAOxD,AAAQ,IAAI,SAAiB,MAAsC;AACjE,MAAI,KAAK,OAAO,MACd,SAAQ,oBAAoB,WAAW,KAAK;;CAIhD,AAAQ,KAAK,SAAiB,MAAsC;AAClE,UAAQ,oBAAoB,WAAW,KAAK;;CAG9C,AAAQ,MAAM,SAAiB,MAAsC;AACnE,WAAS,oBAAoB,WAAW,KAAK"}

package/dist/providers-http-server.d.mts

@@ -0,0 +1,31 @@
+import { A as GroupTraits, F as UserTraits, M as Properties, c as ProviderConfig, i as AnalyticsProvider, j as PageProperties, n as AnalyticsContext } from "./types-BxBnNQ0V.mjs";
+
+//#region src/providers/http/server.d.ts
+declare class HttpServerProvider implements AnalyticsProvider {
+  readonly name = "http";
+  private config;
+  private isInitialized;
+  private queue;
+  private flushTimer;
+  private userId?;
+  private anonymousId;
+  private isFlushing;
+  constructor(providerConfig: ProviderConfig);
+  initialize(): Promise<void>;
+  track(event: string, properties?: Properties, _context?: AnalyticsContext): Promise<void>;
+  identify(userId: string, traits?: UserTraits, _context?: AnalyticsContext): Promise<void>;
+  page(name?: string, properties?: PageProperties, _context?: AnalyticsContext): Promise<void>;
+  group(groupId: string, traits?: GroupTraits, _context?: AnalyticsContext): Promise<void>;
+  alias(userId: string, previousId: string, _context?: AnalyticsContext): Promise<void>;
+  flush(): Promise<void>;
+  shutdown(): Promise<void>;
+  getQueueLength(): number;
+  private enqueue;
+  private sendBatch;
+  private sendRequest;
+  private generateAnonymousId;
+  private sleep;
+}
+//#endregion
+export { HttpServerProvider };
+//# sourceMappingURL=providers-http-server.d.mts.map

package/dist/providers-http-server.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers-http-server.d.mts","names":[],"sources":["../src/providers/http/server.ts"],"mappings":";;;cA0Da,kBAAA,YAA8B,iBAAA;EAAA,SAChC,IAAA;EAAA,QAED,MAAA;EAAA,QAIA,aAAA;EAAA,QACA,KAAA;EAAA,QACA,UAAA;EAAA,QACA,MAAA;EAAA,QACA,WAAA;EAAA,QACA,UAAA;cAEI,cAAA,EAAgB,cAAA;EAmBtB,UAAA,CAAA,GAAc,OAAA;EA2Bd,KAAA,CACJ,KAAA,UACA,UAAA,GAAY,UAAA,EACZ,QAAA,GAAW,gBAAA,GACV,OAAA;EAgBG,QAAA,CACJ,MAAA,UACA,MAAA,GAAQ,UAAA,EACR,QAAA,GAAW,gBAAA,GACV,OAAA;EAkBG,IAAA,CACJ,IAAA,WACA,UAAA,GAAY,cAAA,EACZ,QAAA,GAAW,gBAAA,GACV,OAAA;EAgBG,KAAA,CACJ,OAAA,UACA,MAAA,GAAQ,WAAA,EACR,QAAA,GAAW,gBAAA,GACV,OAAA;EAgBG,KAAA,CAAM,MAAA,UAAgB,UAAA,UAAoB,QAAA,GAAW,gBAAA,GAAmB,OAAA;EAwBxE,KAAA,CAAA,GAAS,OAAA;EA4BT,QAAA,CAAA,GAAY,OAAA;EAclB,cAAA,CAAA;EAAA,QAQQ,OAAA;EAAA,QAiBM,SAAA;EAAA,QAqDA,WAAA;EAAA,QAsCN,mBAAA;EAAA,QAUA,KAAA;AAAA"}

package/dist/providers-http-server.mjs

@@ -0,0 +1,297 @@
+import { logDebug, logError, logWarn } from "@od-oneapp/shared/logs";
+
+//#region src/providers/http/server.ts
+/**
+* @fileoverview HTTP provider for server/Node.js environments
+*
+* Provides HTTP-based analytics event sending for server-side applications.
+* Sends events to a remote ingestion endpoint (e.g., oneapp-api/ingest).
+*
+* Features:
+* - Event batching for efficiency
+* - Automatic flush on interval or batch size
+* - Retry with exponential backoff
+* - Graceful shutdown with final flush
+*
+* @module @od-oneapp/analytics/providers/http/server
+*/
+/** Default configuration values */
+const DEFAULTS = {
+	batchSize: 10,
+	flushInterval: 5e3,
+	timeout: 1e4,
+	retries: 3
+};
+/** Base delay for exponential backoff in ms */
+const BACKOFF_BASE_MS = 1e3;
+/**
+* HTTP Analytics Provider for server environments.
+*
+* Sends analytics events to a remote endpoint via HTTP POST requests.
+* Events are batched and flushed periodically for efficiency.
+*
+* @example
+* ```typescript
+* const provider = new HttpServerProvider({
+*   options: {
+*     endpoint: 'https://api.oneapp.dev/v1/ingest',
+*     apiKey: process.env.ANALYTICS_API_KEY,
+*   },
+* });
+* await provider.initialize();
+* await provider.track('Button Clicked', { button: 'signup' });
+* await provider.flush(); // Send queued events
+* ```
+*/
+var HttpServerProvider = class {
+	name = "http";
+	config;
+	isInitialized = false;
+	queue = [];
+	flushTimer = null;
+	userId;
+	anonymousId;
+	isFlushing = false;
+	constructor(providerConfig) {
+		const options = providerConfig.options ?? {};
+		if (!options.endpoint) throw new Error("HttpProvider requires an endpoint URL");
+		this.config = {
+			...options,
+			batchSize: options.batchSize ?? DEFAULTS.batchSize,
+			flushInterval: options.flushInterval ?? DEFAULTS.flushInterval,
+			timeout: options.timeout ?? DEFAULTS.timeout,
+			retries: options.retries ?? DEFAULTS.retries
+		};
+		this.userId = options.userId;
+		this.anonymousId = options.anonymousId ?? this.generateAnonymousId();
+	}
+	async initialize() {
+		if (this.isInitialized) return;
+		if (this.config.flushInterval > 0) {
+			this.flushTimer = setInterval(() => {
+				this.flush();
+			}, this.config.flushInterval);
+			if (typeof this.flushTimer.unref === "function") this.flushTimer.unref();
+		}
+		if (this.config.debug) logDebug("HTTP Analytics Provider initialized", {
+			provider: "http",
+			endpoint: this.config.endpoint,
+			batchSize: this.config.batchSize,
+			flushInterval: this.config.flushInterval
+		});
+		this.isInitialized = true;
+	}
+	async track(event, properties = {}, _context) {
+		if (!this.isInitialized) {
+			logWarn("HTTP provider not initialized", {
+				provider: "http",
+				operation: "track",
+				event
+			});
+			return;
+		}
+		this.enqueue({
+			type: "track",
+			event,
+			properties,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			userId: this.userId,
+			anonymousId: this.anonymousId
+		});
+	}
+	async identify(userId, traits = {}, _context) {
+		if (!this.isInitialized) {
+			logWarn("HTTP provider not initialized", {
+				provider: "http",
+				operation: "identify",
+				userId
+			});
+			return;
+		}
+		this.userId = userId;
+		this.enqueue({
+			type: "identify",
+			userId,
+			traits,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			anonymousId: this.anonymousId
+		});
+	}
+	async page(name, properties = {}, _context) {
+		if (!this.isInitialized) {
+			logWarn("HTTP provider not initialized", {
+				provider: "http",
+				operation: "page",
+				name
+			});
+			return;
+		}
+		this.enqueue({
+			type: "page",
+			name,
+			properties,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			userId: this.userId,
+			anonymousId: this.anonymousId
+		});
+	}
+	async group(groupId, traits = {}, _context) {
+		if (!this.isInitialized) {
+			logWarn("HTTP provider not initialized", {
+				provider: "http",
+				operation: "group",
+				groupId
+			});
+			return;
+		}
+		this.enqueue({
+			type: "group",
+			groupId,
+			traits,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			userId: this.userId,
+			anonymousId: this.anonymousId
+		});
+	}
+	async alias(userId, previousId, _context) {
+		if (!this.isInitialized) {
+			logWarn("HTTP provider not initialized", {
+				provider: "http",
+				operation: "alias",
+				userId,
+				previousId
+			});
+			return;
+		}
+		this.enqueue({
+			type: "alias",
+			userId,
+			previousId,
+			timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+			anonymousId: this.anonymousId
+		});
+	}
+	/**
+	* Flush all queued events to the remote endpoint.
+	* Called automatically on interval or when batch size is reached.
+	*/
+	async flush() {
+		if (this.queue.length === 0 || this.isFlushing) return;
+		this.isFlushing = true;
+		const events = [...this.queue];
+		this.queue = [];
+		try {
+			await this.sendBatch(events);
+		} catch (error) {
+			this.queue.unshift(...events);
+			logError("Failed to flush events, re-queued for retry", {
+				provider: "http",
+				eventCount: events.length,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		} finally {
+			this.isFlushing = false;
+		}
+	}
+	/**
+	* Shutdown the provider gracefully.
+	* Flushes remaining events and stops the flush timer.
+	*/
+	async shutdown() {
+		if (this.flushTimer) {
+			clearInterval(this.flushTimer);
+			this.flushTimer = null;
+		}
+		await this.flush();
+		this.isInitialized = false;
+	}
+	/**
+	* Get the current queue length (for testing/monitoring).
+	*/
+	getQueueLength() {
+		return this.queue.length;
+	}
+	enqueue(event) {
+		this.queue.push(event);
+		if (this.config.debug) logDebug("Event queued", {
+			provider: "http",
+			type: event.type,
+			queueLength: this.queue.length
+		});
+		if (this.queue.length >= this.config.batchSize) this.flush();
+	}
+	async sendBatch(events) {
+		const payload = { batch: events };
+		let lastError = null;
+		for (let attempt = 0; attempt <= this.config.retries; attempt++) try {
+			const response = await this.sendRequest(payload);
+			if (response.success) {
+				if (this.config.debug) logDebug("Batch sent successfully", {
+					provider: "http",
+					accepted: response.accepted,
+					rejected: response.rejected
+				});
+				return;
+			}
+			logWarn("Batch partially rejected", {
+				provider: "http",
+				accepted: response.accepted,
+				rejected: response.rejected,
+				error: response.error
+			});
+			return;
+		} catch (error) {
+			lastError = error instanceof Error ? error : new Error(String(error));
+			if (attempt < this.config.retries) {
+				const delay = BACKOFF_BASE_MS * Math.pow(2, attempt);
+				if (this.config.debug) logDebug("Retrying batch send", {
+					provider: "http",
+					attempt: attempt + 1,
+					maxRetries: this.config.retries,
+					delayMs: delay
+				});
+				await this.sleep(delay);
+			}
+		}
+		throw lastError ?? /* @__PURE__ */ new Error("Failed to send batch after retries");
+	}
+	async sendRequest(payload) {
+		const headers = {
+			"Content-Type": "application/json",
+			...this.config.headers
+		};
+		if (this.config.apiKey) headers["X-API-Key"] = this.config.apiKey;
+		const controller = new AbortController();
+		const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+		try {
+			const response = await fetch(this.config.endpoint, {
+				method: "POST",
+				headers,
+				body: JSON.stringify(payload),
+				signal: controller.signal
+			});
+			if (!response.ok) {
+				if (response.status === 429) {
+					const retryAfter = response.headers.get("Retry-After");
+					throw new Error(`Rate limited. Retry after ${retryAfter ?? "unknown"} seconds`);
+				}
+				const errorBody = await response.text();
+				throw new Error(`HTTP ${response.status}: ${errorBody}`);
+			}
+			return await response.json();
+		} finally {
+			clearTimeout(timeoutId);
+		}
+	}
+	generateAnonymousId() {
+		if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
+		return `anon_${Date.now().toString(36)}${Math.random().toString(36).slice(2, 9)}`;
+	}
+	sleep(ms) {
+		return new Promise((resolve) => setTimeout(resolve, ms));
+	}
+};
+
+//#endregion
+export { HttpServerProvider };
+//# sourceMappingURL=providers-http-server.mjs.map