Async Patterns

STRVCT extends native JavaScript Promise and Array prototypes via categories (Promise_ideal.js, Array_promises.js) to provide clean, chainable asynchronous primitives without importing external async utility libraries.

STRVCT adds asynchronous iteration methods directly to Array.prototype:

1. Serial Execution (promiseSerialForEach / promiseSerialMap)

Executes an async callback for each element in strict sequential order, awaiting each element before starting the next:

// Executes sequentially
await items.promiseSerialForEach(async (item) => {
    await processItem(item);
});

// Maps results sequentially
const results = await items.promiseSerialMap(async (item) => {
    return await fetchDetails(item);
});

2. Parallel Execution (promiseParallelMap)

Executes async callbacks in parallel across all array elements:

const results = await items.promiseParallelMap(async (item) => {
    return await fetchDetails(item);
});

Promise_ideal.js extends Promise with status introspection and timeout helpers:

const promise = Promise.clone(); // Instantiates wrapper promise
promise.isPending();             // Returns true while unresolved
promise.isResolved();            // Returns true when resolved
promise.isRejected();            // Returns true on rejection

// Timeout protection
await promise.timeout(5000, "Operation timed out after 5s");

When catching and rethrowing errors in async pipelines, Error.rethrow() preserves the original error stack while adding contextual messages:

try {
    await pool.commitStoreDirtyObjects();
} catch (error) {
    throw Error.rethrow(`Failed to commit object pool ${pool.poolId()}`, error);
}

• Categories: Class extension pattern.
• Protocols: Interface declaration and conformance checking.