deepseekjs
v1.0.6
Published
````markdown # DeepSeek Node.js Client
Readme
# DeepSeek Node.js Client
A melhor biblioteca Node.js em TypeScript para integração com a API do DeepSeek.
usando Fetch API nativa e padrão de retorno `[data, error]`.
`[data, error]` será o novo padrão do javascript moderno.
## Pré-requisitos
- Node.js 18+ (com suporte a Fetch API nativa)
- Chave de API do DeepSeek
## Uso Básico
```typescript
import { DeepSeek } from "deepseek-client";
const deepseek = new DeepSeek({
key: "sua-chave-api-aqui",
});
// Exemplo de uso
const [data, error] = await deepseek.sendMessage(
"Explique o quantum computing"
);
if (error) {
console.error("Erro:", error.message);
} else {
console.log("Resposta:", data);
}
```
## API Reference
### `new DeepSeek(config: DeepSeekConstructorType)`
- **Parâmetros**:
- `config`: Objeto de configuração
- `key` (string): Chave de API do DeepSeek _(obrigatória)_
### `sendMessage(message: string): Promise<[any, Error | null]>`
- Envia uma mensagem para a API do DeepSeek
- **Retorna**: Tupla `[data, error]`
- `data`: Resposta da API em caso de sucesso
- `error`: Objeto de erro em caso de falha
## Padrão de Erros
A biblioteca segue o padrão de retorno estilo Go:
```typescript
const [response, error] = await deepseek.sendMessage("Olá");
if (error) {
// Tratar erro
throw new Error(`Falha na comunicação: ${error.message}`);
}
// Usar resposta
console.log(response);
```
## Tratamento de Erros
A biblioteca captura automaticamente:
- Erros de rede
- Respostas HTTP não-2xx
- Erros de parsing de JSON
- Erros genéricos
Exemplo de tratamento detalhado:
```typescript
const [data, error] = await deepseek.sendMessage("...");
if (error) {
if (error.message.includes("401")) {
console.error("Erro de autenticação - verifique sua API key");
} else if (error.message.includes("500")) {
console.error("Erro interno do servidor");
} else {
console.error("Erro desconhecido:", error.message);
}
}
```