@robinpath/promise

Async utilities: parallel, race, waterfall, map, retry, throttle, debounce, timeout, and concurrency control

Why use this module?

The promise module lets you:

• Wait for all promises
• Wait for all promises (no throw)
• First promise to settle
• First promise to fulfill
• Add timeout to promise

All functions are callable directly from RobinPath scripts with a simple, consistent API.

Installation

npm install @robinpath/promise

Quick Start

No credentials needed — start using it right away:

promise.allSettled [$p1, $p2]

Available Functions

| Function | Description | |----------|-------------| | promise.all | Wait for all promises | | promise.allSettled | Wait for all promises (no throw) | | promise.race | First promise to settle | | promise.any | First promise to fulfill | | promise.timeout | Add timeout to promise | | promise.delay | Resolve after delay | | promise.retry | Retry function with backoff | | promise.parallel | Run functions with concurrency limit | | promise.waterfall | Run functions in sequence, passing results | | promise.map | Map items with async function | | promise.filter | Filter items with async predicate | | promise.each | Iterate with async function | | promise.reduce | Reduce with async function | | promise.throttle | Throttle function calls | | promise.debounce | Debounce function calls | | promise.deferred | Create deferred promise | | promise.sleep | Sleep for milliseconds |

Examples

Wait for all promises (no throw)

promise.allSettled [$p1, $p2]

First promise to settle

promise.race [$p1, $p2]

First promise to fulfill

promise.any [$p1, $p2]

Integration with RobinPath

import { RobinPath } from "@wiredwp/robinpath";
import Module from "@robinpath/promise";

const rp = new RobinPath();
rp.registerModule(Module.name, Module.functions);
rp.registerModuleMeta(Module.name, Module.functionMetadata);

const result = await rp.executeScript(`
  promise.allSettled [$p1, $p2]
`);

Full API Reference

See MODULE.md for complete documentation including all parameters, return types, error handling, and advanced examples.

Related Modules

• @robinpath/json — JSON module for complementary functionality

License

MIT