@monzori/browser 0.1.2 → 0.1.3

package/README.md

@@ -35,6 +35,18 @@ monzori.captureException(new Error('Evento explícito de teste'));
 
 O endereço padrão é `https://ingest.monzori.com.br/v1/web/events`. `apiKey` é o identificador público restrito à ingestão da fonte, não uma senha de administração. A inicialização devolve o client usado no Error Boundary e no reporte manual. Há também o export nomeado `start`.
 
+Na versão 0.1.3, erros tratados podem ser enviados por `Monzori.notify(error, contextoOpcional)` ou pelo export nomeado `notify`. Aceita Error, string e os valores já suportados por captureException, usando o mesmo client ativo, sanitização, fila e transporte protegido. Não exige endpoint separado. Antes de start ou depois de close, notify não envia e não lança. O método client.captureException continua compatível.
+
+```js
+try {
+  // ação da aplicação
+} catch (error) {
+  Monzori.notify(error, {flow: 'login'});
+}
+```
+
+Uma resposta HTTP400 tratada não gera erro global: é preciso reportá-la explicitamente quando representar um problema que se deseja monitorar. Chamadas a Bugsnag.notify não são interceptadas pelo Monzori. No frontend cliente, a função reportError centraliza o reporte aos dois SDKs, isolando as falhas de cada destino; durante a carga inicial do chunk, espera no máximo3s e mantém no máximo20 chamadas pendentes. Nenhum reporte é aguardado pela ação da aplicação.
+
 `endpoint` é uma opção avançada: para testes locais, informar `http://localhost:3333/v1/web/events`; destinos fora de loopback exigem HTTPS. Um endpoint explícito inválido desabilita o envio, sem fallback silencioso. O endereço padrão não implica que a infraestrutura do piloto já esteja publicada.
 
 Compatibilidade: `initMonzori({publicKey, release, endpoint})` continua funcionando como alias legado, usando o mesmo client; preferir `Monzori.start({apiKey, release})` nas novas integrações. Escolher `apiKey` ou `publicKey`, sem combinar os dois. A primeira inicialização fica ativa até `close()`, sem duplicar listeners em chamadas subsequentes.

package/dist/index.d.ts

@@ -46,7 +46,9 @@ export type Client = {
 export declare function start(options: Options): Client;
 /** @deprecated Use Monzori.start(options) or the named start export. */
 export declare const initMonzori: typeof start;
+export declare function notify(error: unknown, context?: unknown): void;
 declare const Monzori: {
     start: typeof start;
+    notify: typeof notify;
 };
 export default Monzori;

package/dist/index.js

@@ -270,5 +270,13 @@ function createClient(options, restorers) {
 }
 /** @deprecated Use Monzori.start(options) or the named start export. */
 export const initMonzori = start;
-const Monzori = { start };
+// Manual reporting uses the same guarded capture/queue as automatic errors.
+// Before start() or after close(), reporting is intentionally a no-op.
+export function notify(error, context) {
+    try {
+        active?.captureException(error, context);
+    }
+    catch { /* Telemetry never escapes into the caller. */ }
+}
+const Monzori = { start, notify };
 export default Monzori;

package/package.json

@@ -1,6 +1,6 @@
 {
  "name": "@monzori/browser",
- "version": "0.1.2",
+ "version": "0.1.3",
  "description": "Browser error and console collection SDK for Monzori",
  "publishConfig": {
   "access": "public",