@reservamos/browser-analytics 1.1.6 → 1.1.7-alpha.1

package/src/util/identifyAttempt.ts

@@ -0,0 +1,139 @@
+import mixpanelService from '@/services/mixpanel';
+import { trackEventError } from '@/track';
+
+type IdentifyStage =
+  | 'readiness'
+  | 'validation'
+  | 'profile'
+  | 'cache'
+  | 'mixpanel'
+  | 'people'
+  | 'fingerprint'
+  | 'datalake';
+type IdentifyReason =
+  | 'failed'
+  | 'timeout'
+  | 'unobserved'
+  | 'unconfirmed'
+  | 'unavailable'
+  | 'invalid_input'
+  | 'http_error';
+
+export type IdentifyReporter = (
+  stage: IdentifyStage,
+  reason: IdentifyReason,
+  httpStatus?: number,
+) => void;
+export interface IdentifyStageContext {
+  isActive: () => boolean;
+  report: IdentifyReporter;
+}
+
+/** Reports only SDK-controlled diagnostics; original errors and inputs never enter telemetry. */
+export function createIdentifyReporter(): IdentifyReporter {
+  const reported = new Set<string>();
+  return (stage, reason, httpStatus) => {
+    const key = `${stage}:${reason}`;
+    if (reported.has(key)) return;
+    reported.add(key);
+    const payload = {
+      stage,
+      reason,
+      ...(httpStatus !== undefined ? { httpStatus } : {}),
+    };
+    try {
+      if (mixpanelService.isReady()) {
+        trackEventError(
+          'Identify',
+          new Error(`Identify ${stage}: ${reason}`),
+          payload,
+        );
+      } else {
+        console.error('Identify diagnostic', payload);
+      }
+    } catch {
+      console.error('Identify diagnostic', payload);
+    }
+  };
+}
+
+/** Waits only for this identify attempt, without changing the shared tracking queue. */
+export function waitForIdentifyReady(
+  report: IdentifyReporter,
+): Promise<boolean> {
+  if (mixpanelService.isReady()) return Promise.resolve(true);
+  return new Promise((resolve) => {
+    let active = true;
+    const finish = (ready: boolean) => {
+      if (!active) return;
+      active = false;
+      clearTimeout(timer);
+      window.removeEventListener('Tracker Ready', onReady);
+      if (!ready) report('readiness', 'timeout');
+      resolve(ready);
+    };
+    const onReady = () => {
+      if (mixpanelService.isReady()) finish(true);
+    };
+    const timer = setTimeout(() => finish(false), 5000);
+    window.addEventListener('Tracker Ready', onReady);
+    onReady();
+  });
+}
+
+/** Closes optional work at its deadline and consumes late fulfillment or rejection. */
+export function waitForIdentifyStage<T>(
+  stage: 'profile' | 'fingerprint',
+  timeout: number,
+  run: (context: IdentifyStageContext) => Promise<T>,
+  report: IdentifyReporter,
+): Promise<T | undefined> {
+  return new Promise((resolve) => {
+    let active = true;
+    const finish = (value?: T) => {
+      if (!active) return;
+      active = false;
+      clearTimeout(timer);
+      resolve(value);
+    };
+    const timer = setTimeout(() => {
+      report(stage, 'timeout');
+      finish();
+    }, timeout);
+    const context: IdentifyStageContext = {
+      isActive: () => active,
+      report: (...args) => {
+        if (active) report(...args);
+      },
+    };
+    void Promise.resolve()
+      .then(() => run(context))
+      .then(
+        (value) => finish(value),
+        () => {
+          if (active) report(stage, 'failed');
+          finish();
+        },
+      );
+  });
+}
+
+/** Observes remote outcomes separately from the public identify promise. */
+export function observeIdentifyResult(
+  stage: 'people' | 'datalake',
+  report: IdentifyReporter,
+  onTimeout?: () => void,
+) {
+  let active = true;
+  const complete = (reason?: IdentifyReason, httpStatus?: number): void => {
+    if (!active) return;
+    active = false;
+    clearTimeout(timer);
+    if (reason) report(stage, reason, httpStatus);
+  };
+  const timer = setTimeout(() => {
+    complete(stage === 'people' ? 'unobserved' : 'timeout');
+    onTimeout?.();
+  }, 5000);
+  return { complete };
+}