Registry / http-networking / async-compiler

async-compiler

JSON →
library1.0.20jsnpmunverified

A JavaScript compiler that transforms functions annotated with @async JSDoc tag into code using Promises for sequential asynchronous execution. Version 1.0.20 is the current stable release, with no recent updates indicating ongoing maintenance. It provides a simpler alternative to nested callbacks or promise chains by allowing developers to write asynchronous code in a synchronous style. Unlike native async/await (ES2017), it requires a compile step and a runtime library (async-compiler-runtime), and does not support advanced features like error handling or parallel execution patterns.

http-networkingweb-framework
npm install async-compiler
github ↗package ↗
INSTALL
IMPORT
SIG · ASYNC-COMPILER
A
async-compiler
http-networkingjavascriptv1.0.20
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.

AsyncTool
✓ var AsyncTool = require('async-compiler-runtime');
✗ import AsyncTool from 'async-compiler-runtime';
The runtime library is CommonJS-only, no ESM exports.

Shows a complete example: two async functions, a function with @async tag that composes them, and the compile/run commands.

// async-example.js var AsyncTool = require('async-compiler-runtime'); function add(x, y) { return Promise.resolve(x + y); } function mul(x, y) { return Promise.resolve(x * y); } /** @async **/ function foo() { return mul(add(3, 4), add(5, 6)); } foo().then(function(v) { console.log('Result:', v); }); // Command to compile: // node --harmony node_modules/async-compiler/compile.js --input async-example.js --output async-compiled.js // node --harmony async-compiled.js
Debug
Known issues
breakingRequires Node.js with --harmony flag for destructuring support (e.g., Node 6+).
fix
Use node --harmony or update Node.js to version 6+ where destructuring is enabled by default (though --harmony still recommended).
affects: all
deprecatedNative async/await (ES2017) is widely supported in Node 7.6+ and modern browsers, making this compiler unnecessary for most projects.
fix
Migrate to native async/await syntax and remove the compile step.
affects: >=1.0.0
gotchaThe function must be annotated with exactly `/** @async **/` (with two asterisks on opening). Single-line comment /* */ will be ignored.
fix
Ensure JSDoc comment starts with /** and ends with */, with @async inside.
affects: all
Errors
Common errors & fixes
Error: Cannot find module 'async-compiler-runtime'
The runtime package is not installed or not required in the compiled output.
fix
Install async-compiler-runtime: npm install async-compiler-runtime (or include as dependency). Then add `var AsyncTool = require('async-compiler-runtime');` at the top of your source file before using @async functions.
SyntaxError: Unexpected token function
Node.js version does not support destructuring or arrow functions used in compiled output without --harmony flag.
fix
Run with --harmony flag: node --harmony compiled.js
Error: @async function must return a Promise
The function body does not contain an async operation returning a Promise, or the return value is not a Promise.
fix
Ensure that inside @async functions, all asynchronous calls return Promises (e.g., using the provided add/mul functions). The final return value of the @async function must be a Promise (typically the result of the outermost async call).
Upgrade
Version history
1.0.20latest on npm
Audit
Dependencies
async-compiler-runtimerequiredRuntime support for compiled code; must be installed and required in the output.
Agent activity
17 hits · last 30 days
node
14
Amazon
1
OpenAI (training)
1
Resources
githubhttps://github.com/stonezhong/async-compiler ↗
packagehttps://www.npmjs.com/package/async-compiler ↗
async-compiler — npm install async-compiler · libregistry