decktools

DeckTools est un monorepo pnpm pour l'automatisation de tâches Deckflow, conçu pour traiter des fichiers de présentation à grande échelle dans le cloud. Le dépôt contient trois packages principaux : un SDK TypeScript (`@deckflow/decktools-sdk`) pour les API de téléversement de fichiers et de tâches dans Node.js et les navigateurs, un SDK Go pour les mêmes API, et un CLI Node.js (`decktools`) pour une utilisation en ligne de commande. L'installation et la compilation sont simples avec pnpm : exécutez `pnpm install`, `pnpm build`, `pnpm typecheck` et `pnpm test` pour configurer l'espace de travail. Le CLI peut être compilé et exécuté localement via `pnpm --filter decktools build` suivi de `node apps/node-cli/dist/cli.js --help`. Le CLI prend en charge la connexion, la gestion de la configuration et les commandes de conversion de fichiers. Une prise en main rapide consiste à exécuter `decktools login`, `decktools config show` et `decktools convert slides.pptx --to pdf` pour convertir des fichiers PowerPoint en PDF. Le SDK TypeScript fournit une fonction `createDeck` qui accepte un jeton, un ID d'espace et une adresse racine API facultative (par défaut `https://app.deckflow.com/v1`). L'authentification est gérée via l'en-tête `X-Auth-Token` pour les jetons ou `Authorization: Bearer` pour les clés API. Le SDK expose des méthodes comme `convertPptToPdf` pour la conversion de fichiers et `tasks.wait` pour interroger l'achèvement des tâches. L'espace de travail est structuré pour prendre en charge de futurs ajouts de SDK sous `sdks/python`, `sdks/java` ou `sdks/rust`, ce qui indique des plans pour une couverture linguistique plus large. Chaque package possède son propre README avec une documentation détaillée pour l'installation, la configuration et des exemples d'utilisation.