@dereekb/dbx-analytics 13.10.2 → 13.10.3

package/fesm2022/dereekb-dbx-analytics.mjs

@@ -53,6 +53,23 @@ var DbxAnalyticsStreamEventType;
      * A generic custom analytics event.
      */
     DbxAnalyticsStreamEventType[DbxAnalyticsStreamEventType["Event"] = 7] = "Event";
+    // Session Replay
+    /**
+     * Request to start session replay recording.
+     */
+    DbxAnalyticsStreamEventType[DbxAnalyticsStreamEventType["StartSessionRecording"] = 8] = "StartSessionRecording";
+    /**
+     * Request to stop session replay recording.
+     */
+    DbxAnalyticsStreamEventType[DbxAnalyticsStreamEventType["StopSessionRecording"] = 9] = "StopSessionRecording";
+    /**
+     * Request to pause an active session replay recording without clearing it.
+     */
+    DbxAnalyticsStreamEventType[DbxAnalyticsStreamEventType["PauseSessionRecording"] = 10] = "PauseSessionRecording";
+    /**
+     * Request to resume a previously paused session replay recording.
+     */
+    DbxAnalyticsStreamEventType[DbxAnalyticsStreamEventType["ResumeSessionRecording"] = 11] = "ResumeSessionRecording";
 })(DbxAnalyticsStreamEventType || (DbxAnalyticsStreamEventType = {}));
 
 /**
@@ -358,6 +375,39 @@ class DbxAnalyticsService {
             name: page
         }, DbxAnalyticsStreamEventType.PageView);
     }
+    /**
+     * Requests that opt-in listeners (e.g. Mixpanel) start session replay recording.
+     *
+     * Forwarded as a {@link DbxAnalyticsStreamEventType.StartSessionRecording} event. Listeners
+     * that don't handle session replay (e.g. Segment) ignore it.
+     */
+    startSessionRecording() {
+        this.sendNextEvent({}, DbxAnalyticsStreamEventType.StartSessionRecording);
+    }
+    /**
+     * Requests that opt-in listeners stop session replay recording.
+     *
+     * Forwarded as a {@link DbxAnalyticsStreamEventType.StopSessionRecording} event.
+     */
+    stopSessionRecording() {
+        this.sendNextEvent({}, DbxAnalyticsStreamEventType.StopSessionRecording);
+    }
+    /**
+     * Requests that opt-in listeners pause active session replay recording without clearing it.
+     *
+     * Forwarded as a {@link DbxAnalyticsStreamEventType.PauseSessionRecording} event.
+     */
+    pauseSessionRecording() {
+        this.sendNextEvent({}, DbxAnalyticsStreamEventType.PauseSessionRecording);
+    }
+    /**
+     * Requests that opt-in listeners resume previously paused session replay recording.
+     *
+     * Forwarded as a {@link DbxAnalyticsStreamEventType.ResumeSessionRecording} event.
+     */
+    resumeSessionRecording() {
+        this.sendNextEvent({}, DbxAnalyticsStreamEventType.ResumeSessionRecording);
+    }
     /**
      * Sends the next event.
      *
@@ -527,6 +577,197 @@ function provideDbxAnalyticsService(config) {
     return makeEnvironmentProviders(providers);
 }
 
+/**
+ * Injection token for optionally preloading the Mixpanel SDK on the page.
+ *
+ * In typical setups Mixpanel is loaded by Segment device mode, so this token is rarely needed.
+ */
+const PRELOAD_MIXPANEL_TOKEN = new InjectionToken('DbxAnalyticsMixpanelApiServicePreload');
+/**
+ * Configuration for the Mixpanel analytics integration.
+ *
+ * Unlike {@link DbxAnalyticsSegmentApiServiceConfig}, this config does not take a write key —
+ * Mixpanel is initialized by Segment device mode. The `active` and `logging` flags exist for
+ * parity with the Segment config and to gate listener behavior.
+ *
+ * @example
+ * ```ts
+ * const config = new DbxAnalyticsMixpanelApiServiceConfig();
+ * config.active = environment.production;
+ * config.logging = !environment.production;
+ * ```
+ */
+class DbxAnalyticsMixpanelApiServiceConfig {
+    logging = true;
+    active = true;
+}
+/**
+ * Service that manages async access to the Mixpanel JS SDK exposed on `window.mixpanel`.
+ *
+ * The Mixpanel SDK is typically loaded by Segment's Mixpanel (Actions) device-mode destination,
+ * so this service waits for `window.mixpanel` to exist using the inherited window-loading polling.
+ * The resolved SDK instance is available via the inherited `service$` observable.
+ *
+ * Provided via {@link provideDbxAnalyticsMixpanelApiService}.
+ *
+ * @example
+ * ```ts
+ * // In app.config.ts
+ * provideDbxAnalyticsMixpanelApiService({
+ *   dbxAnalyticsMixpanelApiServiceConfigFactory: () => {
+ *     const config = new DbxAnalyticsMixpanelApiServiceConfig();
+ *     config.active = environment.production;
+ *     return config;
+ *   }
+ * })
+ * ```
+ */
+class DbxAnalyticsMixpanelApiService extends AbstractAsyncWindowLoadedService {
+    _config = inject(DbxAnalyticsMixpanelApiServiceConfig);
+    static MIXPANEL_API_WINDOW_KEY = 'mixpanel';
+    constructor() {
+        const preload = inject(PRELOAD_MIXPANEL_TOKEN, { optional: true });
+        super(DbxAnalyticsMixpanelApiService.MIXPANEL_API_WINDOW_KEY, undefined, 'Mixpanel', preload);
+    }
+    get config() {
+        return this._config;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: DbxAnalyticsMixpanelApiService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: DbxAnalyticsMixpanelApiService });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: DbxAnalyticsMixpanelApiService, decorators: [{
+            type: Injectable
+        }], ctorParameters: () => [] });
+
+/**
+ * Analytics listener that forwards session-replay control events to the Mixpanel SDK.
+ *
+ * Handles only the four session-replay event types — track/identify/page events are intentionally
+ * not forwarded here because Segment's Mixpanel (Actions) device-mode destination already routes
+ * them to Mixpanel. Forwarding them again would produce duplicate events.
+ *
+ * - {@link DbxAnalyticsStreamEventType.StartSessionRecording} -> `mixpanel.start_session_recording()`
+ * - {@link DbxAnalyticsStreamEventType.StopSessionRecording} -> `mixpanel.stop_session_recording()`
+ * - {@link DbxAnalyticsStreamEventType.PauseSessionRecording} -> `mixpanel.pause_session_recording()`
+ * - {@link DbxAnalyticsStreamEventType.ResumeSessionRecording} -> `mixpanel.resume_session_recording()`
+ *
+ * Events are only sent when the Mixpanel configuration is marked as `active`.
+ * Provided at root level and registered as a listener via {@link DbxAnalyticsServiceConfiguration.listeners}.
+ */
+class DbxAnalyticsMixpanelServiceListener extends AbstractDbxAnalyticsServiceListener {
+    _mixpanelApi = inject(DbxAnalyticsMixpanelApiService);
+    constructor() {
+        super();
+        if (this._mixpanelApi.config.logging) {
+            console.log('MixpanelAnalyticsListenerService: Mixpanel is logging events.');
+        }
+        if (!this._mixpanelApi.config.active) {
+            console.log('MixpanelAnalyticsListenerService: Mixpanel is disabled from sending events to the server.');
+        }
+    }
+    _initializeServiceSubscription() {
+        return combineLatest([this._mixpanelApi.service$, this.analyticsEvents$]).subscribe(([mixpanel, streamEvent]) => {
+            if (this._mixpanelApi.config.logging) {
+                console.log('Mixpanel Listener Logging Event: ', streamEvent);
+            }
+            if (this._mixpanelApi.config.active) {
+                this.handleStreamEvent(mixpanel, streamEvent);
+            }
+        });
+    }
+    /**
+     * Routes a session-replay control event to the corresponding Mixpanel SDK method.
+     *
+     * Non-session-replay events are intentionally ignored — Segment's device-mode integration
+     * already forwards track/identify/page to Mixpanel.
+     *
+     * @param api - The loaded Mixpanel SDK instance
+     * @param streamEvent - The analytics event to process
+     */
+    handleStreamEvent(api, streamEvent) {
+        switch (streamEvent.type) {
+            case DbxAnalyticsStreamEventType.StartSessionRecording:
+                api.start_session_recording();
+                break;
+            case DbxAnalyticsStreamEventType.StopSessionRecording:
+                api.stop_session_recording();
+                break;
+            case DbxAnalyticsStreamEventType.PauseSessionRecording:
+                api.pause_session_recording();
+                break;
+            case DbxAnalyticsStreamEventType.ResumeSessionRecording:
+                api.resume_session_recording();
+                break;
+            default:
+                // All other event types are routed to Mixpanel by Segment's device-mode destination.
+                break;
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: DbxAnalyticsMixpanelServiceListener, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: DbxAnalyticsMixpanelServiceListener, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.10", ngImport: i0, type: DbxAnalyticsMixpanelServiceListener, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }], ctorParameters: () => [] });
+
+/**
+ * Creates Angular environment providers that register {@link DbxAnalyticsMixpanelApiService} for Mixpanel session-replay control.
+ *
+ * Use alongside {@link provideDbxAnalyticsService} to wire Mixpanel as an analytics listener that
+ * handles session-replay start/stop/pause/resume events.
+ *
+ * @param config - Mixpanel-specific configuration
+ * @returns environment providers for Mixpanel analytics
+ *
+ * @example
+ * ```ts
+ * // In app.config.ts
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideDbxAnalyticsMixpanelApiService({
+ *       dbxAnalyticsMixpanelApiServiceConfigFactory: () => {
+ *         const config = new DbxAnalyticsMixpanelApiServiceConfig();
+ *         config.active = environment.production;
+ *         return config;
+ *       }
+ *     }),
+ *     provideDbxAnalyticsService({
+ *       dbxAnalyticsServiceConfigurationFactory: (injector) => ({
+ *         isProduction: environment.production,
+ *         listeners: [
+ *           injector.get(DbxAnalyticsSegmentServiceListener),
+ *           injector.get(DbxAnalyticsMixpanelServiceListener)
+ *         ]
+ *       })
+ *     })
+ *   ]
+ * };
+ * ```
+ */
+function provideDbxAnalyticsMixpanelApiService(config) {
+    const { preloadMixpanelToken, dbxAnalyticsMixpanelApiServiceConfigFactory } = config;
+    const providers = [
+        // configuration
+        {
+            provide: DbxAnalyticsMixpanelApiServiceConfig,
+            useFactory: dbxAnalyticsMixpanelApiServiceConfigFactory,
+            deps: [Injector]
+        },
+        // service
+        DbxAnalyticsMixpanelApiService
+    ];
+    if (preloadMixpanelToken) {
+        providers.push({
+            provide: PRELOAD_MIXPANEL_TOKEN,
+            useValue: preloadMixpanelToken
+        });
+    }
+    return makeEnvironmentProviders(providers);
+}
+
 /**
  * Injection token for optionally preloading the Segment analytics script.
  */
@@ -694,7 +935,11 @@ class DbxAnalyticsSegmentServiceListener extends AbstractDbxAnalyticsServiceList
                 break;
             case DbxAnalyticsStreamEventType.UserIdChange:
             case DbxAnalyticsStreamEventType.UserPropertiesEvent:
-                // These event types are not forwarded to Segment
+            case DbxAnalyticsStreamEventType.StartSessionRecording:
+            case DbxAnalyticsStreamEventType.StopSessionRecording:
+            case DbxAnalyticsStreamEventType.PauseSessionRecording:
+            case DbxAnalyticsStreamEventType.ResumeSessionRecording:
+                // These event types are not forwarded to Segment.
                 break;
         }
     }
@@ -814,5 +1059,5 @@ function provideDbxAnalyticsSegmentApiService(config) {
  * Generated bundle index. Do not edit.
  */
 
-export { AbstractDbxAnalyticsServiceListener, DbxActionAnalyticsDirective, DbxAnalyticsActionModule, DbxAnalyticsEventEmitterService, DbxAnalyticsEventStreamService, DbxAnalyticsSegmentApiService, DbxAnalyticsSegmentApiServiceConfig, DbxAnalyticsSegmentServiceListener, DbxAnalyticsService, DbxAnalyticsServiceConfiguration, DbxAnalyticsServiceListener, DbxAnalyticsStreamEventType, DbxAnalyticsUserSource, PRELOAD_SEGMENT_TOKEN, dbxAnalyticsStreamEventAnalyticsEventWrapper, provideDbxAnalyticsSegmentApiService, provideDbxAnalyticsService };
+export { AbstractDbxAnalyticsServiceListener, DbxActionAnalyticsDirective, DbxAnalyticsActionModule, DbxAnalyticsEventEmitterService, DbxAnalyticsEventStreamService, DbxAnalyticsMixpanelApiService, DbxAnalyticsMixpanelApiServiceConfig, DbxAnalyticsMixpanelServiceListener, DbxAnalyticsSegmentApiService, DbxAnalyticsSegmentApiServiceConfig, DbxAnalyticsSegmentServiceListener, DbxAnalyticsService, DbxAnalyticsServiceConfiguration, DbxAnalyticsServiceListener, DbxAnalyticsStreamEventType, DbxAnalyticsUserSource, PRELOAD_MIXPANEL_TOKEN, PRELOAD_SEGMENT_TOKEN, dbxAnalyticsStreamEventAnalyticsEventWrapper, provideDbxAnalyticsMixpanelApiService, provideDbxAnalyticsSegmentApiService, provideDbxAnalyticsService };
 //# sourceMappingURL=dereekb-dbx-analytics.mjs.map

package/fesm2022/dereekb-dbx-analytics.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"dereekb-dbx-analytics.mjs","sources":["../../../../packages/dbx-analytics/src/lib/analytics/analytics.stream.ts","../../../../packages/dbx-analytics/src/lib/analytics/analytics.service.ts","../../../../packages/dbx-analytics/src/lib/action/analytics.action.directive.ts","../../../../packages/dbx-analytics/src/lib/action/analytics.module.ts","../../../../packages/dbx-analytics/src/lib/analytics/analytics.providers.ts","../../../../packages/dbx-analytics/src/lib/providers/segment/segment.service.ts","../../../../packages/dbx-analytics/src/lib/providers/segment/segment.listener.service.ts","../../../../packages/dbx-analytics/src/lib/providers/segment/segment.providers.ts","../../../../packages/dbx-analytics/src/dereekb-dbx-analytics.ts"],"sourcesContent":["import { type Maybe } from '@dereekb/util';\nimport { type AnalyticsUser, type UserAnalyticsEvent, type AnalyticsUserId } from './analytics';\n\n/**\n * Categorizes the kind of analytics stream event emitted by {@link DbxAnalyticsService}.\n *\n * Listeners use this type to route events to the appropriate analytics provider method\n * (e.g., Segment `track()`, `identify()`, `page()`).\n */\nexport enum DbxAnalyticsStreamEventType {\n  /**\n   * A page/screen view event, typically sent on route transitions.\n   */\n  PageView,\n  /**\n   * Emitted any time the user value changes, including when transitioning from defined to undefined.\n   *\n   * Used by listeners to update the identified user in analytics providers.\n   */\n  UserChange,\n  /**\n   * Emitted only when the user's unique ID changes, filtering out property-only updates.\n   *\n   * Useful for triggering identity calls without redundant updates when only traits change.\n   */\n  UserIdChange,\n\n  // User Events\n  /**\n   * A new user registration event.\n   */\n  NewUserEvent,\n  /**\n   * A returning user login event.\n   */\n  UserLoginEvent,\n  /**\n   * A user logout event.\n   */\n  UserLogoutEvent,\n  /**\n   * An update to user profile properties/traits.\n   */\n  UserPropertiesEvent,\n\n  // Events\n  /**\n   * A generic custom analytics event.\n   */\n  Event\n}\n\n/**\n * Represents a single event in the analytics stream, combining the event type, payload, and user context.\n *\n * Emitted by {@link DbxAnalyticsService} and consumed by {@link DbxAnalyticsServiceListener} implementations\n * (e.g., {@link DbxAnalyticsSegmentServiceListener}) to forward events to external analytics providers.\n *\n * @example\n * ```ts\n * // Subscribe to the analytics event stream\n * analyticsService.events$.subscribe((streamEvent: DbxAnalyticsStreamEvent) => {\n *   console.log(streamEvent.type, streamEvent.event?.name, streamEvent.userId);\n * });\n * ```\n */\nexport interface DbxAnalyticsStreamEvent {\n  readonly type: DbxAnalyticsStreamEventType;\n  readonly user?: Maybe<AnalyticsUser>;\n  readonly event?: UserAnalyticsEvent;\n  readonly userId?: AnalyticsUserId;\n}\n","import { type Observable, Subject, BehaviorSubject, of, type Subscription, first, shareReplay, switchMap, distinctUntilChanged } from 'rxjs';\nimport { Injectable, inject } from '@angular/core';\nimport { SubscriptionObject, filterMaybe } from '@dereekb/rxjs';\nimport { type AnalyticsEvent, type AnalyticsEventData, type AnalyticsEventName, type AnalyticsUser, type NewUserAnalyticsEventData, type UserAnalyticsEvent } from './analytics';\nimport { type DbxAnalyticsStreamEvent, DbxAnalyticsStreamEventType } from './analytics.stream';\nimport { type Maybe, type Destroyable, safeCompareEquality } from '@dereekb/util';\n\n/**\n * Abstract emitter interface for sending analytics events.\n *\n * Implemented by {@link DbxAnalyticsService} as the primary concrete implementation.\n * Components and services use this to fire analytics events without coupling to a specific provider.\n *\n * @example\n * ```ts\n * // Inject and send a custom event\n * const emitter = inject(DbxAnalyticsEventEmitterService);\n * emitter.sendEventData('Button Clicked', { buttonId: 'save' });\n * ```\n */\nexport abstract class DbxAnalyticsEventEmitterService {\n  abstract sendNewUserEvent(user: AnalyticsUser, data: NewUserAnalyticsEventData): void;\n  abstract sendUserLoginEvent(user: AnalyticsUser, data?: AnalyticsEventData): void;\n  abstract sendUserLogoutEvent(data?: AnalyticsEventData): void;\n  abstract sendUserPropertiesEvent(user: AnalyticsUser, data?: AnalyticsEventData): void;\n  /**\n   * @deprecated When sending an event with no data, use {@link sendEventType} instead.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  abstract sendEventData(name: AnalyticsEventName): void;\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  abstract sendEventData(name: AnalyticsEventName, data: AnalyticsEventData): void;\n  abstract sendEvent(event: AnalyticsEvent): void;\n  abstract sendPageView(page?: string): void;\n}\n\n/**\n * Abstract interface exposing the analytics event stream as an observable.\n *\n * Implemented by {@link DbxAnalyticsService}. Listeners subscribe to `events$` to forward events to external providers.\n */\nexport abstract class DbxAnalyticsEventStreamService {\n  abstract readonly events$: Observable<DbxAnalyticsStreamEvent>;\n}\n\n/**\n * Abstract source for the current analytics user identity.\n *\n * Provide an implementation to automatically associate a user with all emitted analytics events.\n * Typically backed by the auth system (e.g., {@link DbxFirebaseAnalyticsUserSource}).\n *\n * @example\n * ```ts\n * // Provide a static user source\n * const userSource: DbxAnalyticsUserSource = {\n *   analyticsUser$: of({ user: 'uid_abc123', properties: { role: 'admin' } })\n * };\n * ```\n */\nexport abstract class DbxAnalyticsUserSource {\n  abstract readonly analyticsUser$: Observable<Maybe<AnalyticsUser>>;\n}\n\n/**\n * Abstract listener that receives analytics events from {@link DbxAnalyticsService}.\n *\n * Implement this to forward events to an external analytics provider (e.g., Segment, Mixpanel).\n * Register listeners via {@link DbxAnalyticsServiceConfiguration.listeners}.\n */\nexport abstract class DbxAnalyticsServiceListener {\n  public abstract listenToService(service: DbxAnalyticsService): void;\n}\n\n/**\n * Base class for analytics service listeners that manages subscription lifecycle and provides\n * reactive access to the analytics service and its event stream.\n *\n * Subclasses implement {@link _initializeServiceSubscription} to subscribe to events and forward them\n * to an external analytics provider.\n *\n * @example\n * ```ts\n * class MyAnalyticsListener extends AbstractDbxAnalyticsServiceListener {\n *   protected _initializeServiceSubscription(): Subscription | false {\n *     return this.analyticsEvents$.subscribe((event) => {\n *       console.log('Event:', event.type, event.event?.name);\n *     });\n *   }\n * }\n * ```\n */\nexport abstract class AbstractDbxAnalyticsServiceListener implements DbxAnalyticsServiceListener, Destroyable {\n  private _sub = new SubscriptionObject();\n  protected _analytics = new BehaviorSubject<Maybe<DbxAnalyticsService>>(undefined);\n\n  readonly analytics$ = this._analytics.pipe(filterMaybe(), shareReplay(1));\n  readonly analyticsEvents$ = this.analytics$.pipe(\n    switchMap((x) => x.events$),\n    shareReplay(1)\n  );\n\n  // MARK: AnalyticsServiceListener\n  listenToService(service: DbxAnalyticsService): void {\n    this._analytics.next(service);\n    const sub = this._initializeServiceSubscription();\n\n    if (sub !== false) {\n      this._sub.subscription = sub;\n    }\n  }\n\n  protected abstract _initializeServiceSubscription(): Subscription | false;\n\n  // MARK: Destroy\n  destroy(): void {\n    this._analytics.complete();\n    this._sub.destroy();\n  }\n}\n\n/**\n * Configuration for {@link DbxAnalyticsService}, controlling which listeners receive events,\n * whether analytics runs in production mode, and optionally providing a user source.\n *\n * In non-production mode, listeners are not initialized and all events are logged to the console instead.\n * Provide via {@link provideDbxAnalyticsService} using a factory function.\n *\n * @example\n * ```ts\n * const config: DbxAnalyticsServiceConfiguration = {\n *   isProduction: environment.production,\n *   logEvents: !environment.production,\n *   listeners: [segmentListener],\n *   userSource: firebaseAnalyticsUserSource\n * };\n * ```\n */\nexport abstract class DbxAnalyticsServiceConfiguration {\n  readonly listeners: DbxAnalyticsServiceListener[] = [];\n  readonly isProduction?: boolean;\n  readonly logEvents?: boolean;\n  readonly userSource?: DbxAnalyticsUserSource;\n}\n\n/**\n * A fully resolved analytics stream event that includes the event payload, type, user context, and extracted user ID.\n *\n * Created by {@link dbxAnalyticsStreamEventAnalyticsEventWrapper} and emitted through the analytics event stream.\n */\nexport interface DbxAnalyticsStreamEventAnalyticsEventWrapper extends DbxAnalyticsStreamEvent {\n  readonly event: UserAnalyticsEvent;\n  readonly type: DbxAnalyticsStreamEventType;\n  readonly user: Maybe<AnalyticsUser>;\n  readonly userId: string | undefined;\n}\n\n/**\n * Wraps a {@link UserAnalyticsEvent} into a {@link DbxAnalyticsStreamEventAnalyticsEventWrapper},\n * extracting the user ID for convenient access by listeners.\n *\n * @param event - the analytics event with optional user context\n * @param type - the stream event type classification; defaults to `Event`\n * @returns a wrapper combining the event, type, user, and extracted userId\n *\n * @example\n * ```ts\n * const wrapper = dbxAnalyticsStreamEventAnalyticsEventWrapper(\n *   { name: 'Button Clicked', user: { user: 'uid_123' } },\n *   DbxAnalyticsStreamEventType.Event\n * );\n * // wrapper.userId === 'uid_123'\n * ```\n */\nexport function dbxAnalyticsStreamEventAnalyticsEventWrapper(event: UserAnalyticsEvent, type: DbxAnalyticsStreamEventType = DbxAnalyticsStreamEventType.Event) {\n  const { user } = event;\n  const userId = user ? user.user : undefined;\n\n  return {\n    event,\n    type,\n    user,\n    userId\n  };\n}\n\n/**\n * Central analytics service that emits typed analytics events for consumption by registered listeners.\n *\n * Acts as both the event emitter (components call methods like {@link sendEventData}, {@link sendPageView})\n * and the event stream source (listeners subscribe to {@link events$}).\n *\n * In production mode, registered {@link DbxAnalyticsServiceListener} instances (e.g., Segment) receive all events.\n * In non-production mode, events are logged to the console for debugging.\n *\n * Provided via {@link provideDbxAnalyticsService} with a {@link DbxAnalyticsServiceConfiguration} factory.\n *\n * @example\n * ```ts\n * // Send a custom event from a component\n * const analytics = inject(DbxAnalyticsService);\n * analytics.sendEventData('Interview Started', { candidateId: 'abc123' });\n *\n * // Send a page view on route transitions\n * transitionService.onSuccess({}, () => {\n *   analytics.sendPageView();\n * });\n * ```\n */\n@Injectable()\nexport class DbxAnalyticsService implements DbxAnalyticsEventStreamService, DbxAnalyticsEventEmitterService, Destroyable {\n  private readonly _config = inject(DbxAnalyticsServiceConfiguration);\n\n  // TODO: Make these configurable.\n  static readonly USER_REGISTRATION_EVENT_NAME = 'User Registered';\n  static readonly USER_LOGIN_EVENT_NAME = 'User Login';\n  static readonly USER_LOGOUT_EVENT_NAME = 'User Logout';\n  static readonly USER_PROPERTIES_EVENT_NAME = 'User Properties';\n\n  private _subject = new Subject<DbxAnalyticsStreamEvent>();\n  readonly events$ = this._subject.asObservable();\n\n  private _userSource = new BehaviorSubject<Maybe<DbxAnalyticsUserSource>>(undefined);\n\n  readonly user$ = this._userSource.pipe(\n    switchMap((x) => (x ? x.analyticsUser$ : of(undefined))),\n    shareReplay(1)\n  );\n\n  private _userSourceSub = new SubscriptionObject();\n  private _userIdEventSub = new SubscriptionObject();\n  private _loggerSub = new SubscriptionObject();\n\n  constructor() {\n    this._init();\n    let userSource: Maybe<DbxAnalyticsUserSource> = inject(DbxAnalyticsUserSource, { optional: true });\n    userSource = userSource || this._config.userSource;\n\n    if (userSource) {\n      this.setUserSource(userSource);\n    }\n  }\n\n  // MARK: Source\n  /**\n   * Sets the analytics user directly, overriding any configured {@link DbxAnalyticsUserSource}.\n   *\n   * Pass `undefined` to clear the current user (e.g., on logout).\n   *\n   * @param user - the user to identify, or undefined to clear\n   */\n  public setUser(user: Maybe<AnalyticsUser>): void {\n    let source: Maybe<DbxAnalyticsUserSource>;\n\n    if (user) {\n      source = { analyticsUser$: of(user) };\n    }\n\n    this._userSource.next(source);\n\n    if (this._userSource.value) {\n      console.warn('DbxAnalyticsService has a userSource that is set. Source is now overridden by setUser() value.');\n    }\n  }\n\n  /**\n   * Sets the reactive user source that automatically updates the analytics user as auth state changes.\n   *\n   * @param source - the user source providing an observable of the current analytics user\n   */\n  public setUserSource(source: DbxAnalyticsUserSource): void {\n    this._userSource.next(source);\n  }\n\n  // MARK: DbxAnalyticsEventEmitterService\n  /**\n   * Emits a new user registration event, typically sent once after account creation.\n   *\n   * @param user - the newly registered user\n   * @param data - registration-specific data including the signup method\n   */\n  public sendNewUserEvent(user: AnalyticsUser, data: NewUserAnalyticsEventData): void {\n    this.sendNextEvent(\n      {\n        name: DbxAnalyticsService.USER_REGISTRATION_EVENT_NAME,\n        data\n      },\n      DbxAnalyticsStreamEventType.NewUserEvent,\n      user\n    );\n  }\n\n  /**\n   * Emits a user login event, identifying the user in analytics providers.\n   *\n   * @param user - the user who logged in\n   * @param data - optional additional event data\n   */\n  public sendUserLoginEvent(user: AnalyticsUser, data?: AnalyticsEventData): void {\n    this.sendNextEvent(\n      {\n        name: DbxAnalyticsService.USER_LOGIN_EVENT_NAME,\n        data\n      },\n      DbxAnalyticsStreamEventType.UserLoginEvent,\n      user\n    );\n  }\n\n  /**\n   * Emits a user logout event and optionally clears the current analytics user.\n   *\n   * @param data - optional additional event data\n   * @param clearUser - whether to reset the analytics user identity; defaults to `true`\n   */\n  public sendUserLogoutEvent(data?: AnalyticsEventData, clearUser = true): void {\n    this.sendNextEvent(\n      {\n        name: DbxAnalyticsService.USER_LOGOUT_EVENT_NAME,\n        data\n      },\n      DbxAnalyticsStreamEventType.UserLogoutEvent\n    );\n\n    if (clearUser) {\n      this.setUser(undefined);\n    }\n  }\n\n  /**\n   * Emits a user properties update event, used to sync user traits to analytics providers.\n   *\n   * @param user - the user whose properties are being updated\n   * @param data - optional additional event data\n   */\n  public sendUserPropertiesEvent(user: AnalyticsUser, data?: AnalyticsEventData): void {\n    this.sendNextEvent(\n      {\n        name: DbxAnalyticsService.USER_PROPERTIES_EVENT_NAME,\n        data\n      },\n      DbxAnalyticsStreamEventType.UserPropertiesEvent,\n      user\n    );\n  }\n\n  /**\n   * @deprecated When sending an event with no data, use {@link sendEventType} instead.\n   */\n  public sendEventData(name: AnalyticsEventName): void;\n  /**\n   * Sends a named analytics event with a data payload.\n   *\n   * This is the primary method for tracking custom events with associated properties.\n   *\n   * @param name - the event name (e.g., `'Interview Ended'`)\n   * @param data - key-value data attached to the event\n   *\n   * @example\n   * ```ts\n   * analytics.sendEventData('Interview Ended', {\n   *   seconds: 120,\n   *   endedDueToTime: 'true'\n   * });\n   * ```\n   */\n  public sendEventData(name: AnalyticsEventName, data: AnalyticsEventData): void;\n  public sendEventData(name: AnalyticsEventName, data?: AnalyticsEventData): void {\n    return this.sendEvent({\n      name,\n      data\n    });\n  }\n\n  /**\n   * Sends a named event with no additional data, useful for simple occurrence tracking.\n   *\n   * @param eventType - the event name to track\n   *\n   * @example\n   * ```ts\n   * analytics.sendEventType('Finish Account Setup');\n   * ```\n   */\n  public sendEventType(eventType: AnalyticsEventName): void {\n    this.sendNextEvent(\n      {\n        name: eventType\n      },\n      DbxAnalyticsStreamEventType.Event\n    );\n  }\n\n  /**\n   * Sends a fully constructed analytics event object.\n   *\n   * @param event - the event containing name, optional value, and data\n   */\n  public sendEvent(event: AnalyticsEvent): void {\n    this.sendNextEvent(event, DbxAnalyticsStreamEventType.Event);\n  }\n\n  /**\n   * Sends a page view event, typically called on successful route transitions.\n   *\n   * @param page - optional page name/path override; if omitted, the provider determines the current page\n   *\n   * @example\n   * ```ts\n   * // In a router config function\n   * transitionService.onSuccess({}, () => {\n   *   analyticsService.sendPageView();\n   * });\n   * ```\n   */\n  public sendPageView(page?: string): void {\n    this.sendNextEvent(\n      {\n        name: page\n      },\n      DbxAnalyticsStreamEventType.PageView\n    );\n  }\n\n  /**\n   * Sends the next event.\n   *\n   * @param event\n   * @param type\n   * @param userOverride Uses this user if set as null or an override value. If undefined the current analytics user is used.\n   */\n  protected sendNextEvent(event: AnalyticsEvent = {}, type: DbxAnalyticsStreamEventType, userOverride?: Maybe<AnalyticsUser>): void {\n    this.user$.pipe(first()).subscribe((analyticsUser) => {\n      const user: Maybe<AnalyticsUser> = userOverride !== undefined ? userOverride : analyticsUser;\n      const analyticsEvent: UserAnalyticsEvent = { ...event, user };\n      this.nextEvent(analyticsEvent, type);\n    });\n  }\n\n  protected nextEvent(event: UserAnalyticsEvent, type: DbxAnalyticsStreamEventType): void {\n    const wrapper = dbxAnalyticsStreamEventAnalyticsEventWrapper(event, type);\n    this._subject.next(wrapper);\n  }\n\n  // MARK: Internal\n  private _init(): void {\n    if (this._config.isProduction) {\n      // Initialize listeners.\n      this._config.listeners.forEach((listener) => {\n        listener.listenToService(this);\n      });\n    } else {\n      console.warn('AnalyticsService: Analytics not in production mode. All analytics events are ignored.');\n    }\n\n    if (this._config.logEvents || !this._config.isProduction) {\n      console.log('AnalyticsService: Log analytics events enabled.');\n\n      // Create a new subscription\n      this._loggerSub.subscription = this._subject.subscribe((x) => {\n        console.log(`AnalyticsService: Analytics Event - ${DbxAnalyticsStreamEventType[x.type]} | User: ${x.userId} | Data: ${JSON.stringify(x.event)}.`);\n      });\n    }\n\n    this._userSourceSub.subscription = this.user$.subscribe((user) => {\n      this.sendNextEvent({}, DbxAnalyticsStreamEventType.UserChange, user ?? null);\n    });\n\n    this._userIdEventSub.subscription = this.user$.pipe(distinctUntilChanged((a, b) => safeCompareEquality(a, b, (x, y) => x.user === y.user))).subscribe((user) => {\n      this.sendNextEvent({}, DbxAnalyticsStreamEventType.UserIdChange, user ?? null);\n    });\n  }\n\n  destroy() {\n    this._subject.complete();\n    this._userSource.complete();\n    this._userSourceSub.destroy();\n    this._userIdEventSub.destroy();\n    this._loggerSub.destroy();\n  }\n}\n","import { filterMaybe } from '@dereekb/rxjs';\nimport { switchMap, tap, shareReplay, merge, type Observable, of } from 'rxjs';\nimport { Directive, inject, input } from '@angular/core';\nimport { DbxActionContextStoreSourceInstance, cleanSubscriptionWithLockSet } from '@dereekb/dbx-core';\nimport { DbxAnalyticsService } from '../analytics/analytics.service';\nimport { type Maybe, type ReadableError } from '@dereekb/util';\nimport { toObservable } from '@angular/core/rxjs-interop';\n\n/**\n * Configuration for {@link DbxActionAnalyticsDirective} that maps action lifecycle events to analytics calls.\n *\n * Each callback receives the {@link DbxAnalyticsService} and relevant action data, allowing you to\n * send targeted analytics events at each stage of an action's lifecycle (trigger, ready, success, error).\n *\n * @example\n * ```ts\n * // In a component, define analytics config for a form submit action\n * readonly submitAnalytics: DbxActionAnalyticsConfig<MyFormValue, MyResult> = {\n *   onReady: (service, value) => {\n *     service.sendEventData('Form Submitted', { formType: 'onboard' });\n *   },\n *   onSuccess: (service, result, value) => {\n *     service.sendEventType('Onboarding Complete');\n *   },\n *   onError: (service, error) => {\n *     service.sendEventData('Form Submit Failed', { code: error?.code ?? 'unknown' });\n *   }\n * };\n *\n * // In the template\n * // <button dbxAction [dbxActionAnalytics]=\"submitAnalytics\">Submit</button>\n * ```\n */\nexport interface DbxActionAnalyticsConfig<T = unknown, O = unknown> {\n  /**\n   * Called when the action is triggered (button pressed).\n   */\n  readonly onTriggered?: (service: DbxAnalyticsService) => void;\n  /**\n   * Called when the action value is ready and about to be processed.\n   */\n  readonly onReady?: (service: DbxAnalyticsService, value: T) => void;\n  /**\n   * Called when the action completes successfully.\n   */\n  readonly onSuccess?: (service: DbxAnalyticsService, result: Maybe<O>, value: T) => void;\n  /**\n   * Called when the action encounters an error.\n   */\n  readonly onError?: (service: DbxAnalyticsService, error: Maybe<ReadableError>) => void;\n}\n\n/**\n * Standalone directive that listens to a host {@link DbxActionDirective} and fires analytics events\n * based on the action's lifecycle (triggered, ready, success, error).\n *\n * Attach to any element that has a `dbxAction` directive and pass a {@link DbxActionAnalyticsConfig}\n * to define which events to send at each lifecycle stage.\n *\n * @example\n * ```html\n * <button dbxAction\n *   [dbxActionHandler]=\"handleSave\"\n *   [dbxActionAnalytics]=\"saveAnalytics\">\n *   Save\n * </button>\n * ```\n */\n@Directive({\n  selector: '[dbxActionAnalytics]',\n  standalone: true\n})\nexport class DbxActionAnalyticsDirective<T, O> {\n  readonly source = inject(DbxActionContextStoreSourceInstance<T, O>, { host: true });\n  readonly analyticsService = inject(DbxAnalyticsService);\n\n  readonly config = input<Maybe<DbxActionAnalyticsConfig<T, O>>>(undefined, { alias: 'dbxActionAnalytics' });\n  readonly config$ = toObservable(this.config).pipe(filterMaybe(), shareReplay(1));\n\n  constructor() {\n    cleanSubscriptionWithLockSet({\n      lockSet: this.source.lockSet,\n      sub: this.config$\n        .pipe(\n          switchMap(({ onTriggered, onReady, onSuccess, onError }) => {\n            const triggerObs: Observable<unknown>[] = [];\n\n            if (onTriggered) {\n              triggerObs.push(this.source.triggered$.pipe(tap(() => onTriggered(this.analyticsService))));\n            }\n\n            if (onReady) {\n              triggerObs.push(this.source.valueReady$.pipe(tap((value) => onReady(this.analyticsService, value))));\n            }\n\n            if (onSuccess) {\n              triggerObs.push(this.source.successPair$.pipe(tap(({ result, value }) => onSuccess(this.analyticsService, result, value))));\n            }\n\n            if (onError) {\n              triggerObs.push(\n                this.source.error$.pipe(\n                  filterMaybe(),\n                  tap((error) => onError(this.analyticsService, error))\n                )\n              );\n            }\n\n            return triggerObs.length ? merge(...triggerObs) : of();\n          })\n        )\n        .subscribe()\n    });\n  }\n}\n","import { NgModule } from '@angular/core';\nimport { DbxActionAnalyticsDirective } from './analytics.action.directive';\n\n/**\n * @deprecated The exported DbxActionAnalyticsDirective is now a standalone component. Import that instead.\n */\n@NgModule({\n  imports: [DbxActionAnalyticsDirective],\n  exports: [DbxActionAnalyticsDirective]\n})\nexport class DbxAnalyticsActionModule {}\n","import { type EnvironmentProviders, Injector, type Provider, makeEnvironmentProviders } from '@angular/core';\nimport { DbxAnalyticsServiceConfiguration, DbxAnalyticsService } from './analytics.service';\n\n/**\n * Factory function that creates a {@link DbxAnalyticsServiceConfiguration} using the Angular injector.\n *\n * Used by {@link provideDbxAnalyticsService} to defer configuration resolution to runtime.\n */\nexport type DbxAnalyticsServiceConfigurationFactory = (injector: Injector) => DbxAnalyticsServiceConfiguration;\n\n/**\n * Configuration for {@link provideDbxAnalyticsService}.\n */\nexport interface ProvideDbxAnalyticsConfig {\n  readonly dbxAnalyticsServiceConfigurationFactory: DbxAnalyticsServiceConfigurationFactory;\n}\n\n/**\n * Creates Angular environment providers that register {@link DbxAnalyticsService} and its configuration.\n *\n * Call this in your application's `providers` array to set up analytics with a custom configuration factory\n * that resolves listeners, user sources, and environment flags at runtime.\n *\n * @param config - contains the factory function that produces a {@link DbxAnalyticsServiceConfiguration}\n * @returns environment providers for the analytics service\n *\n * @example\n * ```ts\n * // In app.config.ts\n * export const appConfig: ApplicationConfig = {\n *   providers: [\n *     provideDbxAnalyticsService({\n *       dbxAnalyticsServiceConfigurationFactory: (injector: Injector) => ({\n *         isProduction: environment.production,\n *         logEvents: !environment.production,\n *         listeners: [injector.get(DbxAnalyticsSegmentServiceListener)],\n *         userSource: injector.get(DbxFirebaseAnalyticsUserSource)\n *       })\n *     })\n *   ]\n * };\n * ```\n */\nexport function provideDbxAnalyticsService(config: ProvideDbxAnalyticsConfig): EnvironmentProviders {\n  const { dbxAnalyticsServiceConfigurationFactory } = config;\n\n  const providers: Provider[] = [\n    // configuration\n    {\n      provide: DbxAnalyticsServiceConfiguration,\n      useFactory: dbxAnalyticsServiceConfigurationFactory,\n      deps: [Injector]\n    },\n    // service\n    DbxAnalyticsService\n  ];\n\n  return makeEnvironmentProviders(providers);\n}\n","import { Injectable, InjectionToken, inject } from '@angular/core';\nimport { AbstractAsyncWindowLoadedService } from '@dereekb/browser';\nimport { poll } from '@dereekb/util';\n\n/**\n * Injection token for optionally preloading the Segment analytics script.\n */\nexport const PRELOAD_SEGMENT_TOKEN = new InjectionToken<string>('DbxAnalyticsSegmentApiServicePreload');\n\n/**\n * Configuration for the Segment analytics integration.\n *\n * @example\n * ```ts\n * const config = new DbxAnalyticsSegmentApiServiceConfig('your-segment-write-key');\n * config.active = environment.production;\n * config.logging = !environment.production;\n * ```\n */\nexport class DbxAnalyticsSegmentApiServiceConfig {\n  writeKey: string;\n  logging = true;\n  active = true;\n  constructor(writeKey: string) {\n    this.writeKey = writeKey;\n  }\n}\n\n/**\n * Extended Segment analytics type that includes the `invoked` flag set after the snippet initializes.\n */\ntype SegmentAnalyticsInvoked = SegmentAnalytics.AnalyticsJS & { invoked?: boolean };\n\n/**\n * Service that manages the async loading and initialization of the Segment analytics SDK from `window.analytics`.\n *\n * Polls for the Segment snippet to be invoked, then calls `analytics.load()` with the configured write key.\n * Once Segment reports ready, the resolved SDK instance is available via the inherited `service$` observable.\n *\n * Requires the Segment analytics snippet to be included in `index.html`.\n *\n * Provided via {@link provideDbxAnalyticsSegmentApiService}.\n *\n * @example\n * ```ts\n * // In app.config.ts\n * provideDbxAnalyticsSegmentApiService({\n *   dbxAnalyticsSegmentApiServiceConfigFactory: (injector) => {\n *     const config = new DbxAnalyticsSegmentApiServiceConfig(environment.analytics.segment);\n *     config.active = environment.production;\n *     return config;\n *   }\n * })\n * ```\n */\n@Injectable()\nexport class DbxAnalyticsSegmentApiService extends AbstractAsyncWindowLoadedService<SegmentAnalytics.AnalyticsJS> {\n  private readonly _config = inject(DbxAnalyticsSegmentApiServiceConfig);\n\n  static readonly SEGMENT_API_WINDOW_KEY = 'analytics';\n  static readonly SEGMENT_READY_KEY = 'SegmentReady';\n\n  constructor() {\n    const preload = inject(PRELOAD_SEGMENT_TOKEN, { optional: true });\n    super(DbxAnalyticsSegmentApiService.SEGMENT_API_WINDOW_KEY, undefined, 'Segment', preload);\n  }\n\n  get config(): DbxAnalyticsSegmentApiServiceConfig {\n    return this._config;\n  }\n\n  protected override _prepareCompleteLoadingService(): Promise<void> {\n    return poll({\n      // poll until analytics.invoked is true.\n      check: () => Boolean((window.analytics as SegmentAnalyticsInvoked).invoked),\n      timesToGiveup: 100\n    });\n  }\n\n  protected override _initService(service: SegmentAnalytics.AnalyticsJS): Promise<SegmentAnalytics.AnalyticsJS> {\n    return new Promise((resolve, reject) => {\n      try {\n        service.load(this._config.writeKey); // Initialize Segment\n\n        // Wait for the service to ready itself.\n        service.ready(() => {\n          // Segment changes itself or rather the target, and the previous initial target is ignored after.\n          const segment: SegmentAnalytics.AnalyticsJS = window[DbxAnalyticsSegmentApiService.SEGMENT_API_WINDOW_KEY];\n          resolve(segment);\n        });\n      } catch (e) {\n        console.log('Failed to init segment: ' + e);\n        reject(e);\n      }\n    });\n  }\n}\n","import { Injectable, inject } from '@angular/core';\nimport { type Maybe } from '@dereekb/util';\nimport { combineLatest } from 'rxjs';\nimport { AbstractDbxAnalyticsServiceListener, type DbxAnalyticsStreamEvent, DbxAnalyticsStreamEventType, type AnalyticsUser } from '../../analytics';\nimport { DbxAnalyticsSegmentApiService } from './segment.service';\n\n/**\n * Analytics listener that forwards {@link DbxAnalyticsStreamEvent} events to the Segment SDK.\n *\n * Automatically maps event types to the appropriate Segment methods:\n * - {@link DbxAnalyticsStreamEventType.Event} / {@link DbxAnalyticsStreamEventType.UserLoginEvent} -> `track()`\n * - {@link DbxAnalyticsStreamEventType.UserChange} / {@link DbxAnalyticsStreamEventType.NewUserEvent} -> `identify()`\n * - {@link DbxAnalyticsStreamEventType.UserLogoutEvent} -> `reset()`\n * - {@link DbxAnalyticsStreamEventType.PageView} -> `page()`\n *\n * Events are only sent when the Segment configuration is marked as `active`.\n * Provided at root level and registered as a listener via {@link DbxAnalyticsServiceConfiguration.listeners}.\n *\n * @example\n * ```ts\n * // Register in analytics configuration factory\n * function analyticsConfigFactory(injector: Injector): DbxAnalyticsServiceConfiguration {\n *   const segmentListener = injector.get(DbxAnalyticsSegmentServiceListener);\n *   return {\n *     isProduction: true,\n *     listeners: [segmentListener]\n *   };\n * }\n * ```\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class DbxAnalyticsSegmentServiceListener extends AbstractDbxAnalyticsServiceListener {\n  private readonly _segmentApi = inject(DbxAnalyticsSegmentApiService);\n\n  constructor() {\n    super();\n\n    if (this._segmentApi.config.logging) {\n      console.log('SegmentAnalyticsListenerService: Segment is logging events.');\n    }\n\n    if (!this._segmentApi.config.active) {\n      console.log('SegmentAnalyticsListenerService: Segment is disabled from sending events to the server.');\n    }\n  }\n\n  /**\n   * Subscribes to the Segment API service and analytics event stream, forwarding events to the Segment SDK.\n   *\n   * Events are only sent when the Segment configuration is marked as active.\n   *\n   * @returns subscription to the combined Segment API and analytics event stream\n   */\n  protected _initializeServiceSubscription() {\n    return combineLatest([this._segmentApi.service$, this.analyticsEvents$]).subscribe(([segment, streamEvent]: [SegmentAnalytics.AnalyticsJS, DbxAnalyticsStreamEvent]) => {\n      if (this._segmentApi.config.logging) {\n        console.log('Segment Listener Logging Event: ', streamEvent);\n      }\n\n      if (this._segmentApi.config.active) {\n        this.handleStreamEvent(segment, streamEvent);\n      }\n    });\n  }\n\n  /**\n   * Routes an analytics stream event to the appropriate Segment API method based on event type.\n   *\n   * @param api - The Segment analytics SDK instance\n   * @param streamEvent - The analytics event to process\n   */\n  protected handleStreamEvent(api: SegmentAnalytics.AnalyticsJS, streamEvent: DbxAnalyticsStreamEvent): void {\n    switch (streamEvent.type) {\n      case DbxAnalyticsStreamEventType.NewUserEvent:\n        this.updateWithNewUserEvent(api, streamEvent);\n        break;\n      case DbxAnalyticsStreamEventType.UserLoginEvent:\n        this.changeUser(api, streamEvent.user);\n        this.updateWithEvent(api, streamEvent);\n        break;\n      case DbxAnalyticsStreamEventType.Event:\n        this.updateWithEvent(api, streamEvent);\n        break;\n      case DbxAnalyticsStreamEventType.UserLogoutEvent:\n        this.changeUser(api, undefined);\n        break;\n      case DbxAnalyticsStreamEventType.PageView:\n        api.page();\n        break;\n      case DbxAnalyticsStreamEventType.UserChange:\n        this.changeUser(api, streamEvent.user);\n        break;\n      case DbxAnalyticsStreamEventType.UserIdChange:\n      case DbxAnalyticsStreamEventType.UserPropertiesEvent:\n        // These event types are not forwarded to Segment\n        break;\n    }\n  }\n\n  /**\n   * Handles a new user registration event by identifying the user in Segment.\n   *\n   * @param api - The Segment analytics SDK instance\n   * @param streamEvent - The event containing the new user data\n   */\n  protected updateWithNewUserEvent(api: SegmentAnalytics.AnalyticsJS, streamEvent: DbxAnalyticsStreamEvent): void {\n    this.changeUser(api, streamEvent.user);\n  }\n\n  /**\n   * Sends a track event to Segment with the event name, value, and additional data properties.\n   *\n   * @param api - The Segment analytics SDK instance\n   * @param streamEvent - The analytics event containing name, value, and data\n   * @param name - Optional override for the event name\n   */\n  protected updateWithEvent(api: SegmentAnalytics.AnalyticsJS, streamEvent: DbxAnalyticsStreamEvent, name?: string): void {\n    const event = streamEvent.event;\n    const eventName = name || event?.name;\n\n    if (eventName) {\n      const value = event?.value;\n      const data = event?.data;\n\n      api.track(\n        eventName,\n        {\n          ...(value != null\n            ? {\n                value\n              }\n            : undefined),\n          ...data\n        },\n        {},\n        () => {\n          if (this._segmentApi.config.logging) {\n            console.log('Segment track success.');\n          }\n        }\n      );\n    }\n  }\n\n  private changeUser(api: SegmentAnalytics.AnalyticsJS, user: Maybe<AnalyticsUser>): void {\n    if (user?.user) {\n      api.identify(\n        user.user,\n        {\n          ...user.properties\n        },\n        {},\n        () => {\n          if (this._segmentApi.config.logging) {\n            console.log('Segment identify success.');\n          }\n        }\n      );\n    } else {\n      api.reset();\n    }\n  }\n}\n","import { type EnvironmentProviders, Injector, makeEnvironmentProviders, type Provider } from '@angular/core';\nimport { DbxAnalyticsSegmentApiService, DbxAnalyticsSegmentApiServiceConfig, PRELOAD_SEGMENT_TOKEN } from './segment.service';\n\n/**\n * Factory function that creates a {@link DbxAnalyticsSegmentApiServiceConfig} using the Angular injector.\n *\n * Used by {@link provideDbxAnalyticsSegmentApiService} to defer Segment configuration to runtime.\n */\nexport type DbxAnalyticsSegmentApiServiceConfigFactory = (injector: Injector) => DbxAnalyticsSegmentApiServiceConfig;\n\n/**\n * Configuration for {@link provideDbxAnalyticsSegmentApiService}.\n */\nexport interface ProvideDbxAnalyticsSegmentModuleConfig {\n  /**\n   * Whether to preload the Segment script token.\n   */\n  readonly preloadSegmentToken?: boolean;\n  /**\n   * Factory function that produces the Segment API service configuration.\n   */\n  readonly dbxAnalyticsSegmentApiServiceConfigFactory: DbxAnalyticsSegmentApiServiceConfigFactory;\n}\n\n/**\n * Creates Angular environment providers that register {@link DbxAnalyticsSegmentApiService} for Segment analytics integration.\n *\n * Use alongside {@link provideDbxAnalyticsService} to wire Segment as an analytics listener.\n *\n * @param config - Segment-specific configuration including the write key factory\n * @returns environment providers for Segment analytics\n *\n * @example\n * ```ts\n * // In app.config.ts\n * export const appConfig: ApplicationConfig = {\n *   providers: [\n *     provideDbxAnalyticsSegmentApiService({\n *       dbxAnalyticsSegmentApiServiceConfigFactory: (injector) => {\n *         const config = new DbxAnalyticsSegmentApiServiceConfig(environment.analytics.segment);\n *         config.active = environment.production;\n *         config.logging = !environment.production;\n *         return config;\n *       }\n *     }),\n *     provideDbxAnalyticsService({\n *       dbxAnalyticsServiceConfigurationFactory: (injector) => ({\n *         isProduction: environment.production,\n *         listeners: [injector.get(DbxAnalyticsSegmentServiceListener)]\n *       })\n *     })\n *   ]\n * };\n * ```\n */\nexport function provideDbxAnalyticsSegmentApiService(config: ProvideDbxAnalyticsSegmentModuleConfig): EnvironmentProviders {\n  const { preloadSegmentToken, dbxAnalyticsSegmentApiServiceConfigFactory } = config;\n\n  const providers: Provider[] = [\n    // configuration\n    {\n      provide: DbxAnalyticsSegmentApiServiceConfig,\n      useFactory: dbxAnalyticsSegmentApiServiceConfigFactory,\n      deps: [Injector]\n    },\n    // service\n    DbxAnalyticsSegmentApiService\n  ];\n\n  if (preloadSegmentToken) {\n    providers.push({\n      provide: PRELOAD_SEGMENT_TOKEN,\n      useValue: preloadSegmentToken\n    });\n  }\n\n  return makeEnvironmentProviders(providers);\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"dereekb-dbx-analytics.mjs","sources":["../../../../packages/dbx-analytics/src/lib/analytics/analytics.stream.ts","../../../../packages/dbx-analytics/src/lib/analytics/analytics.service.ts","../../../../packages/dbx-analytics/src/lib/action/analytics.action.directive.ts","../../../../packages/dbx-analytics/src/lib/action/analytics.module.ts","../../../../packages/dbx-analytics/src/lib/analytics/analytics.providers.ts","../../../../packages/dbx-analytics/src/lib/providers/mixpanel/mixpanel.service.ts","../../../../packages/dbx-analytics/src/lib/providers/mixpanel/mixpanel.listener.service.ts","../../../../packages/dbx-analytics/src/lib/providers/mixpanel/mixpanel.providers.ts","../../../../packages/dbx-analytics/src/lib/providers/segment/segment.service.ts","../../../../packages/dbx-analytics/src/lib/providers/segment/segment.listener.service.ts","../../../../packages/dbx-analytics/src/lib/providers/segment/segment.providers.ts","../../../../packages/dbx-analytics/src/dereekb-dbx-analytics.ts"],"sourcesContent":["import { type Maybe } from '@dereekb/util';\nimport { type AnalyticsUser, type UserAnalyticsEvent, type AnalyticsUserId } from './analytics';\n\n/**\n * Categorizes the kind of analytics stream event emitted by {@link DbxAnalyticsService}.\n *\n * Listeners use this type to route events to the appropriate analytics provider method\n * (e.g., Segment `track()`, `identify()`, `page()`).\n */\nexport enum DbxAnalyticsStreamEventType {\n  /**\n   * A page/screen view event, typically sent on route transitions.\n   */\n  PageView,\n  /**\n   * Emitted any time the user value changes, including when transitioning from defined to undefined.\n   *\n   * Used by listeners to update the identified user in analytics providers.\n   */\n  UserChange,\n  /**\n   * Emitted only when the user's unique ID changes, filtering out property-only updates.\n   *\n   * Useful for triggering identity calls without redundant updates when only traits change.\n   */\n  UserIdChange,\n\n  // User Events\n  /**\n   * A new user registration event.\n   */\n  NewUserEvent,\n  /**\n   * A returning user login event.\n   */\n  UserLoginEvent,\n  /**\n   * A user logout event.\n   */\n  UserLogoutEvent,\n  /**\n   * An update to user profile properties/traits.\n   */\n  UserPropertiesEvent,\n\n  // Events\n  /**\n   * A generic custom analytics event.\n   */\n  Event,\n\n  // Session Replay\n  /**\n   * Request to start session replay recording.\n   */\n  StartSessionRecording,\n  /**\n   * Request to stop session replay recording.\n   */\n  StopSessionRecording,\n  /**\n   * Request to pause an active session replay recording without clearing it.\n   */\n  PauseSessionRecording,\n  /**\n   * Request to resume a previously paused session replay recording.\n   */\n  ResumeSessionRecording\n}\n\n/**\n * Represents a single event in the analytics stream, combining the event type, payload, and user context.\n *\n * Emitted by {@link DbxAnalyticsService} and consumed by {@link DbxAnalyticsServiceListener} implementations\n * (e.g., {@link DbxAnalyticsSegmentServiceListener}) to forward events to external analytics providers.\n *\n * @example\n * ```ts\n * // Subscribe to the analytics event stream\n * analyticsService.events$.subscribe((streamEvent: DbxAnalyticsStreamEvent) => {\n *   console.log(streamEvent.type, streamEvent.event?.name, streamEvent.userId);\n * });\n * ```\n */\nexport interface DbxAnalyticsStreamEvent {\n  readonly type: DbxAnalyticsStreamEventType;\n  readonly user?: Maybe<AnalyticsUser>;\n  readonly event?: UserAnalyticsEvent;\n  readonly userId?: AnalyticsUserId;\n}\n","import { type Observable, Subject, BehaviorSubject, of, type Subscription, first, shareReplay, switchMap, distinctUntilChanged } from 'rxjs';\nimport { Injectable, inject } from '@angular/core';\nimport { SubscriptionObject, filterMaybe } from '@dereekb/rxjs';\nimport { type AnalyticsEvent, type AnalyticsEventData, type AnalyticsEventName, type AnalyticsUser, type NewUserAnalyticsEventData, type UserAnalyticsEvent } from './analytics';\nimport { type DbxAnalyticsStreamEvent, DbxAnalyticsStreamEventType } from './analytics.stream';\nimport { type Maybe, type Destroyable, safeCompareEquality } from '@dereekb/util';\n\n/**\n * Abstract emitter interface for sending analytics events.\n *\n * Implemented by {@link DbxAnalyticsService} as the primary concrete implementation.\n * Components and services use this to fire analytics events without coupling to a specific provider.\n *\n * @example\n * ```ts\n * // Inject and send a custom event\n * const emitter = inject(DbxAnalyticsEventEmitterService);\n * emitter.sendEventData('Button Clicked', { buttonId: 'save' });\n * ```\n */\nexport abstract class DbxAnalyticsEventEmitterService {\n  abstract sendNewUserEvent(user: AnalyticsUser, data: NewUserAnalyticsEventData): void;\n  abstract sendUserLoginEvent(user: AnalyticsUser, data?: AnalyticsEventData): void;\n  abstract sendUserLogoutEvent(data?: AnalyticsEventData): void;\n  abstract sendUserPropertiesEvent(user: AnalyticsUser, data?: AnalyticsEventData): void;\n  /**\n   * @deprecated When sending an event with no data, use {@link sendEventType} instead.\n   */\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  abstract sendEventData(name: AnalyticsEventName): void;\n  // eslint-disable-next-line @typescript-eslint/no-deprecated\n  abstract sendEventData(name: AnalyticsEventName, data: AnalyticsEventData): void;\n  abstract sendEvent(event: AnalyticsEvent): void;\n  abstract sendPageView(page?: string): void;\n  abstract startSessionRecording(): void;\n  abstract stopSessionRecording(): void;\n  abstract pauseSessionRecording(): void;\n  abstract resumeSessionRecording(): void;\n}\n\n/**\n * Abstract interface exposing the analytics event stream as an observable.\n *\n * Implemented by {@link DbxAnalyticsService}. Listeners subscribe to `events$` to forward events to external providers.\n */\nexport abstract class DbxAnalyticsEventStreamService {\n  abstract readonly events$: Observable<DbxAnalyticsStreamEvent>;\n}\n\n/**\n * Abstract source for the current analytics user identity.\n *\n * Provide an implementation to automatically associate a user with all emitted analytics events.\n * Typically backed by the auth system (e.g., {@link DbxFirebaseAnalyticsUserSource}).\n *\n * @example\n * ```ts\n * // Provide a static user source\n * const userSource: DbxAnalyticsUserSource = {\n *   analyticsUser$: of({ user: 'uid_abc123', properties: { role: 'admin' } })\n * };\n * ```\n */\nexport abstract class DbxAnalyticsUserSource {\n  abstract readonly analyticsUser$: Observable<Maybe<AnalyticsUser>>;\n}\n\n/**\n * Abstract listener that receives analytics events from {@link DbxAnalyticsService}.\n *\n * Implement this to forward events to an external analytics provider (e.g., Segment, Mixpanel).\n * Register listeners via {@link DbxAnalyticsServiceConfiguration.listeners}.\n */\nexport abstract class DbxAnalyticsServiceListener {\n  public abstract listenToService(service: DbxAnalyticsService): void;\n}\n\n/**\n * Base class for analytics service listeners that manages subscription lifecycle and provides\n * reactive access to the analytics service and its event stream.\n *\n * Subclasses implement {@link _initializeServiceSubscription} to subscribe to events and forward them\n * to an external analytics provider.\n *\n * @example\n * ```ts\n * class MyAnalyticsListener extends AbstractDbxAnalyticsServiceListener {\n *   protected _initializeServiceSubscription(): Subscription | false {\n *     return this.analyticsEvents$.subscribe((event) => {\n *       console.log('Event:', event.type, event.event?.name);\n *     });\n *   }\n * }\n * ```\n */\nexport abstract class AbstractDbxAnalyticsServiceListener implements DbxAnalyticsServiceListener, Destroyable {\n  private _sub = new SubscriptionObject();\n  protected _analytics = new BehaviorSubject<Maybe<DbxAnalyticsService>>(undefined);\n\n  readonly analytics$ = this._analytics.pipe(filterMaybe(), shareReplay(1));\n  readonly analyticsEvents$ = this.analytics$.pipe(\n    switchMap((x) => x.events$),\n    shareReplay(1)\n  );\n\n  // MARK: AnalyticsServiceListener\n  listenToService(service: DbxAnalyticsService): void {\n    this._analytics.next(service);\n    const sub = this._initializeServiceSubscription();\n\n    if (sub !== false) {\n      this._sub.subscription = sub;\n    }\n  }\n\n  protected abstract _initializeServiceSubscription(): Subscription | false;\n\n  // MARK: Destroy\n  destroy(): void {\n    this._analytics.complete();\n    this._sub.destroy();\n  }\n}\n\n/**\n * Configuration for {@link DbxAnalyticsService}, controlling which listeners receive events,\n * whether analytics runs in production mode, and optionally providing a user source.\n *\n * In non-production mode, listeners are not initialized and all events are logged to the console instead.\n * Provide via {@link provideDbxAnalyticsService} using a factory function.\n *\n * @example\n * ```ts\n * const config: DbxAnalyticsServiceConfiguration = {\n *   isProduction: environment.production,\n *   logEvents: !environment.production,\n *   listeners: [segmentListener],\n *   userSource: firebaseAnalyticsUserSource\n * };\n * ```\n */\nexport abstract class DbxAnalyticsServiceConfiguration {\n  readonly listeners: DbxAnalyticsServiceListener[] = [];\n  readonly isProduction?: boolean;\n  readonly logEvents?: boolean;\n  readonly userSource?: DbxAnalyticsUserSource;\n}\n\n/**\n * A fully resolved analytics stream event that includes the event payload, type, user context, and extracted user ID.\n *\n * Created by {@link dbxAnalyticsStreamEventAnalyticsEventWrapper} and emitted through the analytics event stream.\n */\nexport interface DbxAnalyticsStreamEventAnalyticsEventWrapper extends DbxAnalyticsStreamEvent {\n  readonly event: UserAnalyticsEvent;\n  readonly type: DbxAnalyticsStreamEventType;\n  readonly user: Maybe<AnalyticsUser>;\n  readonly userId: string | undefined;\n}\n\n/**\n * Wraps a {@link UserAnalyticsEvent} into a {@link DbxAnalyticsStreamEventAnalyticsEventWrapper},\n * extracting the user ID for convenient access by listeners.\n *\n * @param event - the analytics event with optional user context\n * @param type - the stream event type classification; defaults to `Event`\n * @returns a wrapper combining the event, type, user, and extracted userId\n *\n * @example\n * ```ts\n * const wrapper = dbxAnalyticsStreamEventAnalyticsEventWrapper(\n *   { name: 'Button Clicked', user: { user: 'uid_123' } },\n *   DbxAnalyticsStreamEventType.Event\n * );\n * // wrapper.userId === 'uid_123'\n * ```\n */\nexport function dbxAnalyticsStreamEventAnalyticsEventWrapper(event: UserAnalyticsEvent, type: DbxAnalyticsStreamEventType = DbxAnalyticsStreamEventType.Event) {\n  const { user } = event;\n  const userId = user ? user.user : undefined;\n\n  return {\n    event,\n    type,\n    user,\n    userId\n  };\n}\n\n/**\n * Central analytics service that emits typed analytics events for consumption by registered listeners.\n *\n * Acts as both the event emitter (components call methods like {@link sendEventData}, {@link sendPageView})\n * and the event stream source (listeners subscribe to {@link events$}).\n *\n * In production mode, registered {@link DbxAnalyticsServiceListener} instances (e.g., Segment) receive all events.\n * In non-production mode, events are logged to the console for debugging.\n *\n * Provided via {@link provideDbxAnalyticsService} with a {@link DbxAnalyticsServiceConfiguration} factory.\n *\n * @example\n * ```ts\n * // Send a custom event from a component\n * const analytics = inject(DbxAnalyticsService);\n * analytics.sendEventData('Interview Started', { candidateId: 'abc123' });\n *\n * // Send a page view on route transitions\n * transitionService.onSuccess({}, () => {\n *   analytics.sendPageView();\n * });\n * ```\n */\n@Injectable()\nexport class DbxAnalyticsService implements DbxAnalyticsEventStreamService, DbxAnalyticsEventEmitterService, Destroyable {\n  private readonly _config = inject(DbxAnalyticsServiceConfiguration);\n\n  // TODO: Make these configurable.\n  static readonly USER_REGISTRATION_EVENT_NAME = 'User Registered';\n  static readonly USER_LOGIN_EVENT_NAME = 'User Login';\n  static readonly USER_LOGOUT_EVENT_NAME = 'User Logout';\n  static readonly USER_PROPERTIES_EVENT_NAME = 'User Properties';\n\n  private _subject = new Subject<DbxAnalyticsStreamEvent>();\n  readonly events$ = this._subject.asObservable();\n\n  private _userSource = new BehaviorSubject<Maybe<DbxAnalyticsUserSource>>(undefined);\n\n  readonly user$ = this._userSource.pipe(\n    switchMap((x) => (x ? x.analyticsUser$ : of(undefined))),\n    shareReplay(1)\n  );\n\n  private _userSourceSub = new SubscriptionObject();\n  private _userIdEventSub = new SubscriptionObject();\n  private _loggerSub = new SubscriptionObject();\n\n  constructor() {\n    this._init();\n    let userSource: Maybe<DbxAnalyticsUserSource> = inject(DbxAnalyticsUserSource, { optional: true });\n    userSource = userSource || this._config.userSource;\n\n    if (userSource) {\n      this.setUserSource(userSource);\n    }\n  }\n\n  // MARK: Source\n  /**\n   * Sets the analytics user directly, overriding any configured {@link DbxAnalyticsUserSource}.\n   *\n   * Pass `undefined` to clear the current user (e.g., on logout).\n   *\n   * @param user - the user to identify, or undefined to clear\n   */\n  public setUser(user: Maybe<AnalyticsUser>): void {\n    let source: Maybe<DbxAnalyticsUserSource>;\n\n    if (user) {\n      source = { analyticsUser$: of(user) };\n    }\n\n    this._userSource.next(source);\n\n    if (this._userSource.value) {\n      console.warn('DbxAnalyticsService has a userSource that is set. Source is now overridden by setUser() value.');\n    }\n  }\n\n  /**\n   * Sets the reactive user source that automatically updates the analytics user as auth state changes.\n   *\n   * @param source - the user source providing an observable of the current analytics user\n   */\n  public setUserSource(source: DbxAnalyticsUserSource): void {\n    this._userSource.next(source);\n  }\n\n  // MARK: DbxAnalyticsEventEmitterService\n  /**\n   * Emits a new user registration event, typically sent once after account creation.\n   *\n   * @param user - the newly registered user\n   * @param data - registration-specific data including the signup method\n   */\n  public sendNewUserEvent(user: AnalyticsUser, data: NewUserAnalyticsEventData): void {\n    this.sendNextEvent(\n      {\n        name: DbxAnalyticsService.USER_REGISTRATION_EVENT_NAME,\n        data\n      },\n      DbxAnalyticsStreamEventType.NewUserEvent,\n      user\n    );\n  }\n\n  /**\n   * Emits a user login event, identifying the user in analytics providers.\n   *\n   * @param user - the user who logged in\n   * @param data - optional additional event data\n   */\n  public sendUserLoginEvent(user: AnalyticsUser, data?: AnalyticsEventData): void {\n    this.sendNextEvent(\n      {\n        name: DbxAnalyticsService.USER_LOGIN_EVENT_NAME,\n        data\n      },\n      DbxAnalyticsStreamEventType.UserLoginEvent,\n      user\n    );\n  }\n\n  /**\n   * Emits a user logout event and optionally clears the current analytics user.\n   *\n   * @param data - optional additional event data\n   * @param clearUser - whether to reset the analytics user identity; defaults to `true`\n   */\n  public sendUserLogoutEvent(data?: AnalyticsEventData, clearUser = true): void {\n    this.sendNextEvent(\n      {\n        name: DbxAnalyticsService.USER_LOGOUT_EVENT_NAME,\n        data\n      },\n      DbxAnalyticsStreamEventType.UserLogoutEvent\n    );\n\n    if (clearUser) {\n      this.setUser(undefined);\n    }\n  }\n\n  /**\n   * Emits a user properties update event, used to sync user traits to analytics providers.\n   *\n   * @param user - the user whose properties are being updated\n   * @param data - optional additional event data\n   */\n  public sendUserPropertiesEvent(user: AnalyticsUser, data?: AnalyticsEventData): void {\n    this.sendNextEvent(\n      {\n        name: DbxAnalyticsService.USER_PROPERTIES_EVENT_NAME,\n        data\n      },\n      DbxAnalyticsStreamEventType.UserPropertiesEvent,\n      user\n    );\n  }\n\n  /**\n   * @deprecated When sending an event with no data, use {@link sendEventType} instead.\n   */\n  public sendEventData(name: AnalyticsEventName): void;\n  /**\n   * Sends a named analytics event with a data payload.\n   *\n   * This is the primary method for tracking custom events with associated properties.\n   *\n   * @param name - the event name (e.g., `'Interview Ended'`)\n   * @param data - key-value data attached to the event\n   *\n   * @example\n   * ```ts\n   * analytics.sendEventData('Interview Ended', {\n   *   seconds: 120,\n   *   endedDueToTime: 'true'\n   * });\n   * ```\n   */\n  public sendEventData(name: AnalyticsEventName, data: AnalyticsEventData): void;\n  public sendEventData(name: AnalyticsEventName, data?: AnalyticsEventData): void {\n    return this.sendEvent({\n      name,\n      data\n    });\n  }\n\n  /**\n   * Sends a named event with no additional data, useful for simple occurrence tracking.\n   *\n   * @param eventType - the event name to track\n   *\n   * @example\n   * ```ts\n   * analytics.sendEventType('Finish Account Setup');\n   * ```\n   */\n  public sendEventType(eventType: AnalyticsEventName): void {\n    this.sendNextEvent(\n      {\n        name: eventType\n      },\n      DbxAnalyticsStreamEventType.Event\n    );\n  }\n\n  /**\n   * Sends a fully constructed analytics event object.\n   *\n   * @param event - the event containing name, optional value, and data\n   */\n  public sendEvent(event: AnalyticsEvent): void {\n    this.sendNextEvent(event, DbxAnalyticsStreamEventType.Event);\n  }\n\n  /**\n   * Sends a page view event, typically called on successful route transitions.\n   *\n   * @param page - optional page name/path override; if omitted, the provider determines the current page\n   *\n   * @example\n   * ```ts\n   * // In a router config function\n   * transitionService.onSuccess({}, () => {\n   *   analyticsService.sendPageView();\n   * });\n   * ```\n   */\n  public sendPageView(page?: string): void {\n    this.sendNextEvent(\n      {\n        name: page\n      },\n      DbxAnalyticsStreamEventType.PageView\n    );\n  }\n\n  /**\n   * Requests that opt-in listeners (e.g. Mixpanel) start session replay recording.\n   *\n   * Forwarded as a {@link DbxAnalyticsStreamEventType.StartSessionRecording} event. Listeners\n   * that don't handle session replay (e.g. Segment) ignore it.\n   */\n  public startSessionRecording(): void {\n    this.sendNextEvent({}, DbxAnalyticsStreamEventType.StartSessionRecording);\n  }\n\n  /**\n   * Requests that opt-in listeners stop session replay recording.\n   *\n   * Forwarded as a {@link DbxAnalyticsStreamEventType.StopSessionRecording} event.\n   */\n  public stopSessionRecording(): void {\n    this.sendNextEvent({}, DbxAnalyticsStreamEventType.StopSessionRecording);\n  }\n\n  /**\n   * Requests that opt-in listeners pause active session replay recording without clearing it.\n   *\n   * Forwarded as a {@link DbxAnalyticsStreamEventType.PauseSessionRecording} event.\n   */\n  public pauseSessionRecording(): void {\n    this.sendNextEvent({}, DbxAnalyticsStreamEventType.PauseSessionRecording);\n  }\n\n  /**\n   * Requests that opt-in listeners resume previously paused session replay recording.\n   *\n   * Forwarded as a {@link DbxAnalyticsStreamEventType.ResumeSessionRecording} event.\n   */\n  public resumeSessionRecording(): void {\n    this.sendNextEvent({}, DbxAnalyticsStreamEventType.ResumeSessionRecording);\n  }\n\n  /**\n   * Sends the next event.\n   *\n   * @param event\n   * @param type\n   * @param userOverride Uses this user if set as null or an override value. If undefined the current analytics user is used.\n   */\n  protected sendNextEvent(event: AnalyticsEvent = {}, type: DbxAnalyticsStreamEventType, userOverride?: Maybe<AnalyticsUser>): void {\n    this.user$.pipe(first()).subscribe((analyticsUser) => {\n      const user: Maybe<AnalyticsUser> = userOverride !== undefined ? userOverride : analyticsUser;\n      const analyticsEvent: UserAnalyticsEvent = { ...event, user };\n      this.nextEvent(analyticsEvent, type);\n    });\n  }\n\n  protected nextEvent(event: UserAnalyticsEvent, type: DbxAnalyticsStreamEventType): void {\n    const wrapper = dbxAnalyticsStreamEventAnalyticsEventWrapper(event, type);\n    this._subject.next(wrapper);\n  }\n\n  // MARK: Internal\n  private _init(): void {\n    if (this._config.isProduction) {\n      // Initialize listeners.\n      this._config.listeners.forEach((listener) => {\n        listener.listenToService(this);\n      });\n    } else {\n      console.warn('AnalyticsService: Analytics not in production mode. All analytics events are ignored.');\n    }\n\n    if (this._config.logEvents || !this._config.isProduction) {\n      console.log('AnalyticsService: Log analytics events enabled.');\n\n      // Create a new subscription\n      this._loggerSub.subscription = this._subject.subscribe((x) => {\n        console.log(`AnalyticsService: Analytics Event - ${DbxAnalyticsStreamEventType[x.type]} | User: ${x.userId} | Data: ${JSON.stringify(x.event)}.`);\n      });\n    }\n\n    this._userSourceSub.subscription = this.user$.subscribe((user) => {\n      this.sendNextEvent({}, DbxAnalyticsStreamEventType.UserChange, user ?? null);\n    });\n\n    this._userIdEventSub.subscription = this.user$.pipe(distinctUntilChanged((a, b) => safeCompareEquality(a, b, (x, y) => x.user === y.user))).subscribe((user) => {\n      this.sendNextEvent({}, DbxAnalyticsStreamEventType.UserIdChange, user ?? null);\n    });\n  }\n\n  destroy() {\n    this._subject.complete();\n    this._userSource.complete();\n    this._userSourceSub.destroy();\n    this._userIdEventSub.destroy();\n    this._loggerSub.destroy();\n  }\n}\n","import { filterMaybe } from '@dereekb/rxjs';\nimport { switchMap, tap, shareReplay, merge, type Observable, of } from 'rxjs';\nimport { Directive, inject, input } from '@angular/core';\nimport { DbxActionContextStoreSourceInstance, cleanSubscriptionWithLockSet } from '@dereekb/dbx-core';\nimport { DbxAnalyticsService } from '../analytics/analytics.service';\nimport { type Maybe, type ReadableError } from '@dereekb/util';\nimport { toObservable } from '@angular/core/rxjs-interop';\n\n/**\n * Configuration for {@link DbxActionAnalyticsDirective} that maps action lifecycle events to analytics calls.\n *\n * Each callback receives the {@link DbxAnalyticsService} and relevant action data, allowing you to\n * send targeted analytics events at each stage of an action's lifecycle (trigger, ready, success, error).\n *\n * @example\n * ```ts\n * // In a component, define analytics config for a form submit action\n * readonly submitAnalytics: DbxActionAnalyticsConfig<MyFormValue, MyResult> = {\n *   onReady: (service, value) => {\n *     service.sendEventData('Form Submitted', { formType: 'onboard' });\n *   },\n *   onSuccess: (service, result, value) => {\n *     service.sendEventType('Onboarding Complete');\n *   },\n *   onError: (service, error) => {\n *     service.sendEventData('Form Submit Failed', { code: error?.code ?? 'unknown' });\n *   }\n * };\n *\n * // In the template\n * // <button dbxAction [dbxActionAnalytics]=\"submitAnalytics\">Submit</button>\n * ```\n */\nexport interface DbxActionAnalyticsConfig<T = unknown, O = unknown> {\n  /**\n   * Called when the action is triggered (button pressed).\n   */\n  readonly onTriggered?: (service: DbxAnalyticsService) => void;\n  /**\n   * Called when the action value is ready and about to be processed.\n   */\n  readonly onReady?: (service: DbxAnalyticsService, value: T) => void;\n  /**\n   * Called when the action completes successfully.\n   */\n  readonly onSuccess?: (service: DbxAnalyticsService, result: Maybe<O>, value: T) => void;\n  /**\n   * Called when the action encounters an error.\n   */\n  readonly onError?: (service: DbxAnalyticsService, error: Maybe<ReadableError>) => void;\n}\n\n/**\n * Standalone directive that listens to a host {@link DbxActionDirective} and fires analytics events\n * based on the action's lifecycle (triggered, ready, success, error).\n *\n * Attach to any element that has a `dbxAction` directive and pass a {@link DbxActionAnalyticsConfig}\n * to define which events to send at each lifecycle stage.\n *\n * @example\n * ```html\n * <button dbxAction\n *   [dbxActionHandler]=\"handleSave\"\n *   [dbxActionAnalytics]=\"saveAnalytics\">\n *   Save\n * </button>\n * ```\n */\n@Directive({\n  selector: '[dbxActionAnalytics]',\n  standalone: true\n})\nexport class DbxActionAnalyticsDirective<T, O> {\n  readonly source = inject(DbxActionContextStoreSourceInstance<T, O>, { host: true });\n  readonly analyticsService = inject(DbxAnalyticsService);\n\n  readonly config = input<Maybe<DbxActionAnalyticsConfig<T, O>>>(undefined, { alias: 'dbxActionAnalytics' });\n  readonly config$ = toObservable(this.config).pipe(filterMaybe(), shareReplay(1));\n\n  constructor() {\n    cleanSubscriptionWithLockSet({\n      lockSet: this.source.lockSet,\n      sub: this.config$\n        .pipe(\n          switchMap(({ onTriggered, onReady, onSuccess, onError }) => {\n            const triggerObs: Observable<unknown>[] = [];\n\n            if (onTriggered) {\n              triggerObs.push(this.source.triggered$.pipe(tap(() => onTriggered(this.analyticsService))));\n            }\n\n            if (onReady) {\n              triggerObs.push(this.source.valueReady$.pipe(tap((value) => onReady(this.analyticsService, value))));\n            }\n\n            if (onSuccess) {\n              triggerObs.push(this.source.successPair$.pipe(tap(({ result, value }) => onSuccess(this.analyticsService, result, value))));\n            }\n\n            if (onError) {\n              triggerObs.push(\n                this.source.error$.pipe(\n                  filterMaybe(),\n                  tap((error) => onError(this.analyticsService, error))\n                )\n              );\n            }\n\n            return triggerObs.length ? merge(...triggerObs) : of();\n          })\n        )\n        .subscribe()\n    });\n  }\n}\n","import { NgModule } from '@angular/core';\nimport { DbxActionAnalyticsDirective } from './analytics.action.directive';\n\n/**\n * @deprecated The exported DbxActionAnalyticsDirective is now a standalone component. Import that instead.\n */\n@NgModule({\n  imports: [DbxActionAnalyticsDirective],\n  exports: [DbxActionAnalyticsDirective]\n})\nexport class DbxAnalyticsActionModule {}\n","import { type EnvironmentProviders, Injector, type Provider, makeEnvironmentProviders } from '@angular/core';\nimport { DbxAnalyticsServiceConfiguration, DbxAnalyticsService } from './analytics.service';\n\n/**\n * Factory function that creates a {@link DbxAnalyticsServiceConfiguration} using the Angular injector.\n *\n * Used by {@link provideDbxAnalyticsService} to defer configuration resolution to runtime.\n */\nexport type DbxAnalyticsServiceConfigurationFactory = (injector: Injector) => DbxAnalyticsServiceConfiguration;\n\n/**\n * Configuration for {@link provideDbxAnalyticsService}.\n */\nexport interface ProvideDbxAnalyticsConfig {\n  readonly dbxAnalyticsServiceConfigurationFactory: DbxAnalyticsServiceConfigurationFactory;\n}\n\n/**\n * Creates Angular environment providers that register {@link DbxAnalyticsService} and its configuration.\n *\n * Call this in your application's `providers` array to set up analytics with a custom configuration factory\n * that resolves listeners, user sources, and environment flags at runtime.\n *\n * @param config - contains the factory function that produces a {@link DbxAnalyticsServiceConfiguration}\n * @returns environment providers for the analytics service\n *\n * @example\n * ```ts\n * // In app.config.ts\n * export const appConfig: ApplicationConfig = {\n *   providers: [\n *     provideDbxAnalyticsService({\n *       dbxAnalyticsServiceConfigurationFactory: (injector: Injector) => ({\n *         isProduction: environment.production,\n *         logEvents: !environment.production,\n *         listeners: [injector.get(DbxAnalyticsSegmentServiceListener)],\n *         userSource: injector.get(DbxFirebaseAnalyticsUserSource)\n *       })\n *     })\n *   ]\n * };\n * ```\n */\nexport function provideDbxAnalyticsService(config: ProvideDbxAnalyticsConfig): EnvironmentProviders {\n  const { dbxAnalyticsServiceConfigurationFactory } = config;\n\n  const providers: Provider[] = [\n    // configuration\n    {\n      provide: DbxAnalyticsServiceConfiguration,\n      useFactory: dbxAnalyticsServiceConfigurationFactory,\n      deps: [Injector]\n    },\n    // service\n    DbxAnalyticsService\n  ];\n\n  return makeEnvironmentProviders(providers);\n}\n","import { Injectable, InjectionToken, inject } from '@angular/core';\nimport { AbstractAsyncWindowLoadedService } from '@dereekb/browser';\n\n/**\n * Injection token for optionally preloading the Mixpanel SDK on the page.\n *\n * In typical setups Mixpanel is loaded by Segment device mode, so this token is rarely needed.\n */\nexport const PRELOAD_MIXPANEL_TOKEN = new InjectionToken<string>('DbxAnalyticsMixpanelApiServicePreload');\n\n/**\n * Minimal subset of the Mixpanel JS SDK surface used by the Mixpanel listener.\n *\n * Avoids taking a runtime dependency on `mixpanel-browser` since the SDK is loaded on the page\n * by Segment's Mixpanel (Actions) device-mode destination. Widen this interface if more\n * Mixpanel APIs are needed.\n */\nexport interface MixpanelLike {\n  start_session_recording(): void;\n  stop_session_recording(): void;\n  pause_session_recording(): void;\n  resume_session_recording(): void;\n}\n\n/**\n * Configuration for the Mixpanel analytics integration.\n *\n * Unlike {@link DbxAnalyticsSegmentApiServiceConfig}, this config does not take a write key —\n * Mixpanel is initialized by Segment device mode. The `active` and `logging` flags exist for\n * parity with the Segment config and to gate listener behavior.\n *\n * @example\n * ```ts\n * const config = new DbxAnalyticsMixpanelApiServiceConfig();\n * config.active = environment.production;\n * config.logging = !environment.production;\n * ```\n */\nexport class DbxAnalyticsMixpanelApiServiceConfig {\n  logging = true;\n  active = true;\n}\n\n/**\n * Service that manages async access to the Mixpanel JS SDK exposed on `window.mixpanel`.\n *\n * The Mixpanel SDK is typically loaded by Segment's Mixpanel (Actions) device-mode destination,\n * so this service waits for `window.mixpanel` to exist using the inherited window-loading polling.\n * The resolved SDK instance is available via the inherited `service$` observable.\n *\n * Provided via {@link provideDbxAnalyticsMixpanelApiService}.\n *\n * @example\n * ```ts\n * // In app.config.ts\n * provideDbxAnalyticsMixpanelApiService({\n *   dbxAnalyticsMixpanelApiServiceConfigFactory: () => {\n *     const config = new DbxAnalyticsMixpanelApiServiceConfig();\n *     config.active = environment.production;\n *     return config;\n *   }\n * })\n * ```\n */\n@Injectable()\nexport class DbxAnalyticsMixpanelApiService extends AbstractAsyncWindowLoadedService<MixpanelLike> {\n  private readonly _config = inject(DbxAnalyticsMixpanelApiServiceConfig);\n\n  static readonly MIXPANEL_API_WINDOW_KEY = 'mixpanel';\n\n  constructor() {\n    const preload = inject(PRELOAD_MIXPANEL_TOKEN, { optional: true });\n    super(DbxAnalyticsMixpanelApiService.MIXPANEL_API_WINDOW_KEY, undefined, 'Mixpanel', preload);\n  }\n\n  get config(): DbxAnalyticsMixpanelApiServiceConfig {\n    return this._config;\n  }\n}\n","import { Injectable, inject } from '@angular/core';\nimport { combineLatest } from 'rxjs';\nimport { AbstractDbxAnalyticsServiceListener, type DbxAnalyticsStreamEvent, DbxAnalyticsStreamEventType } from '../../analytics';\nimport { DbxAnalyticsMixpanelApiService, type MixpanelLike } from './mixpanel.service';\n\n/**\n * Analytics listener that forwards session-replay control events to the Mixpanel SDK.\n *\n * Handles only the four session-replay event types — track/identify/page events are intentionally\n * not forwarded here because Segment's Mixpanel (Actions) device-mode destination already routes\n * them to Mixpanel. Forwarding them again would produce duplicate events.\n *\n * - {@link DbxAnalyticsStreamEventType.StartSessionRecording} -> `mixpanel.start_session_recording()`\n * - {@link DbxAnalyticsStreamEventType.StopSessionRecording} -> `mixpanel.stop_session_recording()`\n * - {@link DbxAnalyticsStreamEventType.PauseSessionRecording} -> `mixpanel.pause_session_recording()`\n * - {@link DbxAnalyticsStreamEventType.ResumeSessionRecording} -> `mixpanel.resume_session_recording()`\n *\n * Events are only sent when the Mixpanel configuration is marked as `active`.\n * Provided at root level and registered as a listener via {@link DbxAnalyticsServiceConfiguration.listeners}.\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class DbxAnalyticsMixpanelServiceListener extends AbstractDbxAnalyticsServiceListener {\n  private readonly _mixpanelApi = inject(DbxAnalyticsMixpanelApiService);\n\n  constructor() {\n    super();\n\n    if (this._mixpanelApi.config.logging) {\n      console.log('MixpanelAnalyticsListenerService: Mixpanel is logging events.');\n    }\n\n    if (!this._mixpanelApi.config.active) {\n      console.log('MixpanelAnalyticsListenerService: Mixpanel is disabled from sending events to the server.');\n    }\n  }\n\n  protected _initializeServiceSubscription() {\n    return combineLatest([this._mixpanelApi.service$, this.analyticsEvents$]).subscribe(([mixpanel, streamEvent]: [MixpanelLike, DbxAnalyticsStreamEvent]) => {\n      if (this._mixpanelApi.config.logging) {\n        console.log('Mixpanel Listener Logging Event: ', streamEvent);\n      }\n\n      if (this._mixpanelApi.config.active) {\n        this.handleStreamEvent(mixpanel, streamEvent);\n      }\n    });\n  }\n\n  /**\n   * Routes a session-replay control event to the corresponding Mixpanel SDK method.\n   *\n   * Non-session-replay events are intentionally ignored — Segment's device-mode integration\n   * already forwards track/identify/page to Mixpanel.\n   *\n   * @param api - The loaded Mixpanel SDK instance\n   * @param streamEvent - The analytics event to process\n   */\n  protected handleStreamEvent(api: MixpanelLike, streamEvent: DbxAnalyticsStreamEvent): void {\n    switch (streamEvent.type) {\n      case DbxAnalyticsStreamEventType.StartSessionRecording:\n        api.start_session_recording();\n        break;\n      case DbxAnalyticsStreamEventType.StopSessionRecording:\n        api.stop_session_recording();\n        break;\n      case DbxAnalyticsStreamEventType.PauseSessionRecording:\n        api.pause_session_recording();\n        break;\n      case DbxAnalyticsStreamEventType.ResumeSessionRecording:\n        api.resume_session_recording();\n        break;\n      default:\n        // All other event types are routed to Mixpanel by Segment's device-mode destination.\n        break;\n    }\n  }\n}\n","import { type EnvironmentProviders, Injector, makeEnvironmentProviders, type Provider } from '@angular/core';\nimport { DbxAnalyticsMixpanelApiService, DbxAnalyticsMixpanelApiServiceConfig, PRELOAD_MIXPANEL_TOKEN } from './mixpanel.service';\n\n/**\n * Factory function that creates a {@link DbxAnalyticsMixpanelApiServiceConfig} using the Angular injector.\n *\n * Used by {@link provideDbxAnalyticsMixpanelApiService} to defer Mixpanel configuration to runtime.\n */\nexport type DbxAnalyticsMixpanelApiServiceConfigFactory = (injector: Injector) => DbxAnalyticsMixpanelApiServiceConfig;\n\n/**\n * Configuration for {@link provideDbxAnalyticsMixpanelApiService}.\n */\nexport interface ProvideDbxAnalyticsMixpanelModuleConfig {\n  /**\n   * Whether to preload the Mixpanel script token.\n   *\n   * Rarely needed — Mixpanel is typically loaded by Segment's device-mode destination.\n   */\n  readonly preloadMixpanelToken?: boolean;\n  /**\n   * Factory function that produces the Mixpanel API service configuration.\n   */\n  readonly dbxAnalyticsMixpanelApiServiceConfigFactory: DbxAnalyticsMixpanelApiServiceConfigFactory;\n}\n\n/**\n * Creates Angular environment providers that register {@link DbxAnalyticsMixpanelApiService} for Mixpanel session-replay control.\n *\n * Use alongside {@link provideDbxAnalyticsService} to wire Mixpanel as an analytics listener that\n * handles session-replay start/stop/pause/resume events.\n *\n * @param config - Mixpanel-specific configuration\n * @returns environment providers for Mixpanel analytics\n *\n * @example\n * ```ts\n * // In app.config.ts\n * export const appConfig: ApplicationConfig = {\n *   providers: [\n *     provideDbxAnalyticsMixpanelApiService({\n *       dbxAnalyticsMixpanelApiServiceConfigFactory: () => {\n *         const config = new DbxAnalyticsMixpanelApiServiceConfig();\n *         config.active = environment.production;\n *         return config;\n *       }\n *     }),\n *     provideDbxAnalyticsService({\n *       dbxAnalyticsServiceConfigurationFactory: (injector) => ({\n *         isProduction: environment.production,\n *         listeners: [\n *           injector.get(DbxAnalyticsSegmentServiceListener),\n *           injector.get(DbxAnalyticsMixpanelServiceListener)\n *         ]\n *       })\n *     })\n *   ]\n * };\n * ```\n */\nexport function provideDbxAnalyticsMixpanelApiService(config: ProvideDbxAnalyticsMixpanelModuleConfig): EnvironmentProviders {\n  const { preloadMixpanelToken, dbxAnalyticsMixpanelApiServiceConfigFactory } = config;\n\n  const providers: Provider[] = [\n    // configuration\n    {\n      provide: DbxAnalyticsMixpanelApiServiceConfig,\n      useFactory: dbxAnalyticsMixpanelApiServiceConfigFactory,\n      deps: [Injector]\n    },\n    // service\n    DbxAnalyticsMixpanelApiService\n  ];\n\n  if (preloadMixpanelToken) {\n    providers.push({\n      provide: PRELOAD_MIXPANEL_TOKEN,\n      useValue: preloadMixpanelToken\n    });\n  }\n\n  return makeEnvironmentProviders(providers);\n}\n","import { Injectable, InjectionToken, inject } from '@angular/core';\nimport { AbstractAsyncWindowLoadedService } from '@dereekb/browser';\nimport { poll } from '@dereekb/util';\n\n/**\n * Injection token for optionally preloading the Segment analytics script.\n */\nexport const PRELOAD_SEGMENT_TOKEN = new InjectionToken<string>('DbxAnalyticsSegmentApiServicePreload');\n\n/**\n * Configuration for the Segment analytics integration.\n *\n * @example\n * ```ts\n * const config = new DbxAnalyticsSegmentApiServiceConfig('your-segment-write-key');\n * config.active = environment.production;\n * config.logging = !environment.production;\n * ```\n */\nexport class DbxAnalyticsSegmentApiServiceConfig {\n  writeKey: string;\n  logging = true;\n  active = true;\n  constructor(writeKey: string) {\n    this.writeKey = writeKey;\n  }\n}\n\n/**\n * Extended Segment analytics type that includes the `invoked` flag set after the snippet initializes.\n */\ntype SegmentAnalyticsInvoked = SegmentAnalytics.AnalyticsJS & { invoked?: boolean };\n\n/**\n * Service that manages the async loading and initialization of the Segment analytics SDK from `window.analytics`.\n *\n * Polls for the Segment snippet to be invoked, then calls `analytics.load()` with the configured write key.\n * Once Segment reports ready, the resolved SDK instance is available via the inherited `service$` observable.\n *\n * Requires the Segment analytics snippet to be included in `index.html`.\n *\n * Provided via {@link provideDbxAnalyticsSegmentApiService}.\n *\n * @example\n * ```ts\n * // In app.config.ts\n * provideDbxAnalyticsSegmentApiService({\n *   dbxAnalyticsSegmentApiServiceConfigFactory: (injector) => {\n *     const config = new DbxAnalyticsSegmentApiServiceConfig(environment.analytics.segment);\n *     config.active = environment.production;\n *     return config;\n *   }\n * })\n * ```\n */\n@Injectable()\nexport class DbxAnalyticsSegmentApiService extends AbstractAsyncWindowLoadedService<SegmentAnalytics.AnalyticsJS> {\n  private readonly _config = inject(DbxAnalyticsSegmentApiServiceConfig);\n\n  static readonly SEGMENT_API_WINDOW_KEY = 'analytics';\n  static readonly SEGMENT_READY_KEY = 'SegmentReady';\n\n  constructor() {\n    const preload = inject(PRELOAD_SEGMENT_TOKEN, { optional: true });\n    super(DbxAnalyticsSegmentApiService.SEGMENT_API_WINDOW_KEY, undefined, 'Segment', preload);\n  }\n\n  get config(): DbxAnalyticsSegmentApiServiceConfig {\n    return this._config;\n  }\n\n  protected override _prepareCompleteLoadingService(): Promise<void> {\n    return poll({\n      // poll until analytics.invoked is true.\n      check: () => Boolean((window.analytics as SegmentAnalyticsInvoked).invoked),\n      timesToGiveup: 100\n    });\n  }\n\n  protected override _initService(service: SegmentAnalytics.AnalyticsJS): Promise<SegmentAnalytics.AnalyticsJS> {\n    return new Promise((resolve, reject) => {\n      try {\n        service.load(this._config.writeKey); // Initialize Segment\n\n        // Wait for the service to ready itself.\n        service.ready(() => {\n          // Segment changes itself or rather the target, and the previous initial target is ignored after.\n          const segment: SegmentAnalytics.AnalyticsJS = window[DbxAnalyticsSegmentApiService.SEGMENT_API_WINDOW_KEY];\n          resolve(segment);\n        });\n      } catch (e) {\n        console.log('Failed to init segment: ' + e);\n        reject(e);\n      }\n    });\n  }\n}\n","import { Injectable, inject } from '@angular/core';\nimport { type Maybe } from '@dereekb/util';\nimport { combineLatest } from 'rxjs';\nimport { AbstractDbxAnalyticsServiceListener, type DbxAnalyticsStreamEvent, DbxAnalyticsStreamEventType, type AnalyticsUser } from '../../analytics';\nimport { DbxAnalyticsSegmentApiService } from './segment.service';\n\n/**\n * Analytics listener that forwards {@link DbxAnalyticsStreamEvent} events to the Segment SDK.\n *\n * Automatically maps event types to the appropriate Segment methods:\n * - {@link DbxAnalyticsStreamEventType.Event} / {@link DbxAnalyticsStreamEventType.UserLoginEvent} -> `track()`\n * - {@link DbxAnalyticsStreamEventType.UserChange} / {@link DbxAnalyticsStreamEventType.NewUserEvent} -> `identify()`\n * - {@link DbxAnalyticsStreamEventType.UserLogoutEvent} -> `reset()`\n * - {@link DbxAnalyticsStreamEventType.PageView} -> `page()`\n *\n * Events are only sent when the Segment configuration is marked as `active`.\n * Provided at root level and registered as a listener via {@link DbxAnalyticsServiceConfiguration.listeners}.\n *\n * @example\n * ```ts\n * // Register in analytics configuration factory\n * function analyticsConfigFactory(injector: Injector): DbxAnalyticsServiceConfiguration {\n *   const segmentListener = injector.get(DbxAnalyticsSegmentServiceListener);\n *   return {\n *     isProduction: true,\n *     listeners: [segmentListener]\n *   };\n * }\n * ```\n */\n@Injectable({\n  providedIn: 'root'\n})\nexport class DbxAnalyticsSegmentServiceListener extends AbstractDbxAnalyticsServiceListener {\n  private readonly _segmentApi = inject(DbxAnalyticsSegmentApiService);\n\n  constructor() {\n    super();\n\n    if (this._segmentApi.config.logging) {\n      console.log('SegmentAnalyticsListenerService: Segment is logging events.');\n    }\n\n    if (!this._segmentApi.config.active) {\n      console.log('SegmentAnalyticsListenerService: Segment is disabled from sending events to the server.');\n    }\n  }\n\n  /**\n   * Subscribes to the Segment API service and analytics event stream, forwarding events to the Segment SDK.\n   *\n   * Events are only sent when the Segment configuration is marked as active.\n   *\n   * @returns subscription to the combined Segment API and analytics event stream\n   */\n  protected _initializeServiceSubscription() {\n    return combineLatest([this._segmentApi.service$, this.analyticsEvents$]).subscribe(([segment, streamEvent]: [SegmentAnalytics.AnalyticsJS, DbxAnalyticsStreamEvent]) => {\n      if (this._segmentApi.config.logging) {\n        console.log('Segment Listener Logging Event: ', streamEvent);\n      }\n\n      if (this._segmentApi.config.active) {\n        this.handleStreamEvent(segment, streamEvent);\n      }\n    });\n  }\n\n  /**\n   * Routes an analytics stream event to the appropriate Segment API method based on event type.\n   *\n   * @param api - The Segment analytics SDK instance\n   * @param streamEvent - The analytics event to process\n   */\n  protected handleStreamEvent(api: SegmentAnalytics.AnalyticsJS, streamEvent: DbxAnalyticsStreamEvent): void {\n    switch (streamEvent.type) {\n      case DbxAnalyticsStreamEventType.NewUserEvent:\n        this.updateWithNewUserEvent(api, streamEvent);\n        break;\n      case DbxAnalyticsStreamEventType.UserLoginEvent:\n        this.changeUser(api, streamEvent.user);\n        this.updateWithEvent(api, streamEvent);\n        break;\n      case DbxAnalyticsStreamEventType.Event:\n        this.updateWithEvent(api, streamEvent);\n        break;\n      case DbxAnalyticsStreamEventType.UserLogoutEvent:\n        this.changeUser(api, undefined);\n        break;\n      case DbxAnalyticsStreamEventType.PageView:\n        api.page();\n        break;\n      case DbxAnalyticsStreamEventType.UserChange:\n        this.changeUser(api, streamEvent.user);\n        break;\n      case DbxAnalyticsStreamEventType.UserIdChange:\n      case DbxAnalyticsStreamEventType.UserPropertiesEvent:\n      case DbxAnalyticsStreamEventType.StartSessionRecording:\n      case DbxAnalyticsStreamEventType.StopSessionRecording:\n      case DbxAnalyticsStreamEventType.PauseSessionRecording:\n      case DbxAnalyticsStreamEventType.ResumeSessionRecording:\n        // These event types are not forwarded to Segment.\n        break;\n    }\n  }\n\n  /**\n   * Handles a new user registration event by identifying the user in Segment.\n   *\n   * @param api - The Segment analytics SDK instance\n   * @param streamEvent - The event containing the new user data\n   */\n  protected updateWithNewUserEvent(api: SegmentAnalytics.AnalyticsJS, streamEvent: DbxAnalyticsStreamEvent): void {\n    this.changeUser(api, streamEvent.user);\n  }\n\n  /**\n   * Sends a track event to Segment with the event name, value, and additional data properties.\n   *\n   * @param api - The Segment analytics SDK instance\n   * @param streamEvent - The analytics event containing name, value, and data\n   * @param name - Optional override for the event name\n   */\n  protected updateWithEvent(api: SegmentAnalytics.AnalyticsJS, streamEvent: DbxAnalyticsStreamEvent, name?: string): void {\n    const event = streamEvent.event;\n    const eventName = name || event?.name;\n\n    if (eventName) {\n      const value = event?.value;\n      const data = event?.data;\n\n      api.track(\n        eventName,\n        {\n          ...(value != null\n            ? {\n                value\n              }\n            : undefined),\n          ...data\n        },\n        {},\n        () => {\n          if (this._segmentApi.config.logging) {\n            console.log('Segment track success.');\n          }\n        }\n      );\n    }\n  }\n\n  private changeUser(api: SegmentAnalytics.AnalyticsJS, user: Maybe<AnalyticsUser>): void {\n    if (user?.user) {\n      api.identify(\n        user.user,\n        {\n          ...user.properties\n        },\n        {},\n        () => {\n          if (this._segmentApi.config.logging) {\n            console.log('Segment identify success.');\n          }\n        }\n      );\n    } else {\n      api.reset();\n    }\n  }\n}\n","import { type EnvironmentProviders, Injector, makeEnvironmentProviders, type Provider } from '@angular/core';\nimport { DbxAnalyticsSegmentApiService, DbxAnalyticsSegmentApiServiceConfig, PRELOAD_SEGMENT_TOKEN } from './segment.service';\n\n/**\n * Factory function that creates a {@link DbxAnalyticsSegmentApiServiceConfig} using the Angular injector.\n *\n * Used by {@link provideDbxAnalyticsSegmentApiService} to defer Segment configuration to runtime.\n */\nexport type DbxAnalyticsSegmentApiServiceConfigFactory = (injector: Injector) => DbxAnalyticsSegmentApiServiceConfig;\n\n/**\n * Configuration for {@link provideDbxAnalyticsSegmentApiService}.\n */\nexport interface ProvideDbxAnalyticsSegmentModuleConfig {\n  /**\n   * Whether to preload the Segment script token.\n   */\n  readonly preloadSegmentToken?: boolean;\n  /**\n   * Factory function that produces the Segment API service configuration.\n   */\n  readonly dbxAnalyticsSegmentApiServiceConfigFactory: DbxAnalyticsSegmentApiServiceConfigFactory;\n}\n\n/**\n * Creates Angular environment providers that register {@link DbxAnalyticsSegmentApiService} for Segment analytics integration.\n *\n * Use alongside {@link provideDbxAnalyticsService} to wire Segment as an analytics listener.\n *\n * @param config - Segment-specific configuration including the write key factory\n * @returns environment providers for Segment analytics\n *\n * @example\n * ```ts\n * // In app.config.ts\n * export const appConfig: ApplicationConfig = {\n *   providers: [\n *     provideDbxAnalyticsSegmentApiService({\n *       dbxAnalyticsSegmentApiServiceConfigFactory: (injector) => {\n *         const config = new DbxAnalyticsSegmentApiServiceConfig(environment.analytics.segment);\n *         config.active = environment.production;\n *         config.logging = !environment.production;\n *         return config;\n *       }\n *     }),\n *     provideDbxAnalyticsService({\n *       dbxAnalyticsServiceConfigurationFactory: (injector) => ({\n *         isProduction: environment.production,\n *         listeners: [injector.get(DbxAnalyticsSegmentServiceListener)]\n *       })\n *     })\n *   ]\n * };\n * ```\n */\nexport function provideDbxAnalyticsSegmentApiService(config: ProvideDbxAnalyticsSegmentModuleConfig): EnvironmentProviders {\n  const { preloadSegmentToken, dbxAnalyticsSegmentApiServiceConfigFactory } = config;\n\n  const providers: Provider[] = [\n    // configuration\n    {\n      provide: DbxAnalyticsSegmentApiServiceConfig,\n      useFactory: dbxAnalyticsSegmentApiServiceConfigFactory,\n      deps: [Injector]\n    },\n    // service\n    DbxAnalyticsSegmentApiService\n  ];\n\n  if (preloadSegmentToken) {\n    providers.push({\n      provide: PRELOAD_SEGMENT_TOKEN,\n      useValue: preloadSegmentToken\n    });\n  }\n\n  return makeEnvironmentProviders(providers);\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@dereekb/dbx-analytics",
-  "version": "13.10.2",
+  "version": "13.10.3",
   "peerDependencies": {
     "@angular/core": "21.2.10",
-    "@dereekb/analytics": "13.10.2",
-    "@dereekb/browser": "13.10.2",
-    "@dereekb/dbx-core": "13.10.2",
-    "@dereekb/rxjs": "13.10.2",
-    "@dereekb/util": "13.10.2",
-    "@dereekb/vitest": "13.10.2",
+    "@dereekb/analytics": "13.10.3",
+    "@dereekb/browser": "13.10.3",
+    "@dereekb/dbx-core": "13.10.3",
+    "@dereekb/rxjs": "13.10.3",
+    "@dereekb/util": "13.10.3",
+    "@dereekb/vitest": "13.10.3",
     "rxjs": "^7.8.2"
   },
   "dependencies": {

package/types/dereekb-dbx-analytics.d.ts

@@ -79,7 +79,23 @@ declare enum DbxAnalyticsStreamEventType {
     /**
      * A generic custom analytics event.
      */
-    Event = 7
+    Event = 7,
+    /**
+     * Request to start session replay recording.
+     */
+    StartSessionRecording = 8,
+    /**
+     * Request to stop session replay recording.
+     */
+    StopSessionRecording = 9,
+    /**
+     * Request to pause an active session replay recording without clearing it.
+     */
+    PauseSessionRecording = 10,
+    /**
+     * Request to resume a previously paused session replay recording.
+     */
+    ResumeSessionRecording = 11
 }
 /**
  * Represents a single event in the analytics stream, combining the event type, payload, and user context.
@@ -127,6 +143,10 @@ declare abstract class DbxAnalyticsEventEmitterService {
     abstract sendEventData(name: AnalyticsEventName, data: AnalyticsEventData): void;
     abstract sendEvent(event: AnalyticsEvent): void;
     abstract sendPageView(page?: string): void;
+    abstract startSessionRecording(): void;
+    abstract stopSessionRecording(): void;
+    abstract pauseSessionRecording(): void;
+    abstract resumeSessionRecording(): void;
 }
 /**
  * Abstract interface exposing the analytics event stream as an observable.
@@ -377,6 +397,31 @@ declare class DbxAnalyticsService implements DbxAnalyticsEventStreamService, Dbx
      * ```
      */
     sendPageView(page?: string): void;
+    /**
+     * Requests that opt-in listeners (e.g. Mixpanel) start session replay recording.
+     *
+     * Forwarded as a {@link DbxAnalyticsStreamEventType.StartSessionRecording} event. Listeners
+     * that don't handle session replay (e.g. Segment) ignore it.
+     */
+    startSessionRecording(): void;
+    /**
+     * Requests that opt-in listeners stop session replay recording.
+     *
+     * Forwarded as a {@link DbxAnalyticsStreamEventType.StopSessionRecording} event.
+     */
+    stopSessionRecording(): void;
+    /**
+     * Requests that opt-in listeners pause active session replay recording without clearing it.
+     *
+     * Forwarded as a {@link DbxAnalyticsStreamEventType.PauseSessionRecording} event.
+     */
+    pauseSessionRecording(): void;
+    /**
+     * Requests that opt-in listeners resume previously paused session replay recording.
+     *
+     * Forwarded as a {@link DbxAnalyticsStreamEventType.ResumeSessionRecording} event.
+     */
+    resumeSessionRecording(): void;
     /**
      * Sends the next event.
      *
@@ -510,6 +555,163 @@ interface ProvideDbxAnalyticsConfig {
  */
 declare function provideDbxAnalyticsService(config: ProvideDbxAnalyticsConfig): EnvironmentProviders;
 
+/**
+ * Injection token for optionally preloading the Mixpanel SDK on the page.
+ *
+ * In typical setups Mixpanel is loaded by Segment device mode, so this token is rarely needed.
+ */
+declare const PRELOAD_MIXPANEL_TOKEN: InjectionToken<string>;
+/**
+ * Minimal subset of the Mixpanel JS SDK surface used by the Mixpanel listener.
+ *
+ * Avoids taking a runtime dependency on `mixpanel-browser` since the SDK is loaded on the page
+ * by Segment's Mixpanel (Actions) device-mode destination. Widen this interface if more
+ * Mixpanel APIs are needed.
+ */
+interface MixpanelLike {
+    start_session_recording(): void;
+    stop_session_recording(): void;
+    pause_session_recording(): void;
+    resume_session_recording(): void;
+}
+/**
+ * Configuration for the Mixpanel analytics integration.
+ *
+ * Unlike {@link DbxAnalyticsSegmentApiServiceConfig}, this config does not take a write key —
+ * Mixpanel is initialized by Segment device mode. The `active` and `logging` flags exist for
+ * parity with the Segment config and to gate listener behavior.
+ *
+ * @example
+ * ```ts
+ * const config = new DbxAnalyticsMixpanelApiServiceConfig();
+ * config.active = environment.production;
+ * config.logging = !environment.production;
+ * ```
+ */
+declare class DbxAnalyticsMixpanelApiServiceConfig {
+    logging: boolean;
+    active: boolean;
+}
+/**
+ * Service that manages async access to the Mixpanel JS SDK exposed on `window.mixpanel`.
+ *
+ * The Mixpanel SDK is typically loaded by Segment's Mixpanel (Actions) device-mode destination,
+ * so this service waits for `window.mixpanel` to exist using the inherited window-loading polling.
+ * The resolved SDK instance is available via the inherited `service$` observable.
+ *
+ * Provided via {@link provideDbxAnalyticsMixpanelApiService}.
+ *
+ * @example
+ * ```ts
+ * // In app.config.ts
+ * provideDbxAnalyticsMixpanelApiService({
+ *   dbxAnalyticsMixpanelApiServiceConfigFactory: () => {
+ *     const config = new DbxAnalyticsMixpanelApiServiceConfig();
+ *     config.active = environment.production;
+ *     return config;
+ *   }
+ * })
+ * ```
+ */
+declare class DbxAnalyticsMixpanelApiService extends AbstractAsyncWindowLoadedService<MixpanelLike> {
+    private readonly _config;
+    static readonly MIXPANEL_API_WINDOW_KEY = "mixpanel";
+    constructor();
+    get config(): DbxAnalyticsMixpanelApiServiceConfig;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DbxAnalyticsMixpanelApiService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DbxAnalyticsMixpanelApiService>;
+}
+
+/**
+ * Analytics listener that forwards session-replay control events to the Mixpanel SDK.
+ *
+ * Handles only the four session-replay event types — track/identify/page events are intentionally
+ * not forwarded here because Segment's Mixpanel (Actions) device-mode destination already routes
+ * them to Mixpanel. Forwarding them again would produce duplicate events.
+ *
+ * - {@link DbxAnalyticsStreamEventType.StartSessionRecording} -> `mixpanel.start_session_recording()`
+ * - {@link DbxAnalyticsStreamEventType.StopSessionRecording} -> `mixpanel.stop_session_recording()`
+ * - {@link DbxAnalyticsStreamEventType.PauseSessionRecording} -> `mixpanel.pause_session_recording()`
+ * - {@link DbxAnalyticsStreamEventType.ResumeSessionRecording} -> `mixpanel.resume_session_recording()`
+ *
+ * Events are only sent when the Mixpanel configuration is marked as `active`.
+ * Provided at root level and registered as a listener via {@link DbxAnalyticsServiceConfiguration.listeners}.
+ */
+declare class DbxAnalyticsMixpanelServiceListener extends AbstractDbxAnalyticsServiceListener {
+    private readonly _mixpanelApi;
+    constructor();
+    protected _initializeServiceSubscription(): rxjs.Subscription;
+    /**
+     * Routes a session-replay control event to the corresponding Mixpanel SDK method.
+     *
+     * Non-session-replay events are intentionally ignored — Segment's device-mode integration
+     * already forwards track/identify/page to Mixpanel.
+     *
+     * @param api - The loaded Mixpanel SDK instance
+     * @param streamEvent - The analytics event to process
+     */
+    protected handleStreamEvent(api: MixpanelLike, streamEvent: DbxAnalyticsStreamEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DbxAnalyticsMixpanelServiceListener, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DbxAnalyticsMixpanelServiceListener>;
+}
+
+/**
+ * Factory function that creates a {@link DbxAnalyticsMixpanelApiServiceConfig} using the Angular injector.
+ *
+ * Used by {@link provideDbxAnalyticsMixpanelApiService} to defer Mixpanel configuration to runtime.
+ */
+type DbxAnalyticsMixpanelApiServiceConfigFactory = (injector: Injector) => DbxAnalyticsMixpanelApiServiceConfig;
+/**
+ * Configuration for {@link provideDbxAnalyticsMixpanelApiService}.
+ */
+interface ProvideDbxAnalyticsMixpanelModuleConfig {
+    /**
+     * Whether to preload the Mixpanel script token.
+     *
+     * Rarely needed — Mixpanel is typically loaded by Segment's device-mode destination.
+     */
+    readonly preloadMixpanelToken?: boolean;
+    /**
+     * Factory function that produces the Mixpanel API service configuration.
+     */
+    readonly dbxAnalyticsMixpanelApiServiceConfigFactory: DbxAnalyticsMixpanelApiServiceConfigFactory;
+}
+/**
+ * Creates Angular environment providers that register {@link DbxAnalyticsMixpanelApiService} for Mixpanel session-replay control.
+ *
+ * Use alongside {@link provideDbxAnalyticsService} to wire Mixpanel as an analytics listener that
+ * handles session-replay start/stop/pause/resume events.
+ *
+ * @param config - Mixpanel-specific configuration
+ * @returns environment providers for Mixpanel analytics
+ *
+ * @example
+ * ```ts
+ * // In app.config.ts
+ * export const appConfig: ApplicationConfig = {
+ *   providers: [
+ *     provideDbxAnalyticsMixpanelApiService({
+ *       dbxAnalyticsMixpanelApiServiceConfigFactory: () => {
+ *         const config = new DbxAnalyticsMixpanelApiServiceConfig();
+ *         config.active = environment.production;
+ *         return config;
+ *       }
+ *     }),
+ *     provideDbxAnalyticsService({
+ *       dbxAnalyticsServiceConfigurationFactory: (injector) => ({
+ *         isProduction: environment.production,
+ *         listeners: [
+ *           injector.get(DbxAnalyticsSegmentServiceListener),
+ *           injector.get(DbxAnalyticsMixpanelServiceListener)
+ *         ]
+ *       })
+ *     })
+ *   ]
+ * };
+ * ```
+ */
+declare function provideDbxAnalyticsMixpanelApiService(config: ProvideDbxAnalyticsMixpanelModuleConfig): EnvironmentProviders;
+
 /**
  * Analytics listener that forwards {@link DbxAnalyticsStreamEvent} events to the Segment SDK.
  *
@@ -678,5 +880,5 @@ interface ProvideDbxAnalyticsSegmentModuleConfig {
  */
 declare function provideDbxAnalyticsSegmentApiService(config: ProvideDbxAnalyticsSegmentModuleConfig): EnvironmentProviders;
 
-export { AbstractDbxAnalyticsServiceListener, DbxActionAnalyticsDirective, DbxAnalyticsActionModule, DbxAnalyticsEventEmitterService, DbxAnalyticsEventStreamService, DbxAnalyticsSegmentApiService, DbxAnalyticsSegmentApiServiceConfig, DbxAnalyticsSegmentServiceListener, DbxAnalyticsService, DbxAnalyticsServiceConfiguration, DbxAnalyticsServiceListener, DbxAnalyticsStreamEventType, DbxAnalyticsUserSource, PRELOAD_SEGMENT_TOKEN, dbxAnalyticsStreamEventAnalyticsEventWrapper, provideDbxAnalyticsSegmentApiService, provideDbxAnalyticsService };
-export type { DbxActionAnalyticsConfig, DbxAnalyticsEvent, DbxAnalyticsEventData, DbxAnalyticsEventName, DbxAnalyticsSegmentApiServiceConfigFactory, DbxAnalyticsServiceConfigurationFactory, DbxAnalyticsStreamEvent, DbxAnalyticsStreamEventAnalyticsEventWrapper, DbxAnalyticsUser, DbxAnalyticsUserId, DbxAnalyticsUserProperties, DbxUserAnalyticsEvent, ProvideDbxAnalyticsConfig, ProvideDbxAnalyticsSegmentModuleConfig };
+export { AbstractDbxAnalyticsServiceListener, DbxActionAnalyticsDirective, DbxAnalyticsActionModule, DbxAnalyticsEventEmitterService, DbxAnalyticsEventStreamService, DbxAnalyticsMixpanelApiService, DbxAnalyticsMixpanelApiServiceConfig, DbxAnalyticsMixpanelServiceListener, DbxAnalyticsSegmentApiService, DbxAnalyticsSegmentApiServiceConfig, DbxAnalyticsSegmentServiceListener, DbxAnalyticsService, DbxAnalyticsServiceConfiguration, DbxAnalyticsServiceListener, DbxAnalyticsStreamEventType, DbxAnalyticsUserSource, PRELOAD_MIXPANEL_TOKEN, PRELOAD_SEGMENT_TOKEN, dbxAnalyticsStreamEventAnalyticsEventWrapper, provideDbxAnalyticsMixpanelApiService, provideDbxAnalyticsSegmentApiService, provideDbxAnalyticsService };
+export type { DbxActionAnalyticsConfig, DbxAnalyticsEvent, DbxAnalyticsEventData, DbxAnalyticsEventName, DbxAnalyticsMixpanelApiServiceConfigFactory, DbxAnalyticsSegmentApiServiceConfigFactory, DbxAnalyticsServiceConfigurationFactory, DbxAnalyticsStreamEvent, DbxAnalyticsStreamEventAnalyticsEventWrapper, DbxAnalyticsUser, DbxAnalyticsUserId, DbxAnalyticsUserProperties, DbxUserAnalyticsEvent, MixpanelLike, ProvideDbxAnalyticsConfig, ProvideDbxAnalyticsMixpanelModuleConfig, ProvideDbxAnalyticsSegmentModuleConfig };