@offscript/sdk 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,134 @@
-# Temporary Holding Version
+# @offscript/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+SDK de instrumentação para aplicações web testadas manualmente por QA. Captura, de forma modular e agnóstica de framework, tudo o que é necessário para **reproduzir** a sessão (rrweb), **investigar** (ações, rede, erros, contexto) e, no futuro, **automatizar** (contrato Playwright), enviando os eventos para a API da Offscript.
+
+Funciona em JS puro, Vue 2/3, Nuxt, React, Laravel Blade e Inertia, em SPA e MPA. O núcleo não depende de nenhum framework.
+
+> Estado: `0.1.0`. Veja [Limitações conhecidas](#limitações-conhecidas) e o [relatório de testes](#testes).
+
+## Instalação
+
+```bash
+npm install @offscript/sdk
+```
+
+## Uso
+
+```ts
+import { Offscript } from "@offscript/sdk";
+
+const offscript = new Offscript({
+  apiUrl: "https://api.offscript.example",
+  platformId: "platform-id",
+  appVersion: "1.4.2",
+  recording: { rrweb: true, actions: true, http: true, console: true, errors: true },
+  privacy: { maskSensitiveInputs: true, captureRequestBodies: false, captureResponseBodies: false },
+});
+
+await offscript.init();                       // retoma sessão persistida (reload / MPA), se houver
+await offscript.startRecording({
+  testCaseId: "test-case-id",
+  executionId: "execution-id",
+  sessionToken: "short-lived-session-token", // emitido pelo SEU backend; nunca uma chave permanente
+});
+await offscript.pauseRecording();             // retomar gera um novo snapshot completo
+await offscript.resumeRecording();
+const summary = await offscript.stopRecording(); // { flushed, pendingEvents, completed }
+await offscript.destroy();
+```
+
+Todos os métodos são **idempotentes** (`init`, `startRecording` com a mesma execução, `stopRecording`, `pause/resume`, `destroy`). Chamadas concorrentes de `startRecording` compartilham a mesma promise; iniciar outra execução com uma ativa lança `InvalidStateError`.
+
+### Estados e eventos
+`idle → initializing → recording ⇄ paused → stopping → stopped` (e `error`). `offscript.getState()` devolve `{ status, session, pending, lastError }`.
+
+```ts
+offscript.on("statusChange", ({ from, to }) => …);
+offscript.on("error", (e) => …);       // OffscriptError tipado (e.code)
+offscript.on("sessionStart" | "sessionEnd" | "flush" | "overflow" | "disabled", …);
+```
+Erros tipados: `ConfigError`, `AuthError`, `SessionExpiredError`, `SessionDisabledError`, `InvalidStateError`, `TransportError` (todos estendem `OffscriptError` com `code`).
+
+### Autorização
+A gravação só começa depois que `POST /sdk/sessions` autoriza o token e responde `recording.enabled: true`. O token é guardado só em `sessionStorage` (escopo da aba) e usado em `Authorization: Bearer`; renovações chegam em `sessionToken` nas respostas. O backend pode desativar remotamente via heartbeat.
+
+## Configuração
+
+| Opção | Padrão | Descrição |
+|---|---|---|
+| `apiUrl` | — | HTTPS obrigatório (HTTP só em localhost) |
+| `platformId` | — | Plataforma do SDK |
+| `appVersion` | — | Versão/build da app, enviada no contexto |
+| `autoResume` | `true` | Retoma sessão persistida em `init()` |
+| `correlationWindowMs` | `3000` | Janela para ligar http/erros à ação anterior |
+| `heartbeatIntervalMs` | `30000` | Usado se o backend não informar |
+| `recording.rrweb/actions/http/console/errors/context/iframes` | `true` | Liga cada módulo |
+| `recording.mouseMove` | `false` | Trajetória do mouse nas *ações* (rrweb já grava o movimento) |
+| `recording.consoleLevels` | todos | `log`, `info`, `warn`, `error` |
+| `recording.throttleMs` | `100` | Amostragem de mousemove |
+| `recording.rrwebCheckoutEveryMs` | `300000` | Snapshot completo periódico (0 desliga) |
+| `recording.rrwebRecordCanvas` | `false` | Canvas (custoso) |
+| `recording.testIdAttributes` | `data-testid, data-test, data-cy, data-qa` | Atributos de teste para seletores |
+| `recording.stableAttributes` | `name, data-id, aria-label` | Atributos estáveis extras |
+| `privacy.maskSensitiveInputs` | `true` | Máscara de inputs no replay |
+| `privacy.maskAllText` | `false` | Máscara de todo texto no replay |
+| `privacy.captureRequestBodies / captureResponseBodies` | `false` | Bodies HTTP |
+| `privacy.allowedInputSelectors` | `[data-offscript-allow]` | Campos cujo valor pode ser gravado |
+| `privacy.blockSelectors / maskTextSelectors / ignoreSelectors` | `[data-offscript-block]`… | Bloquear, mascarar texto, ignorar ações |
+| `privacy.ignoreUrls` | `[]` | Requisições não capturadas (string ou RegExp) |
+| `privacy.redactHeaders / redactKeys` | `[]` | Extras além do padrão |
+| `privacy.maxBodyBytes` | `16384` | Limite de body capturado |
+| `privacy.localRetentionMs` | `86400000` | Retenção local de eventos não enviados |
+| `transport.*` | ver `DEFAULT_TRANSPORT` | lote, flush, memória, retries, `compress` (gzip; requer suporte no backend), `persist` (IndexedDB) |
+
+### Privacidade (padrão seguro)
+Senhas, tokens, `Authorization`, cookies, chaves de API, JWT, CPF/CNPJ e cartões (Luhn) são redigidos **antes** de persistir ou enviar — em headers, query, bodies, console, erros, URLs/atributos/textos do rrweb. Valores digitados não vão para as ações (viram `valueRef`) a não ser em campos com `data-offscript-allow`. Use `data-offscript-block` / `.offscript-block` para remover um elemento do replay e `data-offscript-ignore` para ignorar suas ações. Isso ajuda a atender a LGPD, mas **não a substitui**: a base legal, o aviso aos testadores, a retenção e a exclusão no servidor são responsabilidade da Offscript/cliente.
+
+## Adaptadores
+`@offscript/sdk/vue` (Vue 2/3, sem importar Vue), `@offscript/sdk/nuxt` (client-only), `@offscript/sdk/vanilla` (`createOffscript`, `startOffscript`). Exemplos em [examples/](./examples).
+
+## Playwright
+`offscript.exportPlaywrightData()` ou `buildPlaywrightContract()` (de `@offscript/sdk/playwright`) — ver [docs/playwright-contract.md](./docs/playwright-contract.md). O SDK não executa Playwright.
+
+## Documentação
+- [Arquitetura e decisões](./docs/architecture.md)
+- [Contrato da API](./docs/api-contract.md) — **o backend da Offscript precisa implementá-lo; este repositório só traz um servidor de referência de testes**
+- [Contrato de eventos](./docs/event-contract.md)
+- [Contrato Playwright](./docs/playwright-contract.md)
+
+## Limitações conhecidas
+- **Iframes cross-origin (ex.: seats.io)**: nem o SDK nem o rrweb acessam o conteúdo interno. São registrados presença (`origin` + `path`, sem query), dimensões, posição, foco (quando observável) e interações visíveis na página principal. Caminhos futuros: instrumentação/eventos públicos do seats.io, ou captura complementar via Playwright em ambiente de teste autorizado — **não implementados**.
+- **HTTP**: só `fetch` e `XMLHttpRequest` da página principal. Não captura WebSocket, requisições de iframes cross-origin, Service Workers, cookies HttpOnly, headers protegidos, nem `fetch` chamado antes do SDK iniciar. `duration` do fetch é até os headers. Bodies de streaming/binário são omitidos. Bodies de request do tipo `Request`/stream não são lidos.
+- **Console**: o stack aponta para o wrapper; arquivo/linha de `console.*` não é o da chamada original no DevTools.
+- **Entrega ao fechar a aba**: usa `fetch keepalive` (≤ 60 KB) sem ACK; o que não chegar é reenviado na próxima página da mesma aba. Se o navegador for encerrado abruptamente (crash, fechamento da última aba), **não há garantia de entrega** — eventos pendentes ficam no IndexedDB até a próxima sessão da aba/origem ou expirarem.
+- **Multi-aba**: gravação por aba (cada uma com `tabId` e sequência próprios). A detecção de aba clonada exige `navigator.locks`.
+- **Replay**: só reproduz o DOM gravado (iframe sandbox sem scripts). Canvas é opcional e custoso; vídeo/áudio e Shadow DOM fechado seguem as limitações do rrweb. `mousemove` sofre amostragem.
+- **Backpressure**: com a fila cheia, eventos de baixa prioridade são descartados (`overflow`) e o SDK força novo snapshot rrweb.
+- O `exportPlaywrightData()` do navegador cobre as ações da página atual (memória, até 5000); para a sessão inteira use `buildPlaywrightContract` com os eventos armazenados no backend.
+- **Não verificado**: execução em aplicações Vue/Nuxt/Laravel/Inertia reais, navegadores além do Chromium, Safari/iOS (limites de `keepalive`/IndexedDB), carga em páginas muito grandes (só há métricas internas `getMetrics()`, sem benchmark).
+
+## Desenvolvimento
+
+```bash
+npm install
+npm run typecheck
+npm test            # 69 testes (vitest + jsdom + servidor HTTP de referência real)
+npm run test:e2e    # Playwright em Chromium real (npx playwright install chromium)
+npm run build       # tsup (ESM+CJS) + tsc (declarações)
+```
+
+### Testes
+| Suite | Cobertura |
+|---|---|
+| `tests/session` | init, token inválido, desativação remota, idempotência, pausa/retomada, reload, sessão expirada, heartbeat, 401 no envio |
+| `tests/transport` | lotes ordenados, ACK, falha 5xx + backoff, persistência/recuperação, idempotência, 413, backpressure, flush final, offline/online, gzip |
+| `tests/rrweb` | snapshot, mutações, máscara de inputs, redação de URLs, pausa+snapshot, **replay** com `Replayer` |
+| `tests/actions` | click, input, select, checkbox, teclado, scroll, hover, drag, SPA, seletores |
+| `tests/http` | fetch ok/erro/abort/concorrente/grande/binário, XHR, sanitização, exclusão da própria API, correlação, remoção segura |
+| `tests/observability` | console, recursão, erros globais, correlação, contexto, iframe seats.io |
+| `tests/playwright` | normalização, contrato, validação, SelectorGenerator |
+| `tests/compat` | MPA com reload, SPA/Inertia, multi-aba, adaptadores Vue/Nuxt/vanilla, falha de recorder, destroy |
+| `e2e/mpa.spec.ts` | **Chromium real**: gravação com navegação MPA + reload + SPA, privacidade, correlação, contrato, replay completo no player rrweb |
+
+### Publicação
+Versionamento semântico (`MAJOR.MINOR.PATCH`); mudanças incompatíveis nos contratos de evento/Playwright incrementam o `schemaVersion`/`contractVersion` major. Fluxo: `npm version <patch|minor|major>` → `npm run verify` → `npm publish --access public` (o `prepublishOnly` já roda typecheck, testes e build).

package/dist/adapters/nuxt.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var chunk3NX2AGXM_cjs = require('../chunk-3NX2AGXM.cjs');
+require('../chunk-B6GO5FE5.cjs');
+
+// src/adapters/nuxt.ts
+function createNuxtOffscript(config) {
+  if (typeof window === "undefined") return null;
+  const sdk = new chunk3NX2AGXM_cjs.Offscript(config);
+  void sdk.init().catch(() => void 0);
+  return sdk;
+}
+
+exports.createNuxtOffscript = createNuxtOffscript;
+//# sourceMappingURL=nuxt.cjs.map
+//# sourceMappingURL=nuxt.cjs.map

package/dist/adapters/nuxt.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/nuxt.ts"],"names":["Offscript"],"mappings":";;;;;;AAUO,SAAS,oBAAoB,MAAA,EAA2C;AAC7E,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,IAAA;AAC1C,EAAA,MAAM,GAAA,GAAM,IAAIA,2BAAA,CAAU,MAAM,CAAA;AAChC,EAAA,KAAK,GAAA,CAAI,IAAA,EAAK,CAAE,KAAA,CAAM,MAAM,MAAS,CAAA;AACrC,EAAA,OAAO,GAAA;AACT","file":"nuxt.cjs","sourcesContent":["import { Offscript } from \"../core/OffscriptSDK\";\nimport type { OffscriptConfig } from \"../types/config\";\n\n/**\n * Uso em plugin client-only do Nuxt (plugins/offscript.client.ts):\n *\n *   export default defineNuxtPlugin(() => ({ provide: { offscript: createNuxtOffscript({...}) } }))\n *\n * Retorna null no servidor (SSR) para que nada seja instanciado fora do navegador.\n */\nexport function createNuxtOffscript(config: OffscriptConfig): Offscript | null {\n  if (typeof window === \"undefined\") return null;\n  const sdk = new Offscript(config);\n  void sdk.init().catch(() => undefined);\n  return sdk;\n}\n"]}

package/dist/adapters/nuxt.d.ts

@@ -0,0 +1,10 @@
+import { Offscript } from "../core/OffscriptSDK";
+import type { OffscriptConfig } from "../types/config";
+/**
+ * Uso em plugin client-only do Nuxt (plugins/offscript.client.ts):
+ *
+ *   export default defineNuxtPlugin(() => ({ provide: { offscript: createNuxtOffscript({...}) } }))
+ *
+ * Retorna null no servidor (SSR) para que nada seja instanciado fora do navegador.
+ */
+export declare function createNuxtOffscript(config: OffscriptConfig): Offscript | null;

package/dist/adapters/nuxt.js

@@ -0,0 +1,14 @@
+import { Offscript } from '../chunk-3OSCH7J2.js';
+import '../chunk-LFXHB4PN.js';
+
+// src/adapters/nuxt.ts
+function createNuxtOffscript(config) {
+  if (typeof window === "undefined") return null;
+  const sdk = new Offscript(config);
+  void sdk.init().catch(() => void 0);
+  return sdk;
+}
+
+export { createNuxtOffscript };
+//# sourceMappingURL=nuxt.js.map
+//# sourceMappingURL=nuxt.js.map

package/dist/adapters/nuxt.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/nuxt.ts"],"names":[],"mappings":";;;;AAUO,SAAS,oBAAoB,MAAA,EAA2C;AAC7E,EAAA,IAAI,OAAO,MAAA,KAAW,WAAA,EAAa,OAAO,IAAA;AAC1C,EAAA,MAAM,GAAA,GAAM,IAAI,SAAA,CAAU,MAAM,CAAA;AAChC,EAAA,KAAK,GAAA,CAAI,IAAA,EAAK,CAAE,KAAA,CAAM,MAAM,MAAS,CAAA;AACrC,EAAA,OAAO,GAAA;AACT","file":"nuxt.js","sourcesContent":["import { Offscript } from \"../core/OffscriptSDK\";\nimport type { OffscriptConfig } from \"../types/config\";\n\n/**\n * Uso em plugin client-only do Nuxt (plugins/offscript.client.ts):\n *\n *   export default defineNuxtPlugin(() => ({ provide: { offscript: createNuxtOffscript({...}) } }))\n *\n * Retorna null no servidor (SSR) para que nada seja instanciado fora do navegador.\n */\nexport function createNuxtOffscript(config: OffscriptConfig): Offscript | null {\n  if (typeof window === \"undefined\") return null;\n  const sdk = new Offscript(config);\n  void sdk.init().catch(() => undefined);\n  return sdk;\n}\n"]}

package/dist/adapters/vanilla.cjs

@@ -0,0 +1,18 @@
+'use strict';
+
+var chunkHAPNSHFG_cjs = require('../chunk-HAPNSHFG.cjs');
+require('../chunk-3NX2AGXM.cjs');
+require('../chunk-B6GO5FE5.cjs');
+
+
+
+Object.defineProperty(exports, "createOffscript", {
+  enumerable: true,
+  get: function () { return chunkHAPNSHFG_cjs.createOffscript; }
+});
+Object.defineProperty(exports, "startOffscript", {
+  enumerable: true,
+  get: function () { return chunkHAPNSHFG_cjs.startOffscript; }
+});
+//# sourceMappingURL=vanilla.cjs.map
+//# sourceMappingURL=vanilla.cjs.map

package/dist/adapters/vanilla.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"vanilla.cjs"}

package/dist/adapters/vanilla.d.ts

@@ -0,0 +1,6 @@
+import { Offscript } from "../core/OffscriptSDK";
+import type { OffscriptConfig } from "../types/config";
+import type { StartRecordingOptions } from "../types/session";
+/** Atalho para aplicações JS tradicionais, Blade e MPA: inicializa e retoma sessões persistidas. */
+export declare function createOffscript(config: OffscriptConfig): Promise<Offscript>;
+export declare function startOffscript(config: OffscriptConfig, start: StartRecordingOptions): Promise<Offscript>;

package/dist/adapters/vanilla.js

@@ -0,0 +1,5 @@
+export { createOffscript, startOffscript } from '../chunk-MBYNQSKA.js';
+import '../chunk-3OSCH7J2.js';
+import '../chunk-LFXHB4PN.js';
+//# sourceMappingURL=vanilla.js.map
+//# sourceMappingURL=vanilla.js.map

package/dist/adapters/vanilla.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"vanilla.js"}

package/dist/adapters/vue.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+var chunk3NX2AGXM_cjs = require('../chunk-3NX2AGXM.cjs');
+require('../chunk-B6GO5FE5.cjs');
+
+// src/adapters/vue.ts
+var OFFSCRIPT_KEY = "$offscript";
+var OffscriptPlugin = {
+  install(app, config) {
+    const sdk = new chunk3NX2AGXM_cjs.Offscript(config);
+    void sdk.init().catch(() => void 0);
+    if (app.config?.globalProperties) {
+      app.config.globalProperties[OFFSCRIPT_KEY] = sdk;
+      app.provide?.(OFFSCRIPT_KEY, sdk);
+    } else if (app.prototype) {
+      app.prototype[OFFSCRIPT_KEY] = sdk;
+    }
+  }
+};
+
+exports.OFFSCRIPT_KEY = OFFSCRIPT_KEY;
+exports.OffscriptPlugin = OffscriptPlugin;
+//# sourceMappingURL=vue.cjs.map
+//# sourceMappingURL=vue.cjs.map

package/dist/adapters/vue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/vue.ts"],"names":["Offscript"],"mappings":";;;;;;AAGO,IAAM,aAAA,GAAgB;AAatB,IAAM,eAAA,GAAkB;AAAA,EAC7B,OAAA,CAAQ,KAAiB,MAAA,EAA+B;AACtD,IAAA,MAAM,GAAA,GAAM,IAAIA,2BAAA,CAAU,MAAM,CAAA;AAEhC,IAAA,KAAK,GAAA,CAAI,IAAA,EAAK,CAAE,KAAA,CAAM,MAAM,MAAS,CAAA;AACrC,IAAA,IAAI,GAAA,CAAI,QAAQ,gBAAA,EAAkB;AAChC,MAAA,GAAA,CAAI,MAAA,CAAO,gBAAA,CAAiB,aAAa,CAAA,GAAI,GAAA;AAC7C,MAAA,GAAA,CAAI,OAAA,GAAU,eAAe,GAAG,CAAA;AAAA,IAClC,CAAA,MAAA,IAAW,IAAI,SAAA,EAAW;AACxB,MAAA,GAAA,CAAI,SAAA,CAAU,aAAa,CAAA,GAAI,GAAA;AAAA,IACjC;AAAA,EACF;AACF","file":"vue.cjs","sourcesContent":["import { Offscript } from \"../core/OffscriptSDK\";\nimport type { OffscriptConfig } from \"../types/config\";\n\nexport const OFFSCRIPT_KEY = \"$offscript\";\n\ninterface VueAppLike {\n  config?: { globalProperties?: Record<string, unknown> };\n  provide?: (key: string, value: unknown) => void;\n  mixin?: (m: unknown) => void;\n  prototype?: Record<string, unknown>;\n}\n\n/**\n * Plugin Vue 3 (app.use) e Vue 2 (Vue.use). Não importa Vue: funciona via duck typing.\n * A gravação não é iniciada automaticamente; chame `this.$offscript.startRecording(...)`.\n */\nexport const OffscriptPlugin = {\n  install(app: VueAppLike, config: OffscriptConfig): void {\n    const sdk = new Offscript(config);\n    // init assíncrono: erros ficam disponíveis via sdk.on('error')\n    void sdk.init().catch(() => undefined);\n    if (app.config?.globalProperties) {\n      app.config.globalProperties[OFFSCRIPT_KEY] = sdk; // Vue 3\n      app.provide?.(OFFSCRIPT_KEY, sdk);\n    } else if (app.prototype) {\n      app.prototype[OFFSCRIPT_KEY] = sdk; // Vue 2 (Vue.use(OffscriptPlugin, config) passa o construtor)\n    }\n  },\n};\n"]}

package/dist/adapters/vue.d.ts

@@ -0,0 +1,18 @@
+import type { OffscriptConfig } from "../types/config";
+export declare const OFFSCRIPT_KEY = "$offscript";
+interface VueAppLike {
+    config?: {
+        globalProperties?: Record<string, unknown>;
+    };
+    provide?: (key: string, value: unknown) => void;
+    mixin?: (m: unknown) => void;
+    prototype?: Record<string, unknown>;
+}
+/**
+ * Plugin Vue 3 (app.use) e Vue 2 (Vue.use). Não importa Vue: funciona via duck typing.
+ * A gravação não é iniciada automaticamente; chame `this.$offscript.startRecording(...)`.
+ */
+export declare const OffscriptPlugin: {
+    install(app: VueAppLike, config: OffscriptConfig): void;
+};
+export {};

package/dist/adapters/vue.js

@@ -0,0 +1,21 @@
+import { Offscript } from '../chunk-3OSCH7J2.js';
+import '../chunk-LFXHB4PN.js';
+
+// src/adapters/vue.ts
+var OFFSCRIPT_KEY = "$offscript";
+var OffscriptPlugin = {
+  install(app, config) {
+    const sdk = new Offscript(config);
+    void sdk.init().catch(() => void 0);
+    if (app.config?.globalProperties) {
+      app.config.globalProperties[OFFSCRIPT_KEY] = sdk;
+      app.provide?.(OFFSCRIPT_KEY, sdk);
+    } else if (app.prototype) {
+      app.prototype[OFFSCRIPT_KEY] = sdk;
+    }
+  }
+};
+
+export { OFFSCRIPT_KEY, OffscriptPlugin };
+//# sourceMappingURL=vue.js.map
+//# sourceMappingURL=vue.js.map

package/dist/adapters/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/adapters/vue.ts"],"names":[],"mappings":";;;;AAGO,IAAM,aAAA,GAAgB;AAatB,IAAM,eAAA,GAAkB;AAAA,EAC7B,OAAA,CAAQ,KAAiB,MAAA,EAA+B;AACtD,IAAA,MAAM,GAAA,GAAM,IAAI,SAAA,CAAU,MAAM,CAAA;AAEhC,IAAA,KAAK,GAAA,CAAI,IAAA,EAAK,CAAE,KAAA,CAAM,MAAM,MAAS,CAAA;AACrC,IAAA,IAAI,GAAA,CAAI,QAAQ,gBAAA,EAAkB;AAChC,MAAA,GAAA,CAAI,MAAA,CAAO,gBAAA,CAAiB,aAAa,CAAA,GAAI,GAAA;AAC7C,MAAA,GAAA,CAAI,OAAA,GAAU,eAAe,GAAG,CAAA;AAAA,IAClC,CAAA,MAAA,IAAW,IAAI,SAAA,EAAW;AACxB,MAAA,GAAA,CAAI,SAAA,CAAU,aAAa,CAAA,GAAI,GAAA;AAAA,IACjC;AAAA,EACF;AACF","file":"vue.js","sourcesContent":["import { Offscript } from \"../core/OffscriptSDK\";\nimport type { OffscriptConfig } from \"../types/config\";\n\nexport const OFFSCRIPT_KEY = \"$offscript\";\n\ninterface VueAppLike {\n  config?: { globalProperties?: Record<string, unknown> };\n  provide?: (key: string, value: unknown) => void;\n  mixin?: (m: unknown) => void;\n  prototype?: Record<string, unknown>;\n}\n\n/**\n * Plugin Vue 3 (app.use) e Vue 2 (Vue.use). Não importa Vue: funciona via duck typing.\n * A gravação não é iniciada automaticamente; chame `this.$offscript.startRecording(...)`.\n */\nexport const OffscriptPlugin = {\n  install(app: VueAppLike, config: OffscriptConfig): void {\n    const sdk = new Offscript(config);\n    // init assíncrono: erros ficam disponíveis via sdk.on('error')\n    void sdk.init().catch(() => undefined);\n    if (app.config?.globalProperties) {\n      app.config.globalProperties[OFFSCRIPT_KEY] = sdk; // Vue 3\n      app.provide?.(OFFSCRIPT_KEY, sdk);\n    } else if (app.prototype) {\n      app.prototype[OFFSCRIPT_KEY] = sdk; // Vue 2 (Vue.use(OffscriptPlugin, config) passa o construtor)\n    }\n  },\n};\n"]}