@corbado/observe 0.1.0 → 0.2.0-next.28-9ea8f5f

package/dist/index.d.mts

@@ -5,7 +5,7 @@ interface SdkInfo {
 type EventType = "predefined" | "custom" | "error" | "identify";
 type AuthMethodType = "identifier-email" | "passkey-login-known-identifier" | "passkey-login-no-identifier" | "passkey-login-cui" | "passkey-enrollment" | "password-login-known-identifier" | "password-login-with-identifier" | "password-enrollment" | "email-otp-login" | "email-otp-enrollment" | "email-link-login" | "email-link-enrollment" | "social-google" | "social-apple" | "social-facebook" | "social-other" | "reset-flow";
 type SubflowType = "passkey-enrollment" | "passkey-login" | "email-otp" | "email-link" | "social-login" | "sms-otp" | "provide-identifier" | "provide-data" | "password-login" | "password-enrollment" | "totp";
-type FlowType = "login" | "signup" | "recovery" | "enrollment";
+type FlowType = "login" | "signup" | "recovery" | "enrollment" | (string & {});
 type SocialLoginProviderType = "google" | "apple" | "facebook" | "github" | "microsoft" | "other";
 declare enum AuthEventName {
     FlowStarted = "flow_started",
@@ -33,6 +33,7 @@ interface BaseEvent {
     contexts?: Record<string, unknown>;
     tags?: Record<string, string>;
     deviceInfo?: DeviceInfo;
+    meta?: EventMeta;
 }
 type UserReference = {
     userId?: string;
@@ -64,7 +65,10 @@ type FlowFinished = {
     explicitOutcome?: "skipped" | "invisible";
 } & UserReference;
 type FlowReset = {
-    flowName: FlowType;
+    flowName?: FlowType;
+};
+type MultiFlowReset = {
+    flowNames: FlowType[];
 };
 type FlowAutoFinished = {
     flowName: FlowType;
@@ -126,10 +130,24 @@ interface CustomEvent extends BaseEvent {
     data?: Record<string, unknown>;
 }
 type Event = PredefinedEvent | CustomEvent;
+interface LowEvent {
+    lowType: string;
+    ts: number;
+    durationMs?: number;
+}
+interface EventBatchMeta {
+    sent: number;
+}
+interface EventMeta {
+    trackingSourcePath: string;
+}
 interface EventBatch {
     sessionId: string;
     events: Event[];
     sdk: SdkInfo;
+    transport?: "fetch" | "beacon";
+    lows?: LowEvent[];
+    meta?: EventBatchMeta;
 }
 type DeviceType = "web" | "app" | "other";
 interface DeviceInfo {
@@ -275,7 +293,7 @@ type PasswordLoginAutoTrackConfig = {
 };
 declare class PasswordLoginOperationFull extends OperationFull {
     readonly postResponse: StepHelper<{}, {}, PasswordLoginTypedError>;
-    private patternDetector?;
+    private lowEventTracker?;
     constructor(tracker: CorbadoTracker, autoTrackConfig?: PasswordLoginAutoTrackConfig);
     destroy(): void;
 }
@@ -291,7 +309,7 @@ type PasswordEnrollmentAutoTrackConfig = {
 };
 declare class PasswordEnrollmentOperationFull extends OperationFull {
     readonly postResponse: StepHelper<{}, {}, PasswordEnrollmentTypedError>;
-    private patternDetector?;
+    private lowEventTracker?;
     constructor(tracker: CorbadoTracker, autoTrackConfig?: PasswordEnrollmentAutoTrackConfig);
     destroy(): void;
 }
@@ -317,7 +335,7 @@ type PasskeyLoginCUIGetOptionsFinished = {
 };
 declare class OperationFullProvideIdentifierWithCUI {
     private tracker;
-    private patternDetector?;
+    private lowEventTracker?;
     readonly cui: {
         trigger: (data: SubflowTrigger, options?: StepOptions) => void;
         getOptions: StepHelper<PasskeyLoginCUIGetOptionsStart, PasskeyLoginCUIGetOptionsFinished>;
@@ -360,6 +378,7 @@ interface TrackerOptions {
     deviceInfoDebounceTime?: number;
     defaultTags?: Record<string, string>;
     applicationId?: string;
+    flushInterval?: number;
 }
 /**
  * @remarks
@@ -391,9 +410,10 @@ declare class CorbadoTracker {
     private isTrackingBlocked;
     private getSessionId;
     private updateDeviceDebounced;
+    private resolveTrackingSourcePath;
     trackSubflowStarted(subflowType: SubflowType, data: Record<string, any>, options?: StepOptions): void;
     trackSubflowTrigger(subflowType: SubflowType, data: Record<string, any>, options?: StepOptions): void;
-    trackSubflowStepStarted(subflowType: SubflowType, stepName: string, data: Record<string, any>, options?: StepOptions): void;
+    trackSubflowStepStarted(subflowType: SubflowType, stepName: string, data: Record<string, any>, options?: StepOptions, ignoreAsInteraction?: boolean): void;
     trackSubflowStepFinished(subflowType: SubflowType, stepName: string, data: Record<string, any>, options?: StepOptions): void;
     trackSubflowStepError(subflowType: SubflowType, stepName: string, data: Record<string, any>, options?: StepOptions): void;
     trackSubflowFinished(subflowType: SubflowType, data: Record<string, any>, options?: StepOptions): void;
@@ -479,7 +499,7 @@ declare class CorbadoTracker {
      * tracker.flowReset({flowName: "login"});
      * ```
      */
-    flowReset(data: FlowReset, tags?: Record<string, string>): void;
+    flowReset(data: FlowReset | MultiFlowReset, tags?: Record<string, string>): void;
     /**
      * Track when a flow is considered finished because another flow finished it implicitly.
      *
@@ -525,6 +545,23 @@ declare class CorbadoTracker {
     authMethodsDecisionFinished(data: AuthMethodDecisionFinished, tags?: Record<string, string>): void;
     authDecisionStarted(data: AuthDecisionStarted): void;
     authDecisionFinished(data: AuthDecisionFinished): void;
+    /**
+     * Enqueue a "low" event (granular DOM/window/visualviewport/PWM signal) for the current session.
+     *
+     * @remarks
+     * Low events are sent in the `lows` array of the events endpoint payload, alongside any
+     * pending typed events. Blocked user agents are skipped silently.
+     *
+     * @internal
+     */
+    enqueueLowEvent(low: LowEvent): void;
+    /**
+     * Synchronously flush any pending events and low events via beacon. Use during page-unload
+     * style teardown where async flushing is unreliable.
+     *
+     * @internal
+     */
+    flushKeepalive(): void;
     passkeyLoginFullOperation(): PasskeyLoginOperationFull;
     passkeyEnrollmentFullOperation(): PasskeyEnrollmentOperationFull;
     passwordLoginFullOperation(autoTrackConfig?: PasswordLoginAutoTrackConfig): PasswordLoginOperationFull;
@@ -564,47 +601,6 @@ interface TransportOptions {
     headers?: Record<string, string>;
 }
 
-interface QueueOptions {
-    batchSize?: number;
-    flushInterval?: number;
-}
-/**
- * @remarks When `window` is defined, `visibilitychange` (when the document becomes hidden) and `pagehide` trigger a synchronous beacon flush (`flushSync`). Any thrown error in that path is logged as "Unexpected error in queue flushSync".
- */
-declare class RequestQueue {
-    private readonly logger;
-    private transport;
-    private sessionId;
-    private readonly sdk;
-    private options;
-    private queue;
-    private timer;
-    private isFlushing;
-    private onVisibilityChange;
-    private onPageHide;
-    constructor(logger: Logger, transport: Transport, sessionId: string, sdk: SdkInfo, options?: QueueOptions);
-    setSessionId(sessionId: string): void;
-    /**
-     * Error situations:
-     *  - Any error while enqueueing or scheduling flush (including a synchronous throw from `flush`): log "Failed to enqueue event"
-     */
-    enqueue(event: Event): void;
-    /**
-     * Error situations:
-     *  - Queue is empty: return without calling transport.send
-     *  - A flush is already in progress: return without calling transport.send again
-     *  - transport.send rejects or throws, or any other error in the try block: log "Unexpected error in queue flush"
-     */
-    flush(): Promise<void>;
-    private setupLifecycleHooks;
-    private flushSync;
-    /**
-     * Error situations:
-     *  - Timer clearance or event listener removal throws: log "Failed to destroy queue lifecycle hooks"
-     */
-    destroy(): void;
-}
-
 interface StorageEngine {
     getItem<T>(key: string): T | null;
     setItem<T>(key: string, value: T): void;
@@ -685,9 +681,64 @@ declare class SessionStorage implements StorageEngine {
     removeItem(key: string): void;
 }
 
+interface QueueOptions {
+    batchSize?: number;
+    flushInterval?: number;
+    debug?: boolean;
+}
+/**
+ * @remarks When `window` is defined, `visibilitychange` (when the document becomes hidden) and `pagehide` trigger a synchronous beacon flush (`flushSync`). Any thrown error in that path is logged as "Unexpected error in queue flushSync".
+ */
+declare class RequestQueue {
+    private readonly logger;
+    private transport;
+    private sessionId;
+    private readonly sdk;
+    private options;
+    private readonly storage?;
+    private queue;
+    private lowsQueue;
+    private timer;
+    private isFlushing;
+    private onVisibilityChange;
+    private onPageHide;
+    constructor(logger: Logger, transport: Transport, sessionId: string, sdk: SdkInfo, options?: QueueOptions, storage?: StorageEngine | undefined);
+    setSessionId(sessionId: string): void;
+    /**
+     * Error situations:
+     *  - Any error while enqueueing or scheduling flush (including a synchronous throw from `flush`): log "Failed to enqueue event"
+     */
+    enqueue(event: Event): void;
+    /**
+     * Error situations:
+     *  - Any error while enqueueing or scheduling flush (including a synchronous throw from `flush`): log "Failed to enqueue low event"
+     */
+    enqueueLow(low: LowEvent): void;
+    /**
+     * Error situations:
+     *  - Queue is empty: return without calling transport.send
+     *  - A flush is already in progress: return without calling transport.send again
+     *  - transport.send rejects or throws, or any other error in the try block: log "Unexpected error in queue flush"
+     */
+    flush(): Promise<void>;
+    private setupLifecycleHooks;
+    private writeLifecycleDebugOutput;
+    /**
+     * Synchronously flush both events and lows via `sendBeacon` if the transport supports it.
+     * Safe to call multiple times: a no-op when both queues are empty.
+     */
+    flushKeepalive(): void;
+    private flushSync;
+    /**
+     * Error situations:
+     *  - Timer clearance or event listener removal throws: log "Failed to destroy queue lifecycle hooks"
+     */
+    destroy(): void;
+}
+
 declare function init(options: TrackerOptions): CorbadoTracker;
 declare function getTracker(): CorbadoTracker | undefined;
 declare function resetSession(): string | undefined;
 declare function destroy(): Promise<void>;
 
-export { type AuthDecisionFinished, type AuthDecisionStarted, AuthEventName, type AuthMethodDecisionFinished, type AuthMethodDecisionStarted, type AuthMethodType, type BaseEvent, type ClientCapabilities, type ClientEnvHandleMeta, type ClientEnvHandleMetaSource, CookieStorage, CorbadoTracker, type CreateLoggerOptions, type CustomEvent, type DeviceInfo, type DeviceInfoDataWeb, type DeviceType, EmailLinkOperationFull, type EmailLinkOperationPostResponseStart, type EmailLinkOperationSendStart, type EmailLinkOperationSpecType, type EmailOTPOperationPostResponseStart, type EmailOTPOperationSendOTPStart, type EmailOTPOperationSpecType, EmailOtpOperationFull, type Event, type EventBatch, type EventType, type FlowAutoFinished, type FlowDecided, type FlowFinished, type FlowReset, type FlowStarted, type FlowType, type JavaScriptHighEntropy, LocalStorage, type Logger, type MultiFlowStarted, type NormalizedError, OperationFull, OperationFullProvideIdentifierWithCUI, type PasskeyEnrollmentCeremonyFinished, type PasskeyEnrollmentCeremonyStart, type PasskeyEnrollmentGetOptionsFinished, type PasskeyEnrollmentGetOptionsStart, PasskeyEnrollmentOperationFull, type PasskeyLoginCUIGetOptionsFinished, type PasskeyLoginCUIGetOptionsStart, type PasskeyLoginCUISpecType, type PasskeyLoginCeremonyFinished, type PasskeyLoginCeremonyStart, type PasskeyLoginClientError, type PasskeyLoginFinish, type PasskeyLoginGetOptionsFinished, type PasskeyLoginGetOptionsStart, PasskeyLoginOperationFull, type PasskeyLoginStartable, type PasskeyLoginSubmitted, type PasskeyOperationEnrollmentExplicitSpecType, type PasskeyOperationLoginExplicitSpecType, type PasswordEnrollmentAutoTrackConfig, PasswordEnrollmentOperationFull, type PasswordEnrollmentTypedError, type PasswordLoginAutoTrackConfig, PasswordLoginOperationFull, type PasswordLoginTypedError, type PredefinedEvent, type ProvideIdentifierError, type ProvideIdentifierFinish, type ProvideIdentifierPostResponseStart, type ProvideIdentifierSpecType, type ProvideIdentifierStart, type QueueOptions, RequestQueue, SDK_NAME, SDK_VERSION, type SdkInfo, SessionStorage, type SocialLoginExchangeCodeFinished, type SocialLoginExchangeCodeStart, type SocialLoginGetRedirectUrlFinished, type SocialLoginGetRedirectUrlStart, SocialLoginOperationFull, type SocialLoginProviderType, type SocialLoginSpecType, type StepHelper, type StepOptions, type StorageEngine, type SubflowTrigger, type SubflowType, type TrackerOptions, type Transport, type TransportMakeRequestResponse, type TransportOptions, type UserReference, createLogger, destroy, getTracker, init, resetSession };
+export { type AuthDecisionFinished, type AuthDecisionStarted, AuthEventName, type AuthMethodDecisionFinished, type AuthMethodDecisionStarted, type AuthMethodType, type BaseEvent, type ClientCapabilities, type ClientEnvHandleMeta, type ClientEnvHandleMetaSource, CookieStorage, CorbadoTracker, type CreateLoggerOptions, type CustomEvent, type DeviceInfo, type DeviceInfoDataWeb, type DeviceType, EmailLinkOperationFull, type EmailLinkOperationPostResponseStart, type EmailLinkOperationSendStart, type EmailLinkOperationSpecType, type EmailOTPOperationPostResponseStart, type EmailOTPOperationSendOTPStart, type EmailOTPOperationSpecType, EmailOtpOperationFull, type Event, type EventBatch, type EventBatchMeta, type EventMeta, type EventType, type FlowAutoFinished, type FlowDecided, type FlowFinished, type FlowReset, type FlowStarted, type FlowType, type JavaScriptHighEntropy, LocalStorage, type Logger, type LowEvent, type MultiFlowReset, type MultiFlowStarted, type NormalizedError, OperationFull, OperationFullProvideIdentifierWithCUI, type PasskeyEnrollmentCeremonyFinished, type PasskeyEnrollmentCeremonyStart, type PasskeyEnrollmentGetOptionsFinished, type PasskeyEnrollmentGetOptionsStart, PasskeyEnrollmentOperationFull, type PasskeyLoginCUIGetOptionsFinished, type PasskeyLoginCUIGetOptionsStart, type PasskeyLoginCUISpecType, type PasskeyLoginCeremonyFinished, type PasskeyLoginCeremonyStart, type PasskeyLoginClientError, type PasskeyLoginFinish, type PasskeyLoginGetOptionsFinished, type PasskeyLoginGetOptionsStart, PasskeyLoginOperationFull, type PasskeyLoginStartable, type PasskeyLoginSubmitted, type PasskeyOperationEnrollmentExplicitSpecType, type PasskeyOperationLoginExplicitSpecType, type PasswordEnrollmentAutoTrackConfig, PasswordEnrollmentOperationFull, type PasswordEnrollmentTypedError, type PasswordLoginAutoTrackConfig, PasswordLoginOperationFull, type PasswordLoginTypedError, type PredefinedEvent, type ProvideIdentifierError, type ProvideIdentifierFinish, type ProvideIdentifierPostResponseStart, type ProvideIdentifierSpecType, type ProvideIdentifierStart, type QueueOptions, RequestQueue, SDK_NAME, SDK_VERSION, type SdkInfo, SessionStorage, type SocialLoginExchangeCodeFinished, type SocialLoginExchangeCodeStart, type SocialLoginGetRedirectUrlFinished, type SocialLoginGetRedirectUrlStart, SocialLoginOperationFull, type SocialLoginProviderType, type SocialLoginSpecType, type StepHelper, type StepOptions, type StorageEngine, type SubflowTrigger, type SubflowType, type TrackerOptions, type Transport, type TransportMakeRequestResponse, type TransportOptions, type UserReference, createLogger, destroy, getTracker, init, resetSession };

package/dist/index.d.ts

@@ -5,7 +5,7 @@ interface SdkInfo {
 type EventType = "predefined" | "custom" | "error" | "identify";
 type AuthMethodType = "identifier-email" | "passkey-login-known-identifier" | "passkey-login-no-identifier" | "passkey-login-cui" | "passkey-enrollment" | "password-login-known-identifier" | "password-login-with-identifier" | "password-enrollment" | "email-otp-login" | "email-otp-enrollment" | "email-link-login" | "email-link-enrollment" | "social-google" | "social-apple" | "social-facebook" | "social-other" | "reset-flow";
 type SubflowType = "passkey-enrollment" | "passkey-login" | "email-otp" | "email-link" | "social-login" | "sms-otp" | "provide-identifier" | "provide-data" | "password-login" | "password-enrollment" | "totp";
-type FlowType = "login" | "signup" | "recovery" | "enrollment";
+type FlowType = "login" | "signup" | "recovery" | "enrollment" | (string & {});
 type SocialLoginProviderType = "google" | "apple" | "facebook" | "github" | "microsoft" | "other";
 declare enum AuthEventName {
     FlowStarted = "flow_started",
@@ -33,6 +33,7 @@ interface BaseEvent {
     contexts?: Record<string, unknown>;
     tags?: Record<string, string>;
     deviceInfo?: DeviceInfo;
+    meta?: EventMeta;
 }
 type UserReference = {
     userId?: string;
@@ -64,7 +65,10 @@ type FlowFinished = {
     explicitOutcome?: "skipped" | "invisible";
 } & UserReference;
 type FlowReset = {
-    flowName: FlowType;
+    flowName?: FlowType;
+};
+type MultiFlowReset = {
+    flowNames: FlowType[];
 };
 type FlowAutoFinished = {
     flowName: FlowType;
@@ -126,10 +130,24 @@ interface CustomEvent extends BaseEvent {
     data?: Record<string, unknown>;
 }
 type Event = PredefinedEvent | CustomEvent;
+interface LowEvent {
+    lowType: string;
+    ts: number;
+    durationMs?: number;
+}
+interface EventBatchMeta {
+    sent: number;
+}
+interface EventMeta {
+    trackingSourcePath: string;
+}
 interface EventBatch {
     sessionId: string;
     events: Event[];
     sdk: SdkInfo;
+    transport?: "fetch" | "beacon";
+    lows?: LowEvent[];
+    meta?: EventBatchMeta;
 }
 type DeviceType = "web" | "app" | "other";
 interface DeviceInfo {
@@ -275,7 +293,7 @@ type PasswordLoginAutoTrackConfig = {
 };
 declare class PasswordLoginOperationFull extends OperationFull {
     readonly postResponse: StepHelper<{}, {}, PasswordLoginTypedError>;
-    private patternDetector?;
+    private lowEventTracker?;
     constructor(tracker: CorbadoTracker, autoTrackConfig?: PasswordLoginAutoTrackConfig);
     destroy(): void;
 }
@@ -291,7 +309,7 @@ type PasswordEnrollmentAutoTrackConfig = {
 };
 declare class PasswordEnrollmentOperationFull extends OperationFull {
     readonly postResponse: StepHelper<{}, {}, PasswordEnrollmentTypedError>;
-    private patternDetector?;
+    private lowEventTracker?;
     constructor(tracker: CorbadoTracker, autoTrackConfig?: PasswordEnrollmentAutoTrackConfig);
     destroy(): void;
 }
@@ -317,7 +335,7 @@ type PasskeyLoginCUIGetOptionsFinished = {
 };
 declare class OperationFullProvideIdentifierWithCUI {
     private tracker;
-    private patternDetector?;
+    private lowEventTracker?;
     readonly cui: {
         trigger: (data: SubflowTrigger, options?: StepOptions) => void;
         getOptions: StepHelper<PasskeyLoginCUIGetOptionsStart, PasskeyLoginCUIGetOptionsFinished>;
@@ -360,6 +378,7 @@ interface TrackerOptions {
     deviceInfoDebounceTime?: number;
     defaultTags?: Record<string, string>;
     applicationId?: string;
+    flushInterval?: number;
 }
 /**
  * @remarks
@@ -391,9 +410,10 @@ declare class CorbadoTracker {
     private isTrackingBlocked;
     private getSessionId;
     private updateDeviceDebounced;
+    private resolveTrackingSourcePath;
     trackSubflowStarted(subflowType: SubflowType, data: Record<string, any>, options?: StepOptions): void;
     trackSubflowTrigger(subflowType: SubflowType, data: Record<string, any>, options?: StepOptions): void;
-    trackSubflowStepStarted(subflowType: SubflowType, stepName: string, data: Record<string, any>, options?: StepOptions): void;
+    trackSubflowStepStarted(subflowType: SubflowType, stepName: string, data: Record<string, any>, options?: StepOptions, ignoreAsInteraction?: boolean): void;
     trackSubflowStepFinished(subflowType: SubflowType, stepName: string, data: Record<string, any>, options?: StepOptions): void;
     trackSubflowStepError(subflowType: SubflowType, stepName: string, data: Record<string, any>, options?: StepOptions): void;
     trackSubflowFinished(subflowType: SubflowType, data: Record<string, any>, options?: StepOptions): void;
@@ -479,7 +499,7 @@ declare class CorbadoTracker {
      * tracker.flowReset({flowName: "login"});
      * ```
      */
-    flowReset(data: FlowReset, tags?: Record<string, string>): void;
+    flowReset(data: FlowReset | MultiFlowReset, tags?: Record<string, string>): void;
     /**
      * Track when a flow is considered finished because another flow finished it implicitly.
      *
@@ -525,6 +545,23 @@ declare class CorbadoTracker {
     authMethodsDecisionFinished(data: AuthMethodDecisionFinished, tags?: Record<string, string>): void;
     authDecisionStarted(data: AuthDecisionStarted): void;
     authDecisionFinished(data: AuthDecisionFinished): void;
+    /**
+     * Enqueue a "low" event (granular DOM/window/visualviewport/PWM signal) for the current session.
+     *
+     * @remarks
+     * Low events are sent in the `lows` array of the events endpoint payload, alongside any
+     * pending typed events. Blocked user agents are skipped silently.
+     *
+     * @internal
+     */
+    enqueueLowEvent(low: LowEvent): void;
+    /**
+     * Synchronously flush any pending events and low events via beacon. Use during page-unload
+     * style teardown where async flushing is unreliable.
+     *
+     * @internal
+     */
+    flushKeepalive(): void;
     passkeyLoginFullOperation(): PasskeyLoginOperationFull;
     passkeyEnrollmentFullOperation(): PasskeyEnrollmentOperationFull;
     passwordLoginFullOperation(autoTrackConfig?: PasswordLoginAutoTrackConfig): PasswordLoginOperationFull;
@@ -564,47 +601,6 @@ interface TransportOptions {
     headers?: Record<string, string>;
 }
 
-interface QueueOptions {
-    batchSize?: number;
-    flushInterval?: number;
-}
-/**
- * @remarks When `window` is defined, `visibilitychange` (when the document becomes hidden) and `pagehide` trigger a synchronous beacon flush (`flushSync`). Any thrown error in that path is logged as "Unexpected error in queue flushSync".
- */
-declare class RequestQueue {
-    private readonly logger;
-    private transport;
-    private sessionId;
-    private readonly sdk;
-    private options;
-    private queue;
-    private timer;
-    private isFlushing;
-    private onVisibilityChange;
-    private onPageHide;
-    constructor(logger: Logger, transport: Transport, sessionId: string, sdk: SdkInfo, options?: QueueOptions);
-    setSessionId(sessionId: string): void;
-    /**
-     * Error situations:
-     *  - Any error while enqueueing or scheduling flush (including a synchronous throw from `flush`): log "Failed to enqueue event"
-     */
-    enqueue(event: Event): void;
-    /**
-     * Error situations:
-     *  - Queue is empty: return without calling transport.send
-     *  - A flush is already in progress: return without calling transport.send again
-     *  - transport.send rejects or throws, or any other error in the try block: log "Unexpected error in queue flush"
-     */
-    flush(): Promise<void>;
-    private setupLifecycleHooks;
-    private flushSync;
-    /**
-     * Error situations:
-     *  - Timer clearance or event listener removal throws: log "Failed to destroy queue lifecycle hooks"
-     */
-    destroy(): void;
-}
-
 interface StorageEngine {
     getItem<T>(key: string): T | null;
     setItem<T>(key: string, value: T): void;
@@ -685,9 +681,64 @@ declare class SessionStorage implements StorageEngine {
     removeItem(key: string): void;
 }
 
+interface QueueOptions {
+    batchSize?: number;
+    flushInterval?: number;
+    debug?: boolean;
+}
+/**
+ * @remarks When `window` is defined, `visibilitychange` (when the document becomes hidden) and `pagehide` trigger a synchronous beacon flush (`flushSync`). Any thrown error in that path is logged as "Unexpected error in queue flushSync".
+ */
+declare class RequestQueue {
+    private readonly logger;
+    private transport;
+    private sessionId;
+    private readonly sdk;
+    private options;
+    private readonly storage?;
+    private queue;
+    private lowsQueue;
+    private timer;
+    private isFlushing;
+    private onVisibilityChange;
+    private onPageHide;
+    constructor(logger: Logger, transport: Transport, sessionId: string, sdk: SdkInfo, options?: QueueOptions, storage?: StorageEngine | undefined);
+    setSessionId(sessionId: string): void;
+    /**
+     * Error situations:
+     *  - Any error while enqueueing or scheduling flush (including a synchronous throw from `flush`): log "Failed to enqueue event"
+     */
+    enqueue(event: Event): void;
+    /**
+     * Error situations:
+     *  - Any error while enqueueing or scheduling flush (including a synchronous throw from `flush`): log "Failed to enqueue low event"
+     */
+    enqueueLow(low: LowEvent): void;
+    /**
+     * Error situations:
+     *  - Queue is empty: return without calling transport.send
+     *  - A flush is already in progress: return without calling transport.send again
+     *  - transport.send rejects or throws, or any other error in the try block: log "Unexpected error in queue flush"
+     */
+    flush(): Promise<void>;
+    private setupLifecycleHooks;
+    private writeLifecycleDebugOutput;
+    /**
+     * Synchronously flush both events and lows via `sendBeacon` if the transport supports it.
+     * Safe to call multiple times: a no-op when both queues are empty.
+     */
+    flushKeepalive(): void;
+    private flushSync;
+    /**
+     * Error situations:
+     *  - Timer clearance or event listener removal throws: log "Failed to destroy queue lifecycle hooks"
+     */
+    destroy(): void;
+}
+
 declare function init(options: TrackerOptions): CorbadoTracker;
 declare function getTracker(): CorbadoTracker | undefined;
 declare function resetSession(): string | undefined;
 declare function destroy(): Promise<void>;
 
-export { type AuthDecisionFinished, type AuthDecisionStarted, AuthEventName, type AuthMethodDecisionFinished, type AuthMethodDecisionStarted, type AuthMethodType, type BaseEvent, type ClientCapabilities, type ClientEnvHandleMeta, type ClientEnvHandleMetaSource, CookieStorage, CorbadoTracker, type CreateLoggerOptions, type CustomEvent, type DeviceInfo, type DeviceInfoDataWeb, type DeviceType, EmailLinkOperationFull, type EmailLinkOperationPostResponseStart, type EmailLinkOperationSendStart, type EmailLinkOperationSpecType, type EmailOTPOperationPostResponseStart, type EmailOTPOperationSendOTPStart, type EmailOTPOperationSpecType, EmailOtpOperationFull, type Event, type EventBatch, type EventType, type FlowAutoFinished, type FlowDecided, type FlowFinished, type FlowReset, type FlowStarted, type FlowType, type JavaScriptHighEntropy, LocalStorage, type Logger, type MultiFlowStarted, type NormalizedError, OperationFull, OperationFullProvideIdentifierWithCUI, type PasskeyEnrollmentCeremonyFinished, type PasskeyEnrollmentCeremonyStart, type PasskeyEnrollmentGetOptionsFinished, type PasskeyEnrollmentGetOptionsStart, PasskeyEnrollmentOperationFull, type PasskeyLoginCUIGetOptionsFinished, type PasskeyLoginCUIGetOptionsStart, type PasskeyLoginCUISpecType, type PasskeyLoginCeremonyFinished, type PasskeyLoginCeremonyStart, type PasskeyLoginClientError, type PasskeyLoginFinish, type PasskeyLoginGetOptionsFinished, type PasskeyLoginGetOptionsStart, PasskeyLoginOperationFull, type PasskeyLoginStartable, type PasskeyLoginSubmitted, type PasskeyOperationEnrollmentExplicitSpecType, type PasskeyOperationLoginExplicitSpecType, type PasswordEnrollmentAutoTrackConfig, PasswordEnrollmentOperationFull, type PasswordEnrollmentTypedError, type PasswordLoginAutoTrackConfig, PasswordLoginOperationFull, type PasswordLoginTypedError, type PredefinedEvent, type ProvideIdentifierError, type ProvideIdentifierFinish, type ProvideIdentifierPostResponseStart, type ProvideIdentifierSpecType, type ProvideIdentifierStart, type QueueOptions, RequestQueue, SDK_NAME, SDK_VERSION, type SdkInfo, SessionStorage, type SocialLoginExchangeCodeFinished, type SocialLoginExchangeCodeStart, type SocialLoginGetRedirectUrlFinished, type SocialLoginGetRedirectUrlStart, SocialLoginOperationFull, type SocialLoginProviderType, type SocialLoginSpecType, type StepHelper, type StepOptions, type StorageEngine, type SubflowTrigger, type SubflowType, type TrackerOptions, type Transport, type TransportMakeRequestResponse, type TransportOptions, type UserReference, createLogger, destroy, getTracker, init, resetSession };
+export { type AuthDecisionFinished, type AuthDecisionStarted, AuthEventName, type AuthMethodDecisionFinished, type AuthMethodDecisionStarted, type AuthMethodType, type BaseEvent, type ClientCapabilities, type ClientEnvHandleMeta, type ClientEnvHandleMetaSource, CookieStorage, CorbadoTracker, type CreateLoggerOptions, type CustomEvent, type DeviceInfo, type DeviceInfoDataWeb, type DeviceType, EmailLinkOperationFull, type EmailLinkOperationPostResponseStart, type EmailLinkOperationSendStart, type EmailLinkOperationSpecType, type EmailOTPOperationPostResponseStart, type EmailOTPOperationSendOTPStart, type EmailOTPOperationSpecType, EmailOtpOperationFull, type Event, type EventBatch, type EventBatchMeta, type EventMeta, type EventType, type FlowAutoFinished, type FlowDecided, type FlowFinished, type FlowReset, type FlowStarted, type FlowType, type JavaScriptHighEntropy, LocalStorage, type Logger, type LowEvent, type MultiFlowReset, type MultiFlowStarted, type NormalizedError, OperationFull, OperationFullProvideIdentifierWithCUI, type PasskeyEnrollmentCeremonyFinished, type PasskeyEnrollmentCeremonyStart, type PasskeyEnrollmentGetOptionsFinished, type PasskeyEnrollmentGetOptionsStart, PasskeyEnrollmentOperationFull, type PasskeyLoginCUIGetOptionsFinished, type PasskeyLoginCUIGetOptionsStart, type PasskeyLoginCUISpecType, type PasskeyLoginCeremonyFinished, type PasskeyLoginCeremonyStart, type PasskeyLoginClientError, type PasskeyLoginFinish, type PasskeyLoginGetOptionsFinished, type PasskeyLoginGetOptionsStart, PasskeyLoginOperationFull, type PasskeyLoginStartable, type PasskeyLoginSubmitted, type PasskeyOperationEnrollmentExplicitSpecType, type PasskeyOperationLoginExplicitSpecType, type PasswordEnrollmentAutoTrackConfig, PasswordEnrollmentOperationFull, type PasswordEnrollmentTypedError, type PasswordLoginAutoTrackConfig, PasswordLoginOperationFull, type PasswordLoginTypedError, type PredefinedEvent, type ProvideIdentifierError, type ProvideIdentifierFinish, type ProvideIdentifierPostResponseStart, type ProvideIdentifierSpecType, type ProvideIdentifierStart, type QueueOptions, RequestQueue, SDK_NAME, SDK_VERSION, type SdkInfo, SessionStorage, type SocialLoginExchangeCodeFinished, type SocialLoginExchangeCodeStart, type SocialLoginGetRedirectUrlFinished, type SocialLoginGetRedirectUrlStart, SocialLoginOperationFull, type SocialLoginProviderType, type SocialLoginSpecType, type StepHelper, type StepOptions, type StorageEngine, type SubflowTrigger, type SubflowType, type TrackerOptions, type Transport, type TransportMakeRequestResponse, type TransportOptions, type UserReference, createLogger, destroy, getTracker, init, resetSession };