decktools

DeckTools es un monorepo pnpm para la automatización de tareas de Deckflow, diseñado para procesar archivos de presentaciones a escala en la nube. El repositorio contiene tres paquetes principales: un SDK de TypeScript (`@deckflow/decktools-sdk`) para las APIs de carga de archivos y tareas en Node.js y navegadores, un SDK de Go para las mismas APIs y una CLI de Node.js (`decktools`) para uso desde la línea de comandos. La instalación y compilación son sencillas con pnpm: ejecute `pnpm install`, `pnpm build`, `pnpm typecheck` y `pnpm test` para configurar el espacio de trabajo. La CLI se puede compilar y ejecutar localmente mediante `pnpm --filter decktools build` seguido de `node apps/node-cli/dist/cli.js --help`. La CLI admite comandos de inicio de sesión, gestión de configuración y conversión de archivos. Una guía de inicio rápido incluye ejecutar `decktools login`, `decktools config show` y `decktools convert slides.pptx --to pdf` para convertir archivos de PowerPoint a PDF. El SDK de TypeScript proporciona una función `createDeck` que acepta un token, un ID de espacio y una dirección raíz de API opcional (cuyo valor predeterminado es `https://app.deckflow.com/v1`). La autenticación se gestiona mediante el encabezado `X-Auth-Token` para tokens o `Authorization: Bearer` para claves de API. El SDK expone métodos como `convertPptToPdf` para la conversión de archivos y `tasks.wait` para consultar la finalización de tareas. El espacio de trabajo está estructurado para admitir futuras incorporaciones de SDK en `sdks/python`, `sdks/java` o `sdks/rust`, lo que indica planes para una mayor cobertura de lenguajes. Cada paquete tiene su propio README con documentación detallada de instalación, configuración y ejemplos de uso.