@offscript/sdk 0.1.2 → 0.1.5

package/dist/core/OffscriptSDK.d.ts

@@ -1,117 +1,80 @@
 import type { OffscriptConfig, ResolvedConfig } from "../types/config";
 import { type EventKind, type OffscriptEvent, type RecordedAction } from "../types/events";
-import type { OffscriptState, RecordingStatus, SessionInfo, StartRecordingOptions, StopSummary } from "../types/session";
+import type { CompleteOptions, OffscriptState, RecordingPayload, RecordingStatus } from "../types/recording";
 import { DataSanitizer } from "../privacy/DataSanitizer";
 import type { EmitOptions, EventSink } from "../recorders/types";
-import { OffscriptError } from "../utils/errors";
 import { type PlaywrightRecording } from "../playwright/PlaywrightDataContract";
 export type OffscriptEventMap = {
     statusChange: {
         from: RecordingStatus;
         to: RecordingStatus;
     };
-    error: OffscriptError | Error;
-    sessionStart: SessionInfo;
-    sessionEnd: StopSummary;
-    sessionDiscard: {
-        sessionId: string;
-    };
-    flush: {
-        events: number;
-        batchId: string;
-        duplicate: boolean;
-    };
-    overflow: {
-        dropped: number;
-    };
-    disabled: {
-        reason?: string;
-    };
+    error: Error;
+    recordingStart: undefined;
+    recordingEnd: RecordingPayload;
 };
 export declare class Offscript implements EventSink {
-    private readonly bus;
+    static readonly version = "0.1.5";
     readonly config: ResolvedConfig;
     readonly sanitizer: DataSanitizer;
+    private readonly bus;
     private status;
     private lastError?;
-    private sessions;
-    private transport?;
-    private lifecycle?;
     private recorders;
     private rrweb?;
     private actions?;
     private context?;
+    private lifecycle?;
+    private controls?;
     private accepting;
+    private destroyed;
     private initPromise?;
+    private store?;
+    private suspended;
+    private restorePromise?;
     private startPromise?;
     private stopPromise?;
-    private destroyed;
+    private completePromise?;
+    private events;
     private recent;
     private actionLog;
     private contextLog;
-    private eventCount;
-    private metrics;
-    private controls?;
-    private lastStart?;
-    private armed?;
-    constructor(config: OffscriptConfig);
+    private sequence;
+    private pageId;
+    private payload?;
+    private submitted;
+    private response;
+    constructor(config?: OffscriptConfig);
     getState(): OffscriptState;
     capturesSensitiveValues(): boolean;
-    getMetrics(): {
-        emitted: number;
-        dropped: number;
-        avgEmitMs: number;
-        bufferKind?: string;
-    };
-    /** Idempotente. Prepara armazenamento/transporte e retoma sessão persistida (reload/MPA). */
     init(): Promise<void>;
-    private doInit;
-    startRecording(opts: StartRecordingOptions): Promise<SessionInfo>;
+    private initializeDraft;
+    private restoreDraft;
+    private save;
+    startRecording(): Promise<void>;
     private doStart;
-    private resumePersisted;
-    /** Guarda caso de teste e token para o botão de gravar, sem abrir a sessão. */
-    armRecording(opts: {
-        testCaseId: string;
-        sessionToken: string;
-    }): void;
-    /** Abre a coleta com os dados armados, ou com os da última sessão. */
-    startArmedRecording(): Promise<SessionInfo>;
-    /** Descarta a coleta atual e volta ao estado inicial, sem abrir outra. */
-    startNewSession(): Promise<void>;
-    private freshStart;
-    private discardRecording;
     pauseRecording(): Promise<void>;
     resumeRecording(): Promise<void>;
-    stopRecording(): Promise<StopSummary>;
+    stopRecording(): Promise<RecordingPayload>;
     private doStop;
-    /**
-     * Libera todos os recursos. Por padrão encerra a gravação ativa; com `{ complete: false }` apenas
-     * desanexa a instrumentação e mantém a sessão persistida para ser retomada por outra instância.
-     */
-    destroy(opts?: {
-        complete?: boolean;
-    }): Promise<void>;
-    /** Dados estruturados para o motor Playwright, construídos a partir do que foi gravado nesta página. */
+    complete(options: CompleteOptions): Promise<unknown>;
+    private doComplete;
+    finishRecording(): Promise<unknown>;
+    discardRecording(): Promise<void>;
+    destroy(): Promise<void>;
     exportPlaywrightData(): PlaywrightRecording;
     getRecordedActions(): readonly RecordedAction[];
     on<K extends keyof OffscriptEventMap>(type: K, fn: (payload: OffscriptEventMap[K]) => void): () => void;
     off<K extends keyof OffscriptEventMap>(type: K, fn: (payload: OffscriptEventMap[K]) => void): void;
-    /** Usado pelos recorders. Não confundir com os eventos públicos (`on`). */
     emit<T>(kind: EventKind, data: T, opts?: EmitOptions): OffscriptEvent<T> | null;
     private record;
     private correlate;
     private emitLifecycle;
     private attach;
     private startRecorders;
+    private buildPayload;
     private stopRecorders;
-    private ensureControls;
-    private teardown;
-    private onHeartbeat;
-    /** Backend desativou a gravação: encerra com flush de melhor esforço. */
-    private shutdownRemote;
-    private onFatal;
-    private fail;
+    private clearRecording;
+    private assertAlive;
     private setStatus;
-    private debug;
-    static readonly version = "0.1.0";
 }

package/dist/core/RecordingStore.d.ts

@@ -0,0 +1,26 @@
+import type { OffscriptEvent } from "../types/events";
+export type SavedStatus = "recording" | "paused" | "stopped";
+export interface SavedRecording {
+    status: SavedStatus;
+    events: OffscriptEvent[];
+}
+/** Local draft only. No destination, credentials or backend protocol. */
+export declare class RecordingStore {
+    private readonly database;
+    private pending;
+    private failure?;
+    private uncommitted;
+    private status?;
+    private constructor();
+    static open(key: string): Promise<RecordingStore>;
+    load(): Promise<SavedRecording | null>;
+    append(event: OffscriptEvent): Promise<void>;
+    setStatus(status: SavedStatus): Promise<void>;
+    clear(): Promise<void>;
+    /** Synchronous handoff of the last uncommitted events before document unload. */
+    checkpoint(): void;
+    private get checkpointKey();
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    private write;
+}

package/dist/index.cjs

@@ -1,98 +1,78 @@
 'use strict';
 
-var chunkTBPD2LMI_cjs = require('./chunk-TBPD2LMI.cjs');
-var chunkI6JPZAQA_cjs = require('./chunk-I6JPZAQA.cjs');
-var chunkKQVK5EJR_cjs = require('./chunk-KQVK5EJR.cjs');
+var chunk2MY2FWIA_cjs = require('./chunk-2MY2FWIA.cjs');
+var chunkVYCDQLP7_cjs = require('./chunk-VYCDQLP7.cjs');
+var chunkHPDLEAAL_cjs = require('./chunk-HPDLEAAL.cjs');
 
 
 
 Object.defineProperty(exports, "createOffscript", {
   enumerable: true,
-  get: function () { return chunkTBPD2LMI_cjs.createOffscript; }
+  get: function () { return chunk2MY2FWIA_cjs.createOffscript; }
 });
 Object.defineProperty(exports, "startOffscript", {
   enumerable: true,
-  get: function () { return chunkTBPD2LMI_cjs.startOffscript; }
-});
-Object.defineProperty(exports, "AuthError", {
-  enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.AuthError; }
+  get: function () { return chunk2MY2FWIA_cjs.startOffscript; }
 });
 Object.defineProperty(exports, "ConfigError", {
   enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.ConfigError; }
+  get: function () { return chunkVYCDQLP7_cjs.ConfigError; }
 });
 Object.defineProperty(exports, "DEFAULT_PRIVACY", {
   enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.DEFAULT_PRIVACY; }
+  get: function () { return chunkVYCDQLP7_cjs.DEFAULT_PRIVACY; }
 });
 Object.defineProperty(exports, "DEFAULT_RECORDING", {
   enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.DEFAULT_RECORDING; }
-});
-Object.defineProperty(exports, "DEFAULT_TRANSPORT", {
-  enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.DEFAULT_TRANSPORT; }
+  get: function () { return chunkVYCDQLP7_cjs.DEFAULT_RECORDING; }
 });
 Object.defineProperty(exports, "DataSanitizer", {
   enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.DataSanitizer; }
+  get: function () { return chunkVYCDQLP7_cjs.DataSanitizer; }
 });
 Object.defineProperty(exports, "InvalidStateError", {
   enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.InvalidStateError; }
+  get: function () { return chunkVYCDQLP7_cjs.InvalidStateError; }
 });
 Object.defineProperty(exports, "Offscript", {
   enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.Offscript; }
+  get: function () { return chunkVYCDQLP7_cjs.Offscript; }
 });
 Object.defineProperty(exports, "OffscriptError", {
   enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.OffscriptError; }
-});
-Object.defineProperty(exports, "SessionDisabledError", {
-  enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.SessionDisabledError; }
-});
-Object.defineProperty(exports, "SessionExpiredError", {
-  enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.SessionExpiredError; }
-});
-Object.defineProperty(exports, "TransportError", {
-  enumerable: true,
-  get: function () { return chunkI6JPZAQA_cjs.TransportError; }
+  get: function () { return chunkVYCDQLP7_cjs.OffscriptError; }
 });
 Object.defineProperty(exports, "ACTION_SCHEMA_VERSION", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.ACTION_SCHEMA_VERSION; }
+  get: function () { return chunkHPDLEAAL_cjs.ACTION_SCHEMA_VERSION; }
 });
 Object.defineProperty(exports, "PLAYWRIGHT_CONTRACT_VERSION", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.PLAYWRIGHT_CONTRACT_VERSION; }
+  get: function () { return chunkHPDLEAAL_cjs.PLAYWRIGHT_CONTRACT_VERSION; }
 });
 Object.defineProperty(exports, "SCHEMA_VERSION", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.SCHEMA_VERSION; }
+  get: function () { return chunkHPDLEAAL_cjs.SCHEMA_VERSION; }
 });
 Object.defineProperty(exports, "SDK_VERSION", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.SDK_VERSION; }
+  get: function () { return chunkHPDLEAAL_cjs.SDK_VERSION; }
 });
 Object.defineProperty(exports, "SelectorGenerator", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.SelectorGenerator; }
+  get: function () { return chunkHPDLEAAL_cjs.SelectorGenerator; }
 });
 Object.defineProperty(exports, "buildPlaywrightContract", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.buildPlaywrightContract; }
+  get: function () { return chunkHPDLEAAL_cjs.buildPlaywrightContract; }
 });
 Object.defineProperty(exports, "normalizeActions", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.normalizeActions; }
+  get: function () { return chunkHPDLEAAL_cjs.normalizeActions; }
 });
 Object.defineProperty(exports, "validatePlaywrightContract", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.validatePlaywrightContract; }
+  get: function () { return chunkHPDLEAAL_cjs.validatePlaywrightContract; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -2,8 +2,8 @@ export { Offscript } from "./core/OffscriptSDK";
 export type { OffscriptEventMap } from "./core/OffscriptSDK";
 export * from "./types/config";
 export * from "./types/events";
-export * from "./types/session";
-export { OffscriptError, ConfigError, AuthError, SessionExpiredError, SessionDisabledError, InvalidStateError, TransportError, } from "./utils/errors";
+export * from "./types/recording";
+export { OffscriptError, ConfigError, InvalidStateError, } from "./utils/errors";
 export type { OffscriptErrorCode } from "./utils/errors";
 export { DataSanitizer } from "./privacy/DataSanitizer";
 export { buildPlaywrightContract, validatePlaywrightContract, PLAYWRIGHT_CONTRACT_VERSION } from "./playwright/PlaywrightDataContract";

package/dist/index.js

@@ -1,5 +1,5 @@
-export { createOffscript, startOffscript } from './chunk-HECPMGDC.js';
-export { AuthError, ConfigError, DEFAULT_PRIVACY, DEFAULT_RECORDING, DEFAULT_TRANSPORT, DataSanitizer, InvalidStateError, Offscript, OffscriptError, SessionDisabledError, SessionExpiredError, TransportError } from './chunk-IBEPWI7S.js';
-export { ACTION_SCHEMA_VERSION, PLAYWRIGHT_CONTRACT_VERSION, SCHEMA_VERSION, SDK_VERSION, SelectorGenerator, buildPlaywrightContract, normalizeActions, validatePlaywrightContract } from './chunk-WUFW7TEL.js';
+export { createOffscript, startOffscript } from './chunk-V2YYWGIA.js';
+export { ConfigError, DEFAULT_PRIVACY, DEFAULT_RECORDING, DataSanitizer, InvalidStateError, Offscript, OffscriptError } from './chunk-XBXFGCUT.js';
+export { ACTION_SCHEMA_VERSION, PLAYWRIGHT_CONTRACT_VERSION, SCHEMA_VERSION, SDK_VERSION, SelectorGenerator, buildPlaywrightContract, normalizeActions, validatePlaywrightContract } from './chunk-6ROP37WI.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/playwright/PlaywrightDataContract.d.ts

@@ -43,12 +43,6 @@ export interface PlaywrightRecording {
     kind: typeof PLAYWRIGHT_CONTRACT_KIND;
     generatedAt: number;
     sdkVersion: string;
-    session: {
-        sessionId: string;
-        executionId: string;
-        testCaseId: string;
-        platformId: string;
-    };
     initialConditions: {
         url?: string;
         viewport?: {
@@ -76,7 +70,6 @@ export interface PlaywrightRecording {
 }
 export declare const CONTRACT_LIMITATIONS: string[];
 export interface BuildInput {
-    session: PlaywrightRecording["session"];
     actions: readonly RecordedAction[];
     contexts?: readonly ContextEventData[];
     extensions?: Record<string, unknown>;

package/dist/playwright.cjs

@@ -1,56 +1,56 @@
 'use strict';
 
-var chunkKQVK5EJR_cjs = require('./chunk-KQVK5EJR.cjs');
+var chunkHPDLEAAL_cjs = require('./chunk-HPDLEAAL.cjs');
 
 
 
 Object.defineProperty(exports, "CONTRACT_LIMITATIONS", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.CONTRACT_LIMITATIONS; }
+  get: function () { return chunkHPDLEAAL_cjs.CONTRACT_LIMITATIONS; }
 });
 Object.defineProperty(exports, "PLAYWRIGHT_CONTRACT_KIND", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.PLAYWRIGHT_CONTRACT_KIND; }
+  get: function () { return chunkHPDLEAAL_cjs.PLAYWRIGHT_CONTRACT_KIND; }
 });
 Object.defineProperty(exports, "PLAYWRIGHT_CONTRACT_VERSION", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.PLAYWRIGHT_CONTRACT_VERSION; }
+  get: function () { return chunkHPDLEAAL_cjs.PLAYWRIGHT_CONTRACT_VERSION; }
 });
 Object.defineProperty(exports, "SelectorGenerator", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.SelectorGenerator; }
+  get: function () { return chunkHPDLEAAL_cjs.SelectorGenerator; }
 });
 Object.defineProperty(exports, "accessibleName", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.accessibleName; }
+  get: function () { return chunkHPDLEAAL_cjs.accessibleName; }
 });
 Object.defineProperty(exports, "buildPlaywrightContract", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.buildPlaywrightContract; }
+  get: function () { return chunkHPDLEAAL_cjs.buildPlaywrightContract; }
 });
 Object.defineProperty(exports, "implicitRole", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.implicitRole; }
+  get: function () { return chunkHPDLEAAL_cjs.implicitRole; }
 });
 Object.defineProperty(exports, "isStableClass", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.isStableClass; }
+  get: function () { return chunkHPDLEAAL_cjs.isStableClass; }
 });
 Object.defineProperty(exports, "isStableId", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.isStableId; }
+  get: function () { return chunkHPDLEAAL_cjs.isStableId; }
 });
 Object.defineProperty(exports, "labelText", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.labelText; }
+  get: function () { return chunkHPDLEAAL_cjs.labelText; }
 });
 Object.defineProperty(exports, "normalizeActions", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.normalizeActions; }
+  get: function () { return chunkHPDLEAAL_cjs.normalizeActions; }
 });
 Object.defineProperty(exports, "validatePlaywrightContract", {
   enumerable: true,
-  get: function () { return chunkKQVK5EJR_cjs.validatePlaywrightContract; }
+  get: function () { return chunkHPDLEAAL_cjs.validatePlaywrightContract; }
 });
 //# sourceMappingURL=playwright.cjs.map
 //# sourceMappingURL=playwright.cjs.map

package/dist/playwright.js

@@ -1,3 +1,3 @@
-export { CONTRACT_LIMITATIONS, PLAYWRIGHT_CONTRACT_KIND, PLAYWRIGHT_CONTRACT_VERSION, SelectorGenerator, accessibleName, buildPlaywrightContract, implicitRole, isStableClass, isStableId, labelText, normalizeActions, validatePlaywrightContract } from './chunk-WUFW7TEL.js';
+export { CONTRACT_LIMITATIONS, PLAYWRIGHT_CONTRACT_KIND, PLAYWRIGHT_CONTRACT_VERSION, SelectorGenerator, accessibleName, buildPlaywrightContract, implicitRole, isStableClass, isStableId, labelText, normalizeActions, validatePlaywrightContract } from './chunk-6ROP37WI.js';
 //# sourceMappingURL=playwright.js.map
 //# sourceMappingURL=playwright.js.map

package/dist/recorders/ActionRecorder.d.ts

@@ -1,6 +1,6 @@
 import { type RecordedAction } from "../types/events";
 import { type EventSink, type Recorder } from "./types";
-export type ActionDraft = Omit<RecordedAction, "id" | "sessionId" | "executionId" | "sequence" | "timestamp">;
+export type ActionDraft = Omit<RecordedAction, "id" | "sequence" | "timestamp">;
 /** Ações semânticas do usuário. Eventos brutos → rascunhos de ação; a normalização é feita fora (ActionNormalizer). */
 export declare class ActionRecorder implements Recorder {
     private readonly sink;

package/dist/recorders/ContextRecorder.d.ts

@@ -1,22 +1,16 @@
 import { type ContextEventData } from "../types/events";
 import { type EventSink, type Recorder } from "./types";
-export interface ContextIdentity {
-    platformId: string;
-    testCaseId: string;
-    executionId: string;
-}
 export declare function parseBrowser(ua: string): {
     name?: string;
     version?: string;
 };
-export declare function collectContext(id: ContextIdentity, reason: ContextEventData["reason"], appVersion?: string, captureSensitiveValues?: boolean): ContextEventData;
+export declare function collectContext(reason: ContextEventData["reason"], captureSensitiveValues?: boolean): ContextEventData;
 /** Metadados de investigação. Sem fingerprinting: apenas dados já expostos e úteis ao QA. */
 export declare class ContextRecorder implements Recorder {
     private readonly sink;
-    private readonly identity;
     readonly name = "context";
     private d;
-    constructor(sink: EventSink, identity: () => ContextIdentity);
+    constructor(sink: EventSink);
     start(): void;
     record(reason: ContextEventData["reason"]): void;
     stop(): void;

package/dist/recorders/HTTPRecorder.d.ts

@@ -5,14 +5,19 @@ import { type EventSink, type Recorder } from "./types";
  */
 export declare class HTTPRecorder implements Recorder {
     private readonly sink;
-    private readonly ownApiUrl;
     readonly name = "http";
     private inflight;
     private active;
+    private delivering;
+    private pending;
     private restore;
-    constructor(sink: EventSink, ownApiUrl: string);
+    constructor(sink: EventSink);
     start(): void;
     stop(): void;
+    private detach;
+    /** Stops new capture and allows up to two seconds for pending HTTP/body capture. */
+    drain(): Promise<void>;
+    private track;
     private isIgnored;
     private patchFetch;
     private beginFetch;

package/dist/types/config.d.ts

@@ -64,63 +64,24 @@ export interface PrivacyConfig {
     maxBodyBytes: number;
     /** Content-types capturáveis como texto. */
     textContentTypes: RegExp[];
-    /** Descrição da retenção local (ms) dos eventos não enviados no IndexedDB. */
-    localRetentionMs: number;
-}
-export interface TransportConfig {
-    batchMaxEvents: number;
-    batchMaxBytes: number;
-    flushIntervalMs: number;
-    maxMemoryEvents: number;
-    maxBufferBytes: number;
-    maxRetries: number;
-    retryBaseMs: number;
-    retryMaxMs: number;
-    /** Compressão gzip (requer suporte do backend: Content-Encoding: gzip). */
-    compress: boolean;
-    /** Limite para envio com keepalive no encerramento da página (browsers limitam a ~64KB). */
-    keepaliveMaxBytes: number;
-    /** Persistência em IndexedDB. Se indisponível, cai para memória. */
-    persist: boolean;
-    requestTimeoutMs: number;
 }
 export interface OffscriptConfig {
-    apiUrl: string;
-    platformId: string;
-    /** Versão/build da aplicação testada. */
-    appVersion?: string;
     recording?: Partial<RecordingConfig>;
     privacy?: Partial<PrivacyConfig>;
-    transport?: Partial<TransportConfig>;
-    /** Janela (ms) para relacionar requisições/erros à ação anterior. */
     correlationWindowMs?: number;
-    /** Retoma automaticamente a sessão persistida em init() (após reload/navegação). Padrão: true. */
-    autoResume?: boolean;
-    /** Intervalo de heartbeat quando o backend não informar. */
-    heartbeatIntervalMs?: number;
-    /** Prefixo de chaves de storage. */
-    storagePrefix?: string;
-    debug?: boolean;
-    /**
-     * Mostra a barra de pausar, retomar, retornar, finalizar e nova sessão durante a gravação.
-     * Padrão: true. O overlay não entra no filme nem nas ações.
-     */
     controls?: boolean;
+    /** Opaque per-tab key supplied by the host to preserve a local draft across documents. */
+    persistenceKey?: string;
+    /** Called by the overlay when the user finishes. The host supplies endpoint and token here. */
+    onComplete?: () => Promise<unknown>;
 }
 export interface ResolvedConfig {
-    apiUrl: string;
-    platformId: string;
-    appVersion?: string;
     recording: RecordingConfig;
     privacy: PrivacyConfig;
-    transport: TransportConfig;
     correlationWindowMs: number;
-    autoResume: boolean;
-    heartbeatIntervalMs: number;
-    storagePrefix: string;
-    debug: boolean;
     controls: boolean;
+    persistenceKey?: string;
+    onComplete?: () => Promise<unknown>;
 }
 export declare const DEFAULT_RECORDING: RecordingConfig;
 export declare const DEFAULT_PRIVACY: PrivacyConfig;
-export declare const DEFAULT_TRANSPORT: TransportConfig;

package/dist/types/events.d.ts

@@ -1,13 +1,11 @@
 export declare const SCHEMA_VERSION = "1.0";
-export declare const SDK_VERSION = "0.1.0";
+export declare const SDK_VERSION = "0.1.5";
 export type EventKind = "rrweb" | "action" | "http" | "console" | "error" | "context" | "iframe" | "lifecycle";
 /** Envelope comum a todos os eventos. A ordem canônica é (tabId, sequence). */
 export interface OffscriptEvent<T = unknown> {
     /** Identificador único (idempotência). */
     id: string;
     kind: EventKind;
-    sessionId: string;
-    executionId: string;
     tabId: string;
     pageId: string;
     /** Sequência monotônica por aba, persistida entre páginas. */
@@ -19,19 +17,6 @@ export interface OffscriptEvent<T = unknown> {
     relatedActionDeltaMs?: number;
     data: T;
 }
-export interface EventBatch {
-    schemaVersion: string;
-    batchId: string;
-    sessionId: string;
-    executionId: string;
-    tabId: string;
-    sequenceStart: number;
-    sequenceEnd: number;
-    createdAt: number;
-    sdkVersion: string;
-    events: OffscriptEvent[];
-}
-/** Contrato das ações semânticas (versionado por ACTION_SCHEMA_VERSION). */
 export declare const ACTION_SCHEMA_VERSION = "1.0";
 export type ActionType = "click" | "dblclick" | "hover" | "mousemove" | "drag" | "input" | "keydown" | "select" | "check" | "scroll" | "navigate" | "reload" | "focus" | "blur";
 export interface SelectorCandidate {
@@ -63,8 +48,6 @@ export interface ElementDescriptor {
 export interface RecordedAction {
     schemaVersion: string;
     id: string;
-    sessionId: string;
-    executionId: string;
     timestamp: number;
     /** Mesma sequência do envelope do evento. */
     sequence: number;
@@ -158,11 +141,7 @@ export interface ContextEventData {
     timezone?: string;
     online: boolean;
     visibility?: string;
-    platformId: string;
-    testCaseId: string;
-    executionId: string;
     sdkVersion: string;
-    appVersion?: string;
     /** A gravação guardou senhas, tokens e demais valores sem máscara. */
     captureSensitiveValues?: boolean;
 }
@@ -182,6 +161,6 @@ export interface IframeEventData {
     limitation: string;
 }
 export interface LifecycleEventData {
-    type: "session-start" | "session-resume" | "page-start" | "page-end" | "pause" | "resume" | "stop" | "navigation" | "overflow" | "recorder-error";
+    type: "recording-start" | "page-start" | "page-end" | "pause" | "resume" | "stop" | "navigation" | "overflow" | "recorder-error";
     detail?: Record<string, unknown>;
 }

package/dist/types/recording.d.ts

@@ -0,0 +1,20 @@
+import type { OffscriptEvent } from "./events";
+import type { PlaywrightRecording } from "../playwright/PlaywrightDataContract";
+export type RecordingStatus = "idle" | "initializing" | "recording" | "paused" | "stopping" | "stopped" | "error";
+export interface OffscriptState {
+    status: RecordingStatus;
+    pending: number;
+    lastError?: {
+        code: string;
+        message: string;
+    };
+}
+export interface CompleteOptions {
+    endpoint: string;
+    token: string;
+}
+export interface RecordingPayload {
+    recording: OffscriptEvent[];
+    request: OffscriptEvent[];
+    regression: PlaywrightRecording;
+}

package/dist/ui/RecordingControls.d.ts

@@ -1,4 +1,4 @@
-import type { OffscriptState, RecordingStatus, SessionInfo, StopSummary } from "../types/session";
+import type { OffscriptState, RecordingStatus } from "../types/recording";
 /**
  * Alvo mínimo para o overlay não importar a classe do SDK.
  */
@@ -10,9 +10,9 @@ export interface RecordingControlTarget {
     }) => void): () => void;
     pauseRecording(): Promise<void>;
     resumeRecording(): Promise<void>;
-    stopRecording(): Promise<StopSummary>;
-    startArmedRecording(): Promise<SessionInfo>;
-    startNewSession(): Promise<void>;
+    finishRecording(): Promise<unknown>;
+    startRecording(): Promise<void>;
+    discardRecording(): Promise<void>;
     capturesSensitiveValues(): boolean;
 }
 /**
@@ -38,6 +38,8 @@ export declare class RecordingControls {
     private readonly onViewport;
     constructor(sdk: RecordingControlTarget);
     mount(): void;
+    /** Independent notice so the host may destroy the controls after successful upload. */
+    showSuccess(): void;
     unmount(): void;
     private place;
     private watchDom;