decktools

DeckTools는 Deckflow 작업 자동화를 위한 pnpm 모노레포로, 클라우드에서 대규모로 덱 파일을 처리하도록 설계되었습니다. 이 저장소는 세 가지 주요 패키지를 포함합니다: Node.js 및 브라우저에서 파일 업로드 및 작업 API를 제공하는 TypeScript SDK(`@deckflow/decktools-sdk`), 동일한 API를 제공하는 Go SDK, 그리고 명령줄 사용을 위한 Node.js CLI(`decktools`)입니다. 설치 및 빌드는 pnpm을 사용해 간단합니다. `pnpm install`, `pnpm build`, `pnpm typecheck`, `pnpm test`를 실행하여 작업 공간을 설정하세요. CLI는 `pnpm --filter decktools build`를 실행한 후 `node apps/node-cli/dist/cli.js --help`로 로컬에서 빌드하고 실행할 수 있습니다. CLI는 로그인, 구성 관리, 파일 변환 명령을 지원합니다. 빠른 시작은 `decktools login`, `decktools config show`, `decktools convert slides.pptx --to pdf`를 실행하여 PowerPoint 파일을 PDF로 변환하는 것입니다. TypeScript SDK는 토큰, 스페이스 ID, 선택적 API 루트 주소(기본값: `https://app.deckflow.com/v1`)를 받는 `createDeck` 함수를 제공합니다. 인증은 토큰의 경우 `X-Auth-Token` 헤더를 통해, API 키의 경우 `Authorization: Bearer`를 통해 처리됩니다. SDK는 파일 변환을 위한 `convertPptToPdf`, 작업 완료 폴링을 위한 `tasks.wait`와 같은 메서드를 노출합니다. 작업 공간은 `sdks/python`, `sdks/java`, `sdks/rust` 아래에 향후 SDK 추가를 지원하도록 구조화되어 있어 더 넓은 언어 지원 계획을 나타냅니다. 각 패키지에는 설치, 구성, 사용 예제에 대한 자세한 문서가 포함된 자체 README가 있습니다.