Sobre o projeto

DeckTools é um monorepo pnpm para automação de tarefas da Deckflow, projetado para processar arquivos de apresentação em escala na nuvem. O repositório contém três pacotes principais: um SDK TypeScript (`@deckflow/decktools-sdk`) para upload de arquivos e APIs de tarefas em Node.js e navegadores, um SDK Go para as mesmas APIs e um CLI Node.js (`decktools`) para uso via linha de comando. Instalação e build são simples com pnpm: execute `pnpm install`, `pnpm build`, `pnpm typecheck` e `pnpm test` para configurar o workspace. O CLI pode ser compilado e executado localmente via `pnpm --filter decktools build` seguido por `node apps/node-cli/dist/cli.js --help`. O CLI suporta login, gerenciamento de configuração e comandos de conversão de arquivos. Um início rápido envolve executar `decktools login`, `decktools config show` e `decktools convert slides.pptx --to pdf` para converter arquivos PowerPoint em PDF. O SDK TypeScript fornece uma função `createDeck` que aceita um token, ID de espaço e endereço raiz da API opcional (padrão para `https://app.deckflow.com/v1`). A autenticação é tratada via cabeçalho `X-Auth-Token` para tokens ou `Authorization: Bearer` para chaves de API. O SDK expõe métodos como `convertPptToPdf` para conversão de arquivos e `tasks.wait` para polling de conclusão de tarefas. O workspace é estruturado para suportar futuras adições de SDKs em `sdks/python`, `sdks/java` ou `sdks/rust`, indicando planos para uma cobertura mais ampla de linguagens. Cada pacote tem seu próprio README com documentação detalhada para instalação, configuração e exemplos de uso.