hobots 1.1.0 → 1.2.0

package/docs/getting-started.md

@@ -8,28 +8,30 @@ pnpm add hobots
 
 Sem dependências de runtime. Requer **Node 18+** (usa o `fetch` global). O Monitor também funciona no browser para captura de erros.
 
-## O DSN
+## O Client Secret
 
-Cada projeto tem **uma única DSN** — a mesma credencial autentica o Monitor **e** o Manager:
+Cada projeto tem **um único Client Secret** — a mesma credencial autentica o Monitor **e** o Manager:
 
 ```
-<protocolo>://<secretKey>@<host>[:porta]/<projectSlug>
+hb_<64 hex>
 ```
 
-A `secretKey` (64 hex) é **secreta**: ela vai embutida na DSN só por conveniência — nas requisições viaja sempre no header `Authorization: Bearer`, nunca na URL. O `projectSlug` no path é informativo; a identidade do projeto vem da chave. Copie a DSN pronta no app, em **Configurações → Agentes** — os snippets de integração já vêm prontos.
+(Chaves antigas, 64 hex puros, continuam válidas no servidor.) A credencial é **secreta** e viaja sempre no header `Authorization: Bearer` — nunca na URL. Copie o Client Secret no app, em **Configurações → Projetos** — os snippets de integração já vêm prontos.
 
-```
-http://<secretKey>@localhost:3002/<projectSlug>
+O SDK fala com `https://app.hobots.app` por padrão; só sobrescreva `baseUrl` em desenvolvimento:
+
+```js
+Hobots.init({ clientSecret: 'hb_<64 hex>', baseUrl: 'http://localhost:3002', ... });
 ```
 
-Veja [Protocolo & transporte](./protocol.md) para os endpoints que a DSN deriva.
+Veja [Protocolo & transporte](./protocol.md) para os endpoints derivados da `baseUrl`.
 
 ## Monitor e Manager — qual usar
 
 As duas capabilities vivem no mesmo `init()` e você usa **uma, outra ou as duas**:
 
-- Quer só saber se o robô quebrou, quanto demora e se está vivo? → `init({ dsn, heartbeat: true })`.
-- Quer disparar o robô sob demanda a partir de um formulário no app? → `init({ dsn, manager: true })` + `register()` + `start()`.
+- Quer só saber se o robô quebrou, quanto demora e se está vivo? → `init({ clientSecret, heartbeat: true })`.
+- Quer disparar o robô sob demanda a partir de um formulário no app? → `init({ clientSecret, manager: true })` + `register()` + `start()`.
 - Ambos? Passe `heartbeat` e `manager` no **mesmo `init()`**. É o cenário do
   [`full.ts`](../../hobots-sdk-demos/src/full.ts) nos demos do SDK.
 
@@ -39,7 +41,8 @@ As duas capabilities vivem no mesmo `init()` e você usa **uma, outra ou as duas
 import * as Hobots from 'hobots';
 
 Hobots.init({
-  dsn: 'http://<secretKey>@localhost:3002/<projectSlug>',
+  clientSecret: 'hb_<64 hex>',
+  // baseUrl: 'http://localhost:3002', // só em desenvolvimento
   environment: 'production',
   release: 'robo-nfe@1.4.2',
   instanceId: 'vm-cliente-01', // identidade única: heartbeat + agente Manager
@@ -66,7 +69,8 @@ Habilite a execução sob demanda com o campo `manager` no mesmo `init()`:
 import * as Hobots from 'hobots';
 
 Hobots.init({
-  dsn: 'http://<secretKey>@localhost:3002/<projectSlug>',
+  clientSecret: 'hb_<64 hex>',
+  // baseUrl: 'http://localhost:3002', // só em desenvolvimento
   instanceId: 'vm-cliente-01',
   manager: true, // ou { pollIntervalMs, concurrency, ... }
 });

package/docs/manager.md

@@ -1,6 +1,6 @@
 # Manager
 
-Capability de **execução remota sob demanda**, habilitada com `manager: true` (ou opções) no `init()` único. O agente faz polling no app, executa os handlers registrados quando aparece trabalho e reporta status e logs incrementais. Usa a mesma DSN, o mesmo `debug` e o `instanceId` como identidade — nenhum handler global extra é instalado.
+Capability de **execução remota sob demanda**, habilitada com `manager: true` (ou opções) no `init()` único. O agente faz polling no app, executa os handlers registrados quando aparece trabalho e reporta status e logs incrementais. Usa o mesmo Client Secret, o mesmo `debug` e o `instanceId` como identidade — nenhum handler global extra é instalado.
 
 ## Ciclo de vida
 
@@ -8,7 +8,8 @@ Capability de **execução remota sob demanda**, habilitada com `manager: true`
 import * as Hobots from 'hobots';
 
 Hobots.init({
-  dsn: 'http://<secretKey>@localhost:3002/<projectSlug>',
+  clientSecret: 'hb_<64 hex>',
+  // baseUrl: 'http://localhost:3002', // só em desenvolvimento
   instanceId: 'vm-cliente-01',
   manager: true, // ou { pollIntervalMs, concurrency, taskTimeoutMs, logFlushIntervalMs }
 });

package/docs/monitor.md

@@ -12,7 +12,8 @@ Todas as funções abaixo são no-op seguros se `Hobots.init()` não foi chamado
 
 ```js
 Hobots.init({
-  dsn: 'http://<secretKey>@localhost:3002/<projectSlug>',
+  clientSecret: 'hb_<64 hex>',
+  // baseUrl: 'http://localhost:3002', // só em desenvolvimento
   environment: 'production',
   release: 'robo-nfe@1.4.2',
   instanceId: 'vm-cliente-01',
@@ -119,7 +120,7 @@ Bate "estou vivo" periodicamente; o servidor acusa o robô **offline** quando os
 
 ```js
 Hobots.init({
-  dsn,
+  clientSecret,
   heartbeat: { intervalMs: 30_000, name: 'Robô NFe — VM 01' },
 });
 ```

package/docs/protocol.md

@@ -4,22 +4,22 @@ O SDK é um **cliente HTTP puro**, sem dependências de runtime: ele só fala co
 
 Os arquivos `src/protocol.ts` e `src/manager/protocol.ts` são a **fonte de verdade do wire format**: o app valida os payloads com zod travados nesses tipos (`satisfies z.ZodType<...>`), então não podem sofrer drift.
 
-## A DSN e os endpoints derivados
+## O Client Secret e os endpoints derivados
 
-Cada projeto tem **uma única DSN secreta**, a mesma para as duas capabilities:
+Cada projeto tem **um único Client Secret**, o mesmo para as duas capabilities:
 
 ```
-<proto>://<secretKey>@host[:porta]/<projectSlug>
+hb_<64 hex>
 ```
 
 | Canal | Endpoint | Autenticação |
 | --- | --- | --- |
-| Monitor (ingestão) | `POST <origin>/api/ingest` | `Authorization: Bearer <secretKey>` |
-| Manager (execução) | `<origin>/api/manager/*` | `Authorization: Bearer <secretKey>` |
+| Monitor (ingestão) | `POST <baseUrl>/api/ingest` | `Authorization: Bearer <clientSecret>` |
+| Manager (execução) | `<baseUrl>/api/manager/*` | `Authorization: Bearer <clientSecret>` |
 
-`parseDsn(dsn) → { key, projectSlug, origin, ingestEndpoint, managerBaseUrl }` (em `src/dsn.ts`). A chave é **secreta** (64 hex) e viaja **só no header** `Authorization: Bearer` — nunca na URL da requisição. O `projectSlug` do path é informativo: a identidade real do projeto vem da chave.
+`resolveConfig({ clientSecret, baseUrl? }) → { key, baseUrl, ingestEndpoint, managerBaseUrl }` (em `src/config.ts`, com a constante `DEFAULT_BASE_URL = 'https://app.hobots.app'`). A credencial é **secreta** (formato `hb_<64 hex>`; chaves antigas de 64 hex puros continuam válidas no servidor) e viaja **só no header** `Authorization: Bearer` — nunca na URL da requisição.
 
-> A DSN antiga do Monitor (public key na URL, `POST /api/ingest/<key>`) foi descontinuada — o endpoint responde **410** e o transport descarta sem retry. Copie a DSN nova em **Configurações → Agentes** no app.
+> As DSNs foram **descontinuadas** em favor do Client Secret — tanto a antiga do Monitor (public key na URL, `POST /api/ingest/<key>`, que responde **410** e o transport descarta sem retry) quanto a de key-na-URL (`https://<secretKey>@host/<slug>`). Copie o Client Secret em **Configurações → Projetos** no app.
 
 ## Monitor — ingestão
 
@@ -44,7 +44,7 @@ Tipos de item: `event`, `transaction`, `check_in`, `heartbeat` (definidos em `ho
 
 ## Manager — polling e reporte
 
-Dois endpoints sob `<origin>/api/manager`, ambos com `Authorization: Bearer <secretKey>` (a chave única do projeto):
+Dois endpoints sob `<baseUrl>/api/manager`, ambos com `Authorization: Bearer <clientSecret>` (a credencial única do projeto):
 
 ### `POST /api/manager/poll`
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hobots",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "SDK JavaScript da Hobots — captura de erros, transactions, check-ins de cron e heartbeats (Monitor) e execução remota de tarefas sob demanda (Manager) para RPAs e integrações. Um único import e um único init().",
   "type": "module",
   "sideEffects": false,
@@ -27,7 +27,7 @@
       "require": "./dist/protocol.cjs"
     },
     "./manager/protocol": {
-      "types": "./dist/manager/protocol.d.ts",
+      "types": "./dist/manager/protocol.d.ts  ",
       "import": "./dist/manager/protocol.js",
       "require": "./dist/manager/protocol.cjs"
     }