Registry / devops / cloudy-node

cloudy-node

JSON →
library0.0.81jsnpmunverified

cloudy-node is a TypeScript and ESM runtime for Node.js (>= 14.18) that uses esbuild under the hood to transpile TypeScript on the fly. Current stable version is 0.0.81. It is a fork of esno with a key differentiator: the esbuild target is set to es2022 instead of es2019, avoiding problematic helper generation that breaks Pulumi function serialization and enabling top-level await support (e.g., for AWS Lambda Node.js 14). It provides a CLI command and a Node --loader hook for seamless execution of .ts files. Compared to ts-node or tsx, it is more lightweight and focuses on esbuild speed, but may have fewer features and less community support.

devops
npm install cloudy-node
package ↗
INSTALL
IMPORT
SIG · CLOUDY-NODE
C
cloudy-node
devopsjavascriptv0.0.81
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

cloudy-node
✓ import 'cloudy-node' (or just run `yarn cloudy-node index.ts`)
✗ const cloudyNode = require('cloudy-node');
cloudy-node is a loader/CLI, not a library; it is not meant to be imported in code. It is used via the Node --loader option or directly as a binary.
CLI usage
✓ npx cloudy-node index.ts
✗ node cloudy-node index.ts
The package provides a binary `cloudy-node`, not a file to run with node executable.
Loader usage
✓ node --loader cloudy-node index.ts
✗ node -r cloudy-node index.ts
Must use `--loader` (Node >= 14.8) not `-r` (require hook) for ESM loader support.

Shows running a simple TypeScript file using the cloudy-node CLI.

echo 'console.log("Hello from cloudy-node!");' > hello.ts npx cloudy-node hello.ts
cloudy-node --version
Debug
Known issues
gotchacloudy-node expects a TypeScript file as the entry point; passing a JavaScript file may still work but is redundant.
fix
Ensure your entry file has a .ts extension for intended behavior.
affects: >=0.0.1
gotchaThe --loader flag uses a custom loader; Node.js experimental warnings may appear in some versions.
fix
Suppress warnings with `--no-warnings` flag if desired.
affects: >=0.0.1
gotchacloudy-node targets es2022; code using features from later ES versions may not transpile correctly.
fix
Use a different tool if you need newer target, or adjust tsconfig.json if applicable.
affects: >=0.0.1
gotchaThe package is a fork of esno; some esno flags or behavior may differ.
fix
Check cloudy-node documentation for supported options.
affects: >=0.0.1
Errors
Common errors & fixes
TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension ".ts" for /path/to/file.ts
Running TypeScript file directly with `node` without the loader.
fix
Use `node --loader cloudy-node index.ts` or the `cloudy-node` binary.
Error: Cannot find module 'cloudy-node'
Package not installed or not in node_modules.
fix
Run `npm install cloudy-node` or `yarn add cloudy-node`.
Warning: To load an ES module, set "type": "module" in the package.json or use the .mjs extension
Node expects ESM but package.json does not have `"type": "module"` and file is .ts without loader.
fix
Use `--loader cloudy-node` or set type: module, or use the cloudy-node CLI which handles it automatically.
Upgrade
Version history
0.0.81latest on npm
Audit
Dependencies
esbuildrequiredcore transpiler used at runtime for TypeScript and ESM transformation
Agent activity
9 hits · last 30 days
node
6
Resources
packagehttps://www.npmjs.com/package/cloudy-node ↗
cloudy-node — npm install cloudy-node · libregistry