🚀 𝗪𝗲𝗲𝗸𝗹𝘆 𝗗𝗲𝘃 𝗟𝗼𝗴 – 𝗪𝗲𝗲𝗸 𝟭

Jack Ecuyer — Fri, 16 May 2025 13:51:15 +0000

Hey everyone 👋

Here’s my latest update on what I’ve been building, learning, and overcoming this past week as part of my journey as a software developer.

💡 𝗣𝗿𝗼𝗷𝗲𝗰𝘁 𝗥𝗲𝗰𝗮𝗽 – 𝗛𝗲𝘃𝘆 𝗦𝗗𝗞 ( https://github.com/JackEcuyer/hevy-sdk )
I'm continuing to build out a TypeScript SDK for the Hevy API, aiming to support Node.js, browsers, and modern JavaScript frameworks. The goal is to improve the API ecosystem and gain hands-on experience with TypeScript tooling.

✅ 𝗧𝗵𝗶𝘀 𝗪𝗲𝗲𝗸’𝘀 𝗛𝗶𝗴𝗵𝗹𝗶𝗴𝗵𝘁𝘀
• Configured Prettier formatting & configured husky to run formatting on pre commit
• Added JSDoc style comments across codebase & used the TypeDoc package to generate documentation for the SDK
• Published the TypeDoc documentation to Github pages on the SDK repository.

📚 𝗪𝗵𝗮𝘁 𝗜’𝘃𝗲 𝗟𝗲𝗮𝗿𝗻𝗲𝗱
• That JSDoc is a commenting convention designed for raw JavaScript, and using the TypeDoc package means I don't have to add typing to my doc comments, because the package automatically interprets TypeScript.
• The prettier VSCode plugin will automatically search for a Prettier configuration file in your project and format accordingly.
• That Github deployment to Github pages is incredibly simple when using a basic HTML website document.

⚠️ 𝗖𝗵𝗮𝗹𝗹𝗲𝗻𝗴𝗲𝘀
• Determining which package to use to generate documentation files from JSDoc comments. There are many different packages for different formats (Markdown, HTML).

🔜 𝗡𝗲𝘅𝘁 𝗦𝘁𝗲𝗽𝘀
Next steps include stricter typing for responses received from API fetch requests, integrating mock fetch requests into jest, and expanding SDK functionality to include 'Routines' endpoints.

If you’re into dev logs, personal projects, or learning in public - feel free to follow! I’d love to hear what others are building too.

🚀 Building a TypeScript SDK for the Hevy API – Dev Log #1

Jack Ecuyer — Fri, 09 May 2025 08:31:17 +0000

Hey everyone 👋

I've decided to start sharing weekly updates about what I’m building,
learning, and overcoming as a software developer.

𝗪𝗵𝘆?
To track and share what I’m learning, stay consistent with my personal projects, and connect with others in the tech community.

🛠 This first post covers the past couple of weeks as I’ve kicked off a new project:

💡 𝗧𝗵𝗲 𝗣𝗿𝗼𝗷𝗲𝗰𝘁 - 𝗛𝗲𝘃𝘆 𝗦𝗗𝗞 (https://github.com/JackEcuyer/hevy-sdk/)
I'm building a TypeScript SDK for the Hevy API, to be compatible with Node.js, JavaScript frameworks, and browsers. I chose to build this because of my love for the Hevy app, which I use to track all of my workouts (https://www.hevyapp.com/). I hope to expand the Hevy API ecosystem while improving my TypeScript skills.

✅ 𝗛𝗶𝗴𝗵𝗹𝗶𝗴𝗵𝘁𝘀 𝗦𝗼 𝗙𝗮𝗿
• Set up GitHub repository and version control
• Configured TypeScript to build npm package for CommonJS & ES Modules
• Developed HevyClient class for SDK interaction
• Implemented API routines to retrieve & create workout data
• Integrated Zod for schema validation when posting workouts
• Setup Jest for SDK testing
• Improved error handling with user-friendly API & validation error formatting
• Installed and configured ESLint for code consistency
• Set up Husky for pre-commit testing & linting

📚 𝗪𝗵𝗮𝘁 𝗜’𝘃𝗲 𝗟𝗲𝗮𝗿𝗻𝗲𝗱
• How to configure TypeScript for both CommonJS and ES Modules
• Best practices for creating reusable and modular SDK classes (e.g. HevyClient)
• Integrating Zod for data validation and ensuring strong API request handling
• Writing effective tests for SDK functionality using Jest
• Handling and presenting API and validation errors in a user-friendly way
• Configuring ESLint to maintain consistent code quality and style
• Using Husky for automating pre-commit checks to ensure clean code
• Using the Git CLI to fix incorrect commits to Github

⚠️ 𝗖𝗵𝗮𝗹𝗹𝗲𝗻𝗴𝗲𝘀
• ESLint v9 configuration was tricky, as the new format required importing plugin modules. However, using the TypeScript ESLint package made this easier.
• I made a couple of incorrect git commits that were pushed to the remote Github repository, meaning I had to learn to correctly use the Git CLI to fix the commit history.
• While testing with ts-node, I ran into ESM syntax errors, which helped me understand the differences between ESM and CommonJS in Node.js.

🔜 𝗡𝗲𝘅𝘁 𝗦𝘁𝗲𝗽𝘀
Next steps include improving test coverage by integrating mock fetch requests into Jest, adding prettier and JSDoc, and refining type checking.

If you’re into learning new technologies, building personal projects, or are passionate about software - follow along!

I’ll be posting an update every week, within reason. Some weeks, circumstances may mean I can’t make a progress post, but I’ll keep it as consistent as I can. Happy to connect 👇

DEV Community: Jack Ecuyer

🚀 𝗪𝗲𝗲𝗸𝗹𝘆 𝗗𝗲𝘃 𝗟𝗼𝗴 – 𝗪𝗲𝗲𝗸 𝟭

🚀 Building a TypeScript SDK for the Hevy API – Dev Log #1