Create `start` and `dev` Commands with Improved Implementation & Move to `tsx`

[Daniel-Boll]

Introduction

The existing CLI commands for starting the application and running in development mode could be simplified and optimized. Currently, the following commands are used:

• Start: node -r dotenv/config -r ./dist/register-path.js ./dist/src/main.js
• Development: tsnd -r dotenv/config -r tsconfig-paths/register ./src/main.ts

The proposal is to replace these with two simple commands, start and dev, and change the underlying package from ts-node-dev to tsx.

Proposed Changes

1. Replace Start Command: Introduce a start command to replace the current complex command.
2. Replace Development Command: Introduce a dev command for development, replacing the existing command.
3. Move from ts-node-dev to tsx: As ts-node-dev has not been actively maintained and tsx (https://github.com/esbuild-kit/tsx) has been more broadly used, it is suggested to migrate to tsx, which may provide better performance and compatibility.

Implementation Details

start Command:

The start command can replace the current command for running the application.

expressots start

dev Command:

The dev command can replace the current command for running the development server.

expressots dev

Use tsx:

Move from ts-node-dev to tsx

Overview

I'm proposing to migrate from ts-node-dev to tsx (https://github.com/esbuild-kit/tsx) for running TypeScript files. This change is driven by the following critical factors:

Active Maintenance

• ts-node-dev: The ts-node-dev package has not been actively maintained, with the latest updates showing a lack of consistent development. This poses a risk of running into unsupported issues or bugs that might not be addressed promptly.
• tsx: In contrast, tsx is an actively maintained package with regular updates, ensuring that it keeps up with the latest TypeScript features and best practices. This active maintenance promotes stability and support for future enhancements.

Performance

• Faster Compilation: tsx uses esbuild, known for its remarkable compilation speed. This speed can make the development process more efficient, particularly in large codebases.
• Reduced Startup Time: tsx optimizes the startup time, enabling quicker iterations during development. This can save valuable time for developers and streamline the workflow.

Compatibility

• Latest TypeScript Features: tsx supports the latest TypeScript features, ensuring compatibility with modern development practices and tools.
• Flexibility with Configuration: tsx provides a flexible configuration system, allowing customization and fine-tuning to fit the specific needs of the project.

Community Adoption

• Wider Usage: tsx has seen more extensive adoption within the community, reflecting a positive reception and trust in the package.
• Contributions: Being a more popular package, tsx benefits from community contributions, resulting in a more refined and robust solution.

Conclusion

The migration from ts-node-dev to tsx offers substantial benefits, including enhanced performance, active maintenance, and compatibility with modern development practices. Aligning with a package that enjoys broader community support will contribute to the project's long-term success and maintainability. Therefore, transitioning to tsx is a strategic move that we believe will positively impact the development experience in ExpressoTS.

Benefits

• Simplicity: Simplifies the commands to start and develop the project.
• Maintainability: Utilizes a well-maintained and widely-used package (tsx) over ts-node-dev.
• Performance: Potentially provides improved speed with tsx.

Conclusion

These changes aim to enhance the CLI experience by providing more straightforward commands and migrating to a more efficient and actively maintained package. Feedback are welcome for this proposed update.

[rsaz]

If you are referring to the commands in the templates, the correct commands are these ones:

"build": "tsc -p tsconfig.build.json && cp -R ./register-path.js tsconfig.build.json package.json ./dist",
"dev": "tsnd -r dotenv/config -r tsconfig-paths/register ./src/main.ts",
"prod": "node -r dotenv/config -r ./dist/register-path.js ./dist/src/main.js",

These commands above are project bind commands, they are not available globally from the expressots/cli

Are you suggesting to add these commands to the CLI and then change the signature of the project command of the templates to possibly:

expressots build
expressots dev
expressots prod

Is this the correct understanding?

If this is what you are trying to achieve, I think is a good idea however you need to have in mind that we gonna be generating a dependency from the template to the CLI. And any change in the template that involves commands will have to change CLI as well.

Please, create a POC to demonstrate this proposal to understand the impact, the dependencies that will be included, dependency sizes, as well as a comparison between tsnd versus tsx performance during development. Attach your code and send a link to your POC to be appreciated.

[Daniel-Boll]

@rsaz I've been attempting to integrate tsx into the project without success. It appears the issue may be related to the Env validator. Should we simplify our approach by focusing on the start and dev commands, moving the tsnd dependency to the CLI?

[rsaz]

@Daniel-Boll can you respond please to the questions above mentioned in the previous message? This will help us to understand how do you intend to implement and resolve those issues mentioned above.

[Daniel-Boll]

Yes, that's the plan. Instead of using tsnd -r dotenv/config -r tsconfig-paths/register ./src/main.ts, we'll simplify it to just expressots dev for instance.

[Daniel-Boll]

For now, I'd say we stick with tsnd, and initially only port the start and dev commands. Essentially, I believe we're just moving the dependency from the core to the CLI this way.

[rsaz]

Ok, in doing that, a simple command will depend on cli change. Ok, lets do a POC, please proceed with a POC. I will move this idea to stage 2

[rsaz]

@joaoneto as mentioned we are in the stage 2. Let us know, or discuss with @Daniel-Boll so that you guys can POC these two scenarios:

1 - Change the commands from

"build": "tsc -p tsconfig.build.json && cp -R ./register-path.js tsconfig.build.json package.json ./dist",
"dev": "tsnd -r dotenv/config -r tsconfig-paths/register ./src/main.ts",
"prod": "node -r dotenv/config -r ./dist/register-path.js ./dist/src/main.js",

To

expressots build
expressots dev
expressots prod

2 - Your proposal #16

The changes that I propose are the following:

Add a command option, for example: --experimental, --use-swc, so that the template uses the build with SWC
Change or create a template so that the npm scripts of the package.json use the experimental build

Waiting feedback!

[joaoneto]

Nice!

A suggestion to proceed with the two changes, would be to create in the cli the bin scripts of the package.json, that will trigger:

expressots build
expressots dev
expressots prod 

once we opt to use the swc transpiler, we would pass a flag:

expressots build --experimental
expressots dev --experimental
expressots prod --experimental

I created a basic funcional project that uses expressots with the build/test/etc.. tools in the swc's performant environment called expressots-opinionated-experimental so that we can have some insights too, what do you think?

[Daniel-Boll]

@joaoneto, the progress appears promising, and your approach seems solid. The next logical step might be to conduct a benchmark, comparing the performance with and without the integration of SWC in the build process.

It would be beneficial to document these findings in the README file itself, providing clear insight for anyone exploring the repository.

Rest assured, I'll be monitoring the changes in the repo by subscribing to the changes look forward to seeing the results.

Best Regards,
Daniel Boll. 🎴