@backtrack-js/browser 0.4.0

package/dist/storage/batch-writer.d.ts

@@ -0,0 +1,57 @@
+import type { FlightRecorderDB } from './db';
+import type { StoredChunk, RrwebEvent } from '../types/chunk';
+import type { TimelineEvent } from '../types/timeline';
+export interface FlushMetrics {
+    flushIndex: number;
+    durationMs: number;
+    serializationMs: number;
+    compressionMs: number;
+    writeMs: number;
+    chunkSizeBytes: number;
+    replayEventsInBatch: number;
+    timelineEventsInBatch: number;
+    totalReplayInChunk: number;
+    totalTimelineInChunk: number;
+    totalEventsInChunk: number;
+    timestamp: number;
+}
+export interface BatchWriterConfig {
+    flushIntervalMs: number;
+    maxBatchEvents: number;
+    chunkDurationMs: number;
+    initialChunkSequence?: number;
+    onFlushMetrics?: (metrics: FlushMetrics) => void;
+}
+export declare class BatchWriter {
+    private db;
+    private config;
+    private sessionId;
+    private tabId;
+    private chunkSequence;
+    private pendingTimelineEvents;
+    private pendingReplayEvents;
+    private timer;
+    private writeChain;
+    private pendingWritesCount;
+    private onErrorCallback?;
+    private onChunkPersistedCallback?;
+    private pageHideHandler?;
+    private visibilityChangeHandler?;
+    private flushCount;
+    private onFlushMetricsCallback?;
+    constructor(db: FlightRecorderDB, sessionId: string, tabId: string, config?: Partial<BatchWriterConfig>, onError?: (error: unknown) => void);
+    getChunkSequence(): number;
+    setOnFlushMetrics(callback: (metrics: FlushMetrics) => void): void;
+    setOnChunkPersisted(callback: (chunk: StoredChunk) => void): void;
+    getPendingWrites(): number;
+    addTimelineEvent(event: TimelineEvent): void;
+    addReplayEvent(event: RrwebEvent): void;
+    private checkThresholds;
+    /**
+     * Força a gravação de todos os eventos pendentes no IndexedDB.
+     */
+    flush(): Promise<void>;
+    private initLifecycleListeners;
+    destroy(): void;
+}
+//# sourceMappingURL=batch-writer.d.ts.map

package/dist/storage/batch-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-writer.d.ts","sourceRoot":"","sources":["../../src/storage/batch-writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGvD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,CAAC;CAClD;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAAS;IAEtB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,qBAAqB,CAAuB;IACpD,OAAO,CAAC,mBAAmB,CAAoB;IAE/C,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,eAAe,CAAC,CAA2B;IACnD,OAAO,CAAC,wBAAwB,CAAC,CAA+B;IAChE,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,uBAAuB,CAAC,CAAa;IAC7C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,sBAAsB,CAAC,CAAkC;gBAG/D,EAAE,EAAE,gBAAgB,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,EACnC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI;IAmB7B,gBAAgB,IAAI,MAAM;IAI1B,iBAAiB,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAIlE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAIjE,gBAAgB,IAAI,MAAM;IAI1B,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAK5C,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAK9C,OAAO,CAAC,eAAe;IAYvB;;OAEG;IACI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6H7B,OAAO,CAAC,sBAAsB;IAkBvB,OAAO,IAAI,IAAI;CAsBvB"}

package/dist/storage/db.d.ts

@@ -0,0 +1,39 @@
+import type { StoredChunk } from '../types/chunk';
+import type { StoredIncident, IncidentSummary } from '../types/incident';
+export interface StoredSession {
+    id: string;
+    tabId: string;
+    startedAt: number;
+    lastActiveAt: number;
+}
+export declare const DB_NAME = "backtrack_db";
+export declare const DB_VERSION = 1;
+export declare const STORE_SESSIONS = "sessions";
+export declare const STORE_CHUNKS = "chunks";
+export declare const STORE_INCIDENTS = "incidents";
+export declare class FlightRecorderDB {
+    private db;
+    private idbFactory;
+    private dbName;
+    constructor(customFactory?: IDBFactory, customDbName?: string);
+    open(): Promise<IDBDatabase>;
+    close(): void;
+    putSession(session: StoredSession): Promise<void>;
+    getSession(id: string): Promise<StoredSession | null>;
+    putChunk(chunk: StoredChunk): Promise<void>;
+    putChunks(chunks: StoredChunk[]): Promise<void>;
+    getChunk(id: string): Promise<StoredChunk | null>;
+    getChunksByIds(ids: string[]): Promise<StoredChunk[]>;
+    getChunksBySession(sessionId: string): Promise<StoredChunk[]>;
+    getAllChunks(): Promise<StoredChunk[]>;
+    deleteChunks(ids: string[]): Promise<void>;
+    putIncident(incident: StoredIncident): Promise<void>;
+    getIncident(id: string): Promise<StoredIncident | null>;
+    getPendingIncidentForSession(sessionId: string): Promise<StoredIncident | null>;
+    listIncidents(): Promise<IncidentSummary[]>;
+    deleteIncident(id: string): Promise<void>;
+    getAllIncidents(): Promise<StoredIncident[]>;
+    estimateStorageBytes(): Promise<number>;
+    clearAll(): Promise<void>;
+}
+//# sourceMappingURL=db.d.ts.map

package/dist/storage/db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/storage/db.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,OAAO,iBAAiB,CAAC;AACtC,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,YAAY,WAAW,CAAC;AACrC,eAAO,MAAM,eAAe,cAAc,CAAC;AAE3C,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAEX,aAAa,CAAC,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,MAAM;IAOhD,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC;IAmDlC,KAAK,IAAI,IAAI;IASP,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAUjD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAYrD,QAAQ,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAc/C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAUjD,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAqBrD,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAe7D,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAUtC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB1C,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAUvD,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAe/E,aAAa,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAuB3C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzC,eAAe,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAY5C,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAWvC"}

package/dist/storage/incident-manager.d.ts

@@ -0,0 +1,107 @@
+import type { FlightRecorderDB } from './db';
+import type { StoredIncident, IncidentReason, IncidentTrigger, IncidentSummary } from '../types/incident';
+import type { RrwebEvent } from '../types/chunk';
+import type { FlightRecorderArtifact, EnvironmentMetadata, ReplayWindowMetadata } from '../types/artifact';
+import type { ObservabilityContext } from '../types/options';
+export interface IncidentManagerConfig {
+    afterErrorSeconds: number;
+    recorderVersion: string;
+    getRecordingIssues?: () => string[];
+    getDroppedEventsCount?: () => number;
+    context?: ObservabilityContext;
+    getContext?: () => ObservabilityContext | Promise<ObservabilityContext>;
+}
+export declare function generateIncidentId(prefix: 'inc' | 'inc_manual', sessionId: string, timestamp: number): string;
+export interface SlicedReplayResult {
+    events: RrwebEvent[];
+    replayWindow: ReplayWindowMetadata;
+    degradedReasons: string[];
+}
+/**
+ * Fatia e ajusta os eventos de replay para que caibam estritamente na janela [startedAt, finalizedAt],
+ * garantindo que o FullSnapshot inicial (type: 2) mais recente seja reposicionado no início
+ * da janela (com seu Meta type: 4 correspondente).
+ *
+ * Também gera metadados explícitos da janela de replay (replayWindow) para diferenciar eventos
+ * preparatórios de eventos reais da janela solicitada.
+ */
+export declare function sliceReplayEventsWithMetadata(events: RrwebEvent[], startedAt: number, finalizedAt: number): SlicedReplayResult;
+export declare function sliceReplayEventsForWindow(events: RrwebEvent[], startedAt: number, finalizedAt: number): RrwebEvent[];
+export declare class IncidentManager {
+    private db;
+    private sessionId;
+    private tabId;
+    private environmentProvider;
+    private fallbackEnvironment;
+    private config;
+    private pendingIncident;
+    private hasExtendedOnce;
+    private finalizeTimer;
+    private onIncidentPendingCallback?;
+    private onIncidentFinalizedCallback?;
+    private beforeFinalizeCallback?;
+    private onErrorCallback?;
+    private activeOperation;
+    private recoveredBaseIncidentId?;
+    private baseRecoveredDroppedEvents;
+    constructor(db: FlightRecorderDB, sessionId: string, tabId: string, environment: EnvironmentMetadata | (() => EnvironmentMetadata), config?: Partial<IncidentManagerConfig>);
+    private getEnvironment;
+    private resolveFallbackEnvironment;
+    private isDestroyed;
+    private serializeOperation;
+    runExclusive<T>(op: () => Promise<T>): Promise<T>;
+    private computeCurrentDroppedEvents;
+    /**
+     * Sincroniza a contagem atual de eventos descartados no incidente pendente (se houver)
+     * antes de parar, descarregar a página ou executar retenção.
+     */
+    syncPendingIncidentDroppedEvents(): Promise<void>;
+    /**
+     * Associa todos os chunks persistidos da sessão atual ao incidente pendente (se houver),
+     * garantindo que eles estejam protegidos no IndexedDB antes da execução de qualquer prune.
+     */
+    protectSessionChunks(): Promise<void>;
+    setOnError(callback: (error: unknown) => void): void;
+    setOnIncidentPending(callback: (incident: StoredIncident) => void): void;
+    setOnIncidentFinalized(callback: (incident: StoredIncident) => void): void;
+    setBeforeFinalize(callback: () => Promise<void>): void;
+    getPendingIncident(): StoredIncident | null;
+    /**
+     * Inicialização e recuperação pós-reload:
+     * Verifica se há incidente pendente para esta sessão no IndexedDB.
+     */
+    init(): Promise<void>;
+    /**
+     * Registra um gatilho de incidente (automático ou manual).
+     * As chamadas são serializadas para evitar race conditions entre múltiplos erros concorrentes.
+     */
+    trigger(reason: IncidentReason, triggerData: IncidentTrigger, windowSeconds?: number): Promise<string>;
+    private executeTrigger;
+    /**
+     * Obtém os timestamps reais de todos os FullSnapshots (rrweb type: 2) de um chunk.
+     * Não fabrica timestamps usando chunk.startedAt quando apenas a flag hasFullSnapshot está presente.
+     */
+    private getChunkSnapshotTimestamps;
+    private createAndFinalizeManualIncident;
+    executeManualTrigger(triggerData: IncidentTrigger, windowSeconds?: number): Promise<string>;
+    /**
+     * Finaliza um incidente pendente.
+     */
+    finalize(incidentId: string): Promise<void>;
+    private executeFinalize;
+    /**
+     * Exporta um incidente em um artefato canônico v1 (.ffr.json).
+     */
+    exportArtifact(incidentId: string): Promise<FlightRecorderArtifact>;
+    listIncidents(): Promise<IncidentSummary[]>;
+    deleteIncident(incidentId: string): Promise<void>;
+    private executeDeleteIncident;
+    /**
+     * Reseta o estado em memória do gerenciador de incidentes:
+     * cancela timer de finalização e descarta incidente pendente.
+     * Serializado para aguardar operações em andamento.
+     */
+    reset(): Promise<void>;
+    destroy(): Promise<void>;
+}
+//# sourceMappingURL=incident-manager.d.ts.map

package/dist/storage/incident-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident-manager.d.ts","sourceRoot":"","sources":["../../src/storage/incident-manager.ts"],"names":[],"mappings":"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"}

package/dist/storage/index.d.ts

@@ -0,0 +1,6 @@
+export * from './session';
+export * from './db';
+export * from './retention';
+export * from './batch-writer';
+export * from './incident-manager';
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,MAAM,CAAC;AACrB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC"}

package/dist/storage/retention.d.ts

@@ -0,0 +1,41 @@
+import type { FlightRecorderDB } from './db';
+export interface RetentionConfig {
+    bufferMinutes: number;
+    maxStorageMb: number;
+}
+export interface PruneResult {
+    deletedChunkIds: string[];
+    reclaimedBytes: number;
+    remainingBytes: number;
+}
+export declare class RetentionEngine {
+    private db;
+    private config;
+    constructor(db: FlightRecorderDB, config?: Partial<RetentionConfig>);
+    /**
+     * Executa limpeza de retenção:
+     * 1. Protege todos os chunks vinculados a incidentes (pendentes ou finalizados).
+     * 2. Exclui chunks não protegidos expirados pelo tempo (bufferMinutes).
+     * 3. Se exceder maxStorageMb, exclui os chunks não protegidos mais antigos.
+     */
+    prune(now?: number): Promise<PruneResult>;
+    /**
+     * Executa uma limpeza de emergência descartando todos os chunks não protegidos.
+     * Utilizado quando ocorre QuotaExceededError para liberar o máximo de espaço sem remover incidentes protegidos.
+     */
+    emergencyPrune(): Promise<PruneResult>;
+    /**
+     * Retorna o detalhamento do armazenamento entre buffer temporário e chunks protegidos por incidentes.
+     */
+    getStorageBreakdown(): Promise<StorageBreakdown>;
+}
+export interface StorageBreakdown {
+    totalBytes: number;
+    protectedBytes: number;
+    bufferBytes: number;
+    maxStorageBytes: number;
+    isOverLimit: boolean;
+    protectedExceedsLimit: boolean;
+    incidentCount: number;
+}
+//# sourceMappingURL=retention.d.ts.map

package/dist/storage/retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retention.d.ts","sourceRoot":"","sources":["../../src/storage/retention.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,MAAM,CAAC;AAG7C,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,EAAE,CAAmB;IAC7B,OAAO,CAAC,MAAM,CAAkB;gBAEpB,EAAE,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAQnE;;;;;OAKG;IACU,KAAK,CAAC,GAAG,GAAE,MAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;IA6DlE;;;OAGG;IACU,cAAc,IAAI,OAAO,CAAC,WAAW,CAAC;IA2CnD;;OAEG;IACU,mBAAmB,IAAI,OAAO,CAAC,gBAAgB,CAAC;CAmC9D;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,OAAO,CAAC;IACrB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/storage/session.d.ts

@@ -0,0 +1,32 @@
+export interface SessionContext {
+    tabId: string;
+    sessionId: string;
+}
+export interface ClaimSessionOptions {
+    storage?: Storage;
+    timeoutMs?: number;
+    channelName?: string;
+    channel?: BroadcastChannel | null;
+    disableBroadcastChannel?: boolean;
+}
+/**
+ * Fecha os canais de BroadcastChannel abertos pela sessão.
+ */
+export declare function closeSessionChannel(channel?: BroadcastChannel): void;
+/**
+ * Obtém ou inicializa o tabId e sessionId da aba atual utilizando sessionStorage.
+ * Sobrevive a F5/reload na mesma aba sem vazar para outras abas.
+ * Mantida versão síncrona para compatibilidade da API pública.
+ */
+export declare function getOrCreateSessionContext(storage?: Storage): SessionContext;
+/**
+ * Confirma e reivindica a identidade da sessão da aba de forma assíncrona.
+ * Se o storage tiver sido herdado por duplicação de aba e a aba original
+ * ainda estiver ativa no BroadcastChannel, gera novos IDs para tabId e sessionId.
+ */
+export declare function claimSessionContext(options?: ClaimSessionOptions): Promise<SessionContext>;
+/**
+ * Força a renovação da sessão (útil para testes ou reinicialização explícita).
+ */
+export declare function resetSessionContext(storage?: Storage): SessionContext;
+//# sourceMappingURL=session.d.ts.map

package/dist/storage/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/storage/session.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAcD,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClC,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAoCD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAkBpE;AAQD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,cAAc,CAmC3E;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,CAAC,CAiIhG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,cAAc,CAerE"}

package/dist/types/artifact.d.ts

@@ -0,0 +1,72 @@
+import type { IncidentReason, IncidentTrigger } from './incident';
+import type { TimelineEvent } from './timeline';
+import type { RrwebEvent } from './chunk';
+export interface IncidentMetadata {
+    id: string;
+    reason: IncidentReason;
+    triggers: IncidentTrigger[];
+    startedAt: number;
+    triggeredAt: number;
+    finalizedAt: number;
+    annotationImage?: string;
+    annotations?: Record<string, unknown>;
+}
+export interface EnvironmentMetadata {
+    url: string;
+    userAgent: string;
+    viewport: {
+        width: number;
+        height: number;
+    };
+    appVersion?: string;
+    gitBranch?: string;
+    gitCommit?: string;
+}
+export interface DiagnosticsMetadata {
+    /** Known losses only; see droppedEventsUnknown for unquantifiable gaps. */
+    droppedEvents: number;
+    droppedEventsUnknown?: boolean;
+    storageBytes: number;
+    degraded: boolean;
+    degradedReasons: string[];
+}
+export interface ReplayWindowMetadata {
+    requestedStartedAt: number;
+    requestedEndedAt: number;
+    preparationEventCount: number;
+    baseSnapshotOriginalTimestamp?: number;
+}
+export interface CorrelationMetadata {
+    traceId?: string;
+    spanId?: string;
+}
+export interface ArtifactContextV2 {
+    sessionId: string;
+    tabId: string;
+    release?: string;
+    environment?: string;
+    correlation?: CorrelationMetadata;
+}
+export interface FlightRecorderArtifactV1 {
+    formatVersion: 1;
+    recorderVersion: string;
+    incident: IncidentMetadata;
+    environment: EnvironmentMetadata;
+    replayWindow?: ReplayWindowMetadata;
+    timeline: TimelineEvent[];
+    replay: RrwebEvent[];
+    diagnostics: DiagnosticsMetadata;
+}
+export interface FlightRecorderArtifactV2 {
+    formatVersion: 2;
+    recorderVersion: string;
+    context: ArtifactContextV2;
+    incident: IncidentMetadata;
+    environment: EnvironmentMetadata;
+    replayWindow?: ReplayWindowMetadata;
+    timeline: TimelineEvent[];
+    replay: RrwebEvent[];
+    diagnostics: DiagnosticsMetadata;
+}
+export type FlightRecorderArtifact = FlightRecorderArtifactV1 | FlightRecorderArtifactV2;
+//# sourceMappingURL=artifact.d.ts.map

package/dist/types/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../../src/types/artifact.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,6BAA6B,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,CAAC,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE,mBAAmB,CAAC;IACjC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,CAAC,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE,mBAAmB,CAAC;IACjC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,WAAW,EAAE,mBAAmB,CAAC;CAClC;AAED,MAAM,MAAM,sBAAsB,GAC9B,wBAAwB,GACxB,wBAAwB,CAAC"}

package/dist/types/chunk.d.ts

@@ -0,0 +1,32 @@
+import type { TimelineEvent } from './timeline';
+/**
+ * Evento genérico do rrweb com timestamp e dados do snapshot/mutação.
+ */
+export interface RrwebEvent {
+    type: number;
+    data: unknown;
+    timestamp: number;
+    [key: string]: unknown;
+}
+/**
+ * Chunk de gravação persistido no IndexedDB.
+ */
+export interface StoredChunk {
+    id: string;
+    sessionId: string;
+    tabId: string;
+    sequence: number;
+    startedAt: number;
+    endedAt: number;
+    /**
+     * Estimativa de tamanho do chunk em bytes (payload comprimido do replay + bytes UTF-8 da timeline).
+     * É uma estimativa pois o overhead interno do IndexedDB não é mensurável dessa forma.
+     */
+    sizeBytes: number;
+    replay: RrwebEvent[];
+    replayCompressed?: Uint8Array;
+    hasFullSnapshot?: boolean;
+    snapshotTimestamps?: number[];
+    timeline: TimelineEvent[];
+}
+//# sourceMappingURL=chunk.d.ts.map

package/dist/types/chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../src/types/chunk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,UAAU,CAAC;IAC9B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B"}

package/dist/types/health.d.ts

@@ -0,0 +1,16 @@
+export type RecorderState = 'stopped' | 'recording' | 'incident_pending' | 'degraded';
+export interface RecorderHealth {
+    state: RecorderState;
+    droppedEvents: number;
+    storageBytes: number;
+    protectedStorageBytes?: number;
+    storageLimitBytes?: number;
+    storageLimitExceeded?: boolean;
+    protectedStorageExceeded?: boolean;
+    browserStorageEstimateBytes?: number;
+    browserStorageQuotaBytes?: number;
+    pendingWrites: number;
+    incidentCount: number;
+    reasons: string[];
+}
+//# sourceMappingURL=health.d.ts.map

package/dist/types/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/types/health.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,WAAW,GACX,kBAAkB,GAClB,UAAU,CAAC;AAEf,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/types/incident.d.ts

@@ -0,0 +1,35 @@
+import type { EnvironmentMetadata } from './artifact';
+export type IncidentReason = 'manual' | 'error' | 'unhandledrejection' | 'react' | 'http';
+export interface IncidentTrigger {
+    id: string;
+    timestamp: number;
+    type: IncidentReason;
+    signature: string;
+    detail?: Record<string, unknown>;
+}
+export interface StoredIncident {
+    id: string;
+    sessionId: string;
+    tabId: string;
+    reason: IncidentReason;
+    triggers: IncidentTrigger[];
+    startedAt: number;
+    triggeredAt: number;
+    finalizeAt: number;
+    finalizedAt?: number;
+    state: 'pending' | 'finalized';
+    chunkIds: string[];
+    recordingIssues?: string[];
+    environment?: EnvironmentMetadata;
+    droppedEvents?: number;
+}
+export interface IncidentSummary {
+    id: string;
+    reason: IncidentReason;
+    startedAt: number;
+    triggeredAt: number;
+    finalizedAt?: number;
+    eventCount: number;
+    triggerCount: number;
+}
+//# sourceMappingURL=incident.d.ts.map

package/dist/types/incident.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"incident.d.ts","sourceRoot":"","sources":["../../src/types/incident.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,OAAO,GACP,oBAAoB,GACpB,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,SAAS,GAAG,WAAW,CAAC;IAC/B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+export * from './timeline';
+export * from './chunk';
+export * from './incident';
+export * from './health';
+export * from './options';
+export * from './artifact';
+export * from './transport';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC"}

package/dist/types/options.d.ts

@@ -0,0 +1,84 @@
+import type { IncidentSummary } from './incident';
+import type { RecorderHealth } from './health';
+import type { FlightRecorderArtifact, EnvironmentMetadata } from './artifact';
+import type { BatchWriterConfig } from '../storage/batch-writer';
+import type { ClaimSessionOptions } from '../storage/session';
+import type { BacktrackTransport, BeforeSend } from './transport';
+export interface ErrorContext {
+    source?: 'react' | 'manual' | 'window' | 'unhandledrejection';
+    componentStack?: string;
+    [key: string]: unknown;
+}
+export type RouteMatcher = string | RegExp | ((pathname: string) => boolean);
+export interface PrivacyOptions {
+    maskAllInputs?: boolean;
+    maskAllText?: boolean;
+    blockMedia?: boolean;
+    blockSelector?: string;
+    maskTextSelector?: string;
+    sanitizeUrl?: (url: URL) => string;
+    sensitiveRoutes?: RouteMatcher[];
+    autoMaskPII?: boolean;
+    recordCanvas?: boolean;
+}
+export interface NetworkOptions {
+    capturePayloads?: boolean;
+    maxPayloadSize?: number;
+}
+export interface WidgetOptions {
+    position?: 'bottom-left' | 'bottom-right' | 'top-left' | 'top-right';
+    defaultViewerUrl?: string;
+    zIndex?: number;
+    defaultDurationSeconds?: number;
+}
+export interface ObservabilityContext {
+    release?: string;
+    environment?: string;
+    traceId?: string;
+    spanId?: string;
+}
+export interface FlightRecorderOptions {
+    bufferMinutes?: number;
+    afterErrorSeconds?: number;
+    /** Retention target; saved incidents are protected and may exceed it. */
+    maxStorageMb?: number;
+    captureHttpStatus?: number[];
+    ignoredUrls?: (string | RegExp)[];
+    network?: NetworkOptions;
+    privacy?: PrivacyOptions;
+    metadata?: Partial<EnvironmentMetadata>;
+    recorderVersion?: string;
+    showWidget?: boolean;
+    widgetOptions?: WidgetOptions;
+    storage?: Storage;
+    sessionOptions?: ClaimSessionOptions;
+    batchWriterConfig?: Partial<BatchWriterConfig>;
+    transport?: BacktrackTransport;
+    beforeSend?: BeforeSend;
+    context?: ObservabilityContext;
+    getContext?: () => ObservabilityContext | Promise<ObservabilityContext>;
+}
+export interface CaptureOptions {
+    annotationImage?: string;
+    notes?: string;
+    annotations?: Record<string, unknown>;
+}
+export interface FlightRecorder {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    capture(reason?: string, windowSeconds?: number, options?: CaptureOptions): Promise<string>;
+    captureException(error: unknown, context?: ErrorContext): Promise<string | undefined> | void;
+    listIncidents(): Promise<IncidentSummary[]>;
+    getArtifact(incidentId: string): Promise<FlightRecorderArtifact>;
+    exportIncident(incidentId: string, options?: {
+        compress?: boolean;
+        aiOptimized?: boolean;
+    }): Promise<FlightRecorderArtifact>;
+    deleteIncident(incidentId: string): Promise<void>;
+    clear(): Promise<void>;
+    getHealth(): RecorderHealth;
+    hideWidget?(): void;
+    showWidget?(): void;
+    toggleWidget?(): boolean;
+}
+//# sourceMappingURL=options.d.ts.map

package/dist/types/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/types/options.ts"],"names":[],"mappings":"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"}