# assist-loja-cli

CLI oficial da **Loja ASSIST Tecnologia** para consultar equipamentos de rede e infraestrutura de TI. Usa a API pública descrita em [OpenAPI](https://loja.assist.com.br/openapi.json) e [documentação ASSIST](https://loja.assist.com.br/developers). Requer Node.js 20 ou superior; não possui dependências nem scripts de instalação.

## Instalação pelo pacote oficial

```sh
npm install -g https://loja.assist.com.br/cli/assist-loja-cli-1.0.0.tgz
assist-loja --help
```

O pacote também pode ser executado sem instalação global:

```sh
npx --yes --package=https://loja.assist.com.br/cli/assist-loja-cli-1.0.0.tgz assist-loja products --query synology --limit 5
```

## Comandos

```sh
assist-loja info
assist-loja products --query mikrotik --limit 5
assist-loja products --brand ubiquiti --offset 20
assist-loja product <slug-retornado-pela-listagem>
assist-loja brands
assist-loja categories
assist-loja openapi
```

A busca aceita `--query`, `--brand` e `--category`; as coleções aceitam `--limit` (1–100, padrão 20) e `--offset` (0–10000). Siga `nextOffset` para a próxima página. A saída é JSON em stdout. Erros são JSON em stderr: saída 1 para falha HTTP/rede e 2 para argumentos inválidos. HTTP 503 inclui orientação para aguardar antes de repetir a consulta.

A leitura não exige conta, token ou login. Nenhum comando envia mensagem, cria pedido ou reserva estoque. Preço, disponibilidade e compatibilidade dependem de confirmação com a ASSIST. Use apenas slugs publicados no catálogo. Para cotação, prepare os modelos e quantidades e peça autorização ao usuário antes de entrar em contato.

`ASSIST_LOJA_API_URL` aceita outra origem HTTPS, sem credenciais, parâmetros ou caminho. HTTP é aceito apenas para localhost nos testes. O tempo limite de uma requisição é 15 segundos e redirecionamentos são rejeitados.

O código JavaScript da CLI está incluído no [pacote oficial distribuído pela loja](https://loja.assist.com.br/cli/assist-loja-cli-1.0.0.tgz), no arquivo `cli.mjs`. Atendimento: contato@assist.com.br.