@offscript/sdk 0.1.5 → 0.1.6

package/README.md

@@ -1,36 +1,26 @@
 # @offscript/sdk
 
-Biblioteca de captura no navegador: DOM com rrweb, ações, navegação SPA, HTTP, console, erros, contexto e iframes. Não depende de backend para começar. Por padrão, os dados ficam em memória. Para continuar a mesma gravação entre documentos da mesma origem, o host pode fornecer uma `persistenceKey` estável e exclusiva da aba.
+Biblioteca de captura no navegador: DOM com rrweb, ações, navegação SPA, HTTP, console, erros, contexto e iframes. O SDK lê `offscript_token` da query string, mantém o token e a gravação entre documentos da mesma origem e preserva a URL. O overlay só aparece quando há um token de execução.
 
 ```ts
 import { Offscript } from "@offscript/sdk";
 
 const sdk = new Offscript({
+  endpoint: "https://painel.example/api/recordings",
   recording: { rrweb: true, actions: true, http: true, errors: true, iframes: true },
 });
+await sdk.init();
 await sdk.startRecording();
-const result = await sdk.complete({
-  endpoint: "https://painel.example/api/recordings",
-  token: tokenForUpload,
-});
+const result = await sdk.complete();
 ```
 
-`complete` para os recorders e faz um único POST JSON com `Authorization: Bearer <token>`. O destino e o token são fornecidos pelo front-end apenas nesta operação. O SDK não lê tokens da URL nem conhece IDs do domínio do painel.
+`complete()` para os recorders e faz um único POST JSON com `Authorization: Bearer <token>`. O host configura o endpoint; o SDK obtém o token da URL ou da sessão da aba. Também e possível passar `endpoint` e `token` explícitamente a `complete` para integrações personalizadas.
 
-O payload contém `recording` (envelopes rrweb, ações, console, erros, contexto, iframes e ciclo de vida), `request` (envelopes HTTP) e `regression` (contrato Playwright com condições iniciais e passos). Não há transporte durante a captura nem reenvio automático. Chamadas concorrentes de `complete` compartilham o envio; após sucesso, chamadas repetidas retornam o resultado. Após falha, os dados continuam disponíveis para uma nova chamada explícita.
+O payload contém `recording` (envelopes rrweb, ações, console, erros, contexto, iframes e ciclo de vida), `request` (envelopes HTTP) e `regression` (contrato Playwright com condições iniciais e passos). Não ha transporte durante a captura nem reenvio automático. Chamadas concorrentes de `complete` compartilham o envio; após sucesso, chamadas repetidas retornam o resultado. Após falha, os dados continuam disponíveis para uma nova chamada explícita.
 
 `stopRecording()` encerra localmente e devolve o payload sem publicar. `pauseRecording()` e `resumeRecording()` controlam a captura; retomar gera um snapshot completo. `discardRecording()` limpa os dados e volta ao estado inicial. `destroy()` libera a instrumentação sem enviar dados.
 
-O overlay aparece em `init()` quando `controls` está habilitado (padrão). Iniciar grava localmente. Para publicar ao clicar em Finalizar, configure o callback do host:
-
-```ts
-const sdk = new Offscript({
-  onComplete: () => sdk.complete({ endpoint: destination, token: uploadToken }),
-});
-await sdk.init();
-```
-
-Sem callback, Finalizar apenas encerra localmente. `getState()` retorna `{ status, pending, lastError }`. Eventos públicos: `statusChange`, `error`, `recordingStart` e `recordingEnd` (captura encerrada, antes do upload).
+Com `controls` habilitado (padrão), o overlay aparece em `init()` somente quando existe um token de execução na URL ou na sessão da aba. Iniciar grava localmente; Finalizar envia a gravação ao endpoint configurado usando o token do SDK. `onComplete` continua disponível para integrações que precisem substituir esse comportamento.
 
 As opções `recording` e `privacy` estão tipadas em `src/types/config.ts`. `captureSensitiveValues` vem desabilitada; habilitá-la inclui valores sensíveis na captura. Configure máscaras, seletores bloqueados e URLs ignoradas conforme a aplicação.
 
@@ -40,8 +30,8 @@ Validação: `npm run typecheck`, `npm test`, `npm run build`, `npm run test:e2e
 
 ## Continuidade entre páginas
 
-Configure `persistenceKey` com uma chave opaca criada pelo host e mantida em `sessionStorage` na aba. Com a mesma chave em cada página, `init()` restaura o rascunho e retoma a captura quando ela estava ativa, preserva a pausa ou disponibiliza a gravação encerrada para envio. Sem essa opção, a captura continua apenas em memória.
+Em sessões iniciadas com token, o SDK cria e mantém automaticamente uma chave opaca de rascunho em `sessionStorage`. Com ela, `init()` restaura o rascunho e retoma a captura quando ela estava ativa, preserva a pausa ou disponibiliza a gravação encerrada para envio. `persistenceKey` continua opcional para integrações que queiram controlar essa chave.
 
-Os eventos ficam no IndexedDB da origem. No descarregamento do documento, os últimos eventos ainda não confirmados são guardados em `sessionStorage` para a próxima página. `complete()` limpa o rascunho após o HTTP de sucesso; `discardRecording()` também o remove. `destroy()` fecha o armazenamento e libera a instrumentação, preservando o rascunho local.
+Os eventos ficam no IndexedDB da origem. No descarregamento do documento, os últimos eventos ainda não confirmados são guardados em `sessionStorage` para a próxima pagina. `complete()` limpa o rascunho após HTTP de sucesso; `discardRecording()` também o remove. `destroy()` fecha o armazenamento e libera a instrumentação, preservando o rascunho local.
 
-O token continua sob responsabilidade do host. A bancada o recebe pela query, guarda na aba e remove o parâmetro da URL; páginas seguintes usam o valor da aba. Após envio bem-sucedido, a bancada apaga token e chave e fecha o overlay. Falhas mantêm os dados para nova tentativa. A continuidade exige a mesma origem e SDK inicializado em cada documento; armazenamento de navegador não é compartilhado entre domínios ou portas diferentes.
+O SDK lê o token de `offscript_token`, mantém a query na URL e guarda a credencial na sessão da aba para continuar após navegações. Após envio bem-sucedido, o SDK limpa o rascunho e não reabre o overlay nessa sessão; falhas mantém os dados para nova tentativa. A continuidade exige a mesma origem e o SDK inicializado em cada documento; armazenamento de navegador não é compartilhado entre domínios ou portas diferentes.

package/dist/adapters/nuxt.cjs

@@ -1,12 +1,12 @@
 'use strict';
 
-var chunkVYCDQLP7_cjs = require('../chunk-VYCDQLP7.cjs');
-require('../chunk-HPDLEAAL.cjs');
+var chunkPCJRHW66_cjs = require('../chunk-PCJRHW66.cjs');
+require('../chunk-MZXF2LF2.cjs');
 
 // src/adapters/nuxt.ts
 function createNuxtOffscript(config) {
   if (typeof window === "undefined") return null;
-  const sdk = new chunkVYCDQLP7_cjs.Offscript(config);
+  const sdk = new chunkPCJRHW66_cjs.Offscript(config);
   void sdk.init().catch(() => void 0);
   return sdk;
 }

package/dist/adapters/nuxt.js

@@ -1,5 +1,5 @@
-import { Offscript } from '../chunk-XBXFGCUT.js';
-import '../chunk-6ROP37WI.js';
+import { Offscript } from '../chunk-5ZBR6FI5.js';
+import '../chunk-KHKIWCLM.js';
 
 // src/adapters/nuxt.ts
 function createNuxtOffscript(config) {

package/dist/adapters/vanilla.cjs

@@ -1,18 +1,18 @@
 'use strict';
 
-var chunk2MY2FWIA_cjs = require('../chunk-2MY2FWIA.cjs');
-require('../chunk-VYCDQLP7.cjs');
-require('../chunk-HPDLEAAL.cjs');
+var chunkRAUSXUGS_cjs = require('../chunk-RAUSXUGS.cjs');
+require('../chunk-PCJRHW66.cjs');
+require('../chunk-MZXF2LF2.cjs');
 
 
 
 Object.defineProperty(exports, "createOffscript", {
   enumerable: true,
-  get: function () { return chunk2MY2FWIA_cjs.createOffscript; }
+  get: function () { return chunkRAUSXUGS_cjs.createOffscript; }
 });
 Object.defineProperty(exports, "startOffscript", {
   enumerable: true,
-  get: function () { return chunk2MY2FWIA_cjs.startOffscript; }
+  get: function () { return chunkRAUSXUGS_cjs.startOffscript; }
 });
 //# sourceMappingURL=vanilla.cjs.map
 //# sourceMappingURL=vanilla.cjs.map

package/dist/adapters/vanilla.js

@@ -1,5 +1,5 @@
-export { createOffscript, startOffscript } from '../chunk-V2YYWGIA.js';
-import '../chunk-XBXFGCUT.js';
-import '../chunk-6ROP37WI.js';
+export { createOffscript, startOffscript } from '../chunk-R2PPPR4K.js';
+import '../chunk-5ZBR6FI5.js';
+import '../chunk-KHKIWCLM.js';
 //# sourceMappingURL=vanilla.js.map
 //# sourceMappingURL=vanilla.js.map

package/dist/adapters/vue.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-var chunkVYCDQLP7_cjs = require('../chunk-VYCDQLP7.cjs');
-require('../chunk-HPDLEAAL.cjs');
+var chunkPCJRHW66_cjs = require('../chunk-PCJRHW66.cjs');
+require('../chunk-MZXF2LF2.cjs');
 
 // src/adapters/vue.ts
 var OFFSCRIPT_KEY = "$offscript";
 var OffscriptPlugin = {
   install(app, config) {
-    const sdk = new chunkVYCDQLP7_cjs.Offscript(config);
+    const sdk = new chunkPCJRHW66_cjs.Offscript(config);
     void sdk.init().catch(() => void 0);
     if (app.config?.globalProperties) {
       app.config.globalProperties[OFFSCRIPT_KEY] = sdk;

package/dist/adapters/vue.js

@@ -1,5 +1,5 @@
-import { Offscript } from '../chunk-XBXFGCUT.js';
-import '../chunk-6ROP37WI.js';
+import { Offscript } from '../chunk-5ZBR6FI5.js';
+import '../chunk-KHKIWCLM.js';
 
 // src/adapters/vue.ts
 var OFFSCRIPT_KEY = "$offscript";

package/dist/{chunk-XBXFGCUT.js → chunk-5ZBR6FI5.js}

@@ -1,4 +1,4 @@
-import { buildPlaywrightContract, SDK_VERSION, SelectorGenerator, ACTION_SCHEMA_VERSION } from './chunk-6ROP37WI.js';
+import { buildPlaywrightContract, SDK_VERSION, SelectorGenerator, ACTION_SCHEMA_VERSION } from './chunk-KHKIWCLM.js';
 
 // src/types/config.ts
 var DEFAULT_RECORDING = {
@@ -1531,6 +1531,7 @@ function resolveConfig(input) {
     privacy: resolvePrivacy(input.privacy),
     correlationWindowMs: input.correlationWindowMs ?? 3e3,
     controls: input.controls ?? true,
+    endpoint: input.endpoint,
     persistenceKey: input.persistenceKey,
     onComplete: input.onComplete
   };
@@ -2209,6 +2210,19 @@ var SUCCESS_TEMPLATE = `
 `;
 
 // src/core/OffscriptSDK.ts
+var TOKEN_STORAGE_KEY = "offscript-session-token";
+var DRAFT_STORAGE_KEY = "offscript-draft-key";
+var COMPLETED_TOKEN_STORAGE_KEY = "offscript-completed-token";
+function tokenFingerprint(token) {
+  let first = 2166136261;
+  let second = 2654435769;
+  for (let index = 0; index < token.length; index++) {
+    const character = token.charCodeAt(index);
+    first = Math.imul(first ^ character, 16777619);
+    second = Math.imul(second ^ character, 2246822519);
+  }
+  return `${first >>> 0}.${second >>> 0}`;
+}
 var Offscript = class {
   constructor(config = {}) {
     this.bus = new Emitter();
@@ -2224,6 +2238,7 @@ var Offscript = class {
     this.sequence = 0;
     this.pageId = uid("page_");
     this.submitted = false;
+    this.launchTokenChanged = false;
     this.config = resolveConfig(config);
     this.sanitizer = new DataSanitizer(this.config.privacy);
   }
@@ -2236,17 +2251,70 @@ var Offscript = class {
   async init() {
     this.assertAlive();
     if (typeof window === "undefined") throw new OffscriptError("NOT_SUPPORTED", "O SDK requer um navegador");
-    this.initPromise ?? (this.initPromise = this.initializeDraft());
+    this.initPromise ?? (this.initPromise = this.initialize());
     await this.initPromise;
     if (this.restorePromise) await this.restorePromise;
-    if (this.config.controls && !this.controls) {
+    if (this.config.controls && this.launchToken && !this.controls) {
       this.controls = new RecordingControls(this);
       this.controls.mount();
     }
   }
+  async initialize() {
+    this.resolveLaunchToken();
+    if (this.launchToken && !this.config.persistenceKey) {
+      this.config.persistenceKey = this.getOrCreateDraftKey();
+    }
+    await this.initializeDraft();
+  }
+  resolveLaunchToken() {
+    const incomingToken = new URLSearchParams(window.location.search).get("offscript_token")?.trim();
+    const previousToken = this.readSessionValue(TOKEN_STORAGE_KEY);
+    const completedToken = this.readSessionValue(COMPLETED_TOKEN_STORAGE_KEY);
+    const legacyCompletion = completedToken === "1" && Boolean(previousToken);
+    const completedFingerprint = legacyCompletion && previousToken ? tokenFingerprint(previousToken) : completedToken;
+    const candidateToken = incomingToken || previousToken || void 0;
+    this.launchTokenChanged = Boolean(incomingToken && previousToken && incomingToken !== previousToken) || Boolean(incomingToken && completedFingerprint && completedFingerprint !== "1" && tokenFingerprint(incomingToken) !== completedFingerprint);
+    if (this.launchTokenChanged) {
+      this.removeSessionValue(COMPLETED_TOKEN_STORAGE_KEY);
+    }
+    if (legacyCompletion && previousToken && !this.launchTokenChanged) {
+      this.writeSessionValue(COMPLETED_TOKEN_STORAGE_KEY, tokenFingerprint(previousToken));
+      this.removeSessionValue(TOKEN_STORAGE_KEY);
+    }
+    const isCompleted = Boolean(candidateToken && completedFingerprint === tokenFingerprint(candidateToken));
+    this.launchToken = isCompleted ? void 0 : candidateToken;
+    if (incomingToken && !isCompleted) this.writeSessionValue(TOKEN_STORAGE_KEY, incomingToken);
+  }
+  getOrCreateDraftKey() {
+    const saved = this.readSessionValue(DRAFT_STORAGE_KEY);
+    if (saved) return saved;
+    const key = uid("draft_");
+    this.writeSessionValue(DRAFT_STORAGE_KEY, key);
+    return key;
+  }
+  readSessionValue(key) {
+    try {
+      return window.sessionStorage.getItem(key);
+    } catch {
+      return null;
+    }
+  }
+  writeSessionValue(key, value) {
+    try {
+      window.sessionStorage.setItem(key, value);
+    } catch {
+    }
+  }
+  removeSessionValue(key) {
+    try {
+      window.sessionStorage.removeItem(key);
+    } catch {
+    }
+  }
   async initializeDraft() {
     if (!this.config.persistenceKey) return;
     this.store = await RecordingStore.open(this.config.persistenceKey);
+    if (this.launchTokenChanged) await this.store.clear();
     await this.restoreDraft();
   }
   async restoreDraft() {
@@ -2356,7 +2424,7 @@ var Offscript = class {
     this.bus.emit("recordingEnd", this.payload);
     return this.payload;
   }
-  complete(options) {
+  complete(options = {}) {
     this.assertAlive();
     if (this.completePromise) return this.completePromise;
     if (this.submitted) return Promise.resolve(this.response);
@@ -2365,19 +2433,27 @@ var Offscript = class {
     });
     return this.completePromise;
   }
-  async doComplete({ endpoint, token }) {
+  async doComplete(options) {
+    const endpoint = options.endpoint ?? this.config.endpoint;
+    const token = options.token?.trim() || this.launchToken;
+    if (!endpoint) throw new ConfigError("Endpoint HTTP obrigat\xF3rio para envio");
+    if (!token) throw new ConfigError("Token obrigat\xF3rio para envio");
     const url = new URL(endpoint, location.href);
     if (!["https:", "http:"].includes(url.protocol)) throw new ConfigError("Endpoint HTTP inv\xE1lido");
-    if (!token?.trim()) throw new ConfigError("Token obrigat\xF3rio para envio");
     const payload = await this.stopRecording();
     try {
       const response = await fetch(url.href, {
         method: "POST",
-        headers: { "Content-Type": "application/json", Accept: "application/json", Authorization: `Bearer ${token.trim()}` },
+        headers: { "Content-Type": "application/json", Accept: "application/json", Authorization: `Bearer ${token}` },
         body: JSON.stringify(payload)
       });
       if (!response.ok) throw new OffscriptError("TRANSPORT_FAILED", `Falha ao enviar grava\xE7\xE3o: HTTP ${response.status}`, { status: response.status });
       this.submitted = true;
+      const completedToken = this.launchToken ?? token;
+      this.writeSessionValue(COMPLETED_TOKEN_STORAGE_KEY, tokenFingerprint(completedToken));
+      this.removeSessionValue(TOKEN_STORAGE_KEY);
+      this.removeSessionValue(DRAFT_STORAGE_KEY);
+      this.launchToken = void 0;
       await this.store?.clear();
       const text = await response.text();
       try {
@@ -2387,6 +2463,8 @@ var Offscript = class {
       }
       this.lastError = void 0;
       this.controls?.showSuccess();
+      this.controls?.unmount();
+      this.controls = void 0;
       return this.response;
     } catch (error) {
       const err = error instanceof Error ? error : new Error(String(error));
@@ -2397,6 +2475,7 @@ var Offscript = class {
   }
   async finishRecording() {
     if (this.config.onComplete) return this.config.onComplete();
+    if (this.launchToken) return this.complete();
     return this.stopRecording();
   }
   async discardRecording() {
@@ -2573,5 +2652,5 @@ var Offscript = class {
 Offscript.version = SDK_VERSION;
 
 export { ConfigError, DEFAULT_PRIVACY, DEFAULT_RECORDING, DataSanitizer, InvalidStateError, Offscript, OffscriptError };
-//# sourceMappingURL=chunk-XBXFGCUT.js.map
-//# sourceMappingURL=chunk-XBXFGCUT.js.map
+//# sourceMappingURL=chunk-5ZBR6FI5.js.map
+//# sourceMappingURL=chunk-5ZBR6FI5.js.map