@telepapo/sdk 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,46 @@
-# Temporary Holding Version
+# @telepapo/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 Node do **TelePapo Developers**: autorize contas comerciais do TelePapo e
+receba e responda as mensagens delas — com criptografia de ponta a ponta
+(Signal). O seu servidor vira um aparelho da conta, com chaves próprias que
+nunca saem dele.
+
+Guia completo da API e dos webhooks: <https://developers.telepapo.com.br/docs>.
+
+```js
+import { TelePapo, ArmazenamentoArquivo } from '@telepapo/sdk';
+
+const telepapo = new TelePapo({
+  clientId: process.env.TELEPAPO_CLIENT_ID,
+  credencial: process.env.TELEPAPO_CREDENCIAL,
+  chaveWebhook: process.env.TELEPAPO_CHAVE_WEBHOOK,
+  armazenamento: new ArmazenamentoArquivo('/var/lib/meuapp/telepapo'),
+});
+
+const { url } = await telepapo.iniciarAutorizacao({ redirectUri: 'https://seuapp.com/telepapo/retorno' });
+// … o lojista aprova no celular e volta com ?code=&state=
+const conta = await telepapo.concluirAutorizacao({ code, estado: state });
+
+const evento = await telepapo.processarWebhook(corpoCru, cabecalhoAssinatura);
+if (evento.mensagem?.tipo === 'texto') await conta.enviarTexto(evento.mensagem.de, 'Oi! Já respondemos.');
+```
+
+API: `iniciarAutorizacao`, `concluirAutorizacao`, `conta(id)`,
+`processarWebhook`, `verificarAssinatura`; na conta: `receber`, `enviar`,
+`enviarTexto`, `enviarArquivo`, `subirAnexo`, `baixarAnexo`, `marcarLida`,
+`reagir`, `digitando`, `garantirPreKeys`, `dados`, `desconectar`.
+
+Mais de um processo usando as mesmas contas (API + worker, réplicas)? Passe
+`travar: (chave, f) => …` (ex.: um lock no Redis): o estado do Signal e o
+refresh token não aguentam dois escritores ao mesmo tempo.
+
+O Signal roda em WebAssembly (`signal/`, compilado do libsignal 0.105.4 —
+o mesmo do app, testado contra a biblioteca oficial).
+
+Precisa de Node 20 ou mais novo. Portal (credenciais, webhooks, revisão):
+<https://developers.telepapo.com.br>.
+
+## Licença
+
+AGPL-3.0-only (ver `LICENSE`). O SDK embute o libsignal (AGPL-3.0) compilado
+para WebAssembly; o código-fonte correspondente está em `signal/fonte/`.

package/package.json

@@ -1,6 +1,33 @@
 {
   "name": "@telepapo/sdk",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "SDK do TelePapo Developers: autorize contas comerciais e receba e responda mensagens com criptografia de ponta a ponta (Signal).",
+  "type": "module",
+  "main": "src/index.js",
+  "exports": {
+    ".": "./src/index.js"
+  },
+  "files": [
+    "src",
+    "signal",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "node --test teste/",
+    "prepublishOnly": "node -e \"if(!process.env.TELEPAPO_NPM_VERIFICADO){console.error('Bloqueado: publique com node ferramentas/publicar-npm.mjs sdk --publicar (ver docs/PUBLICACAO-NPM.md)');process.exit(1)}\""
+  },
+  "license": "AGPL-3.0-only",
+  "homepage": "https://developers.telepapo.com.br/docs",
+  "keywords": [
+    "telepapo",
+    "signal",
+    "e2e",
+    "chat",
+    "bot",
+    "webhook"
+  ]
+}

package/signal/fonte/.cargo/config.toml

@@ -0,0 +1,2 @@
+[target.wasm32-unknown-unknown]
+rustflags = ['--cfg', 'getrandom_backend="wasm_js"']