@workflow/core 5.0.0-beta.13 → 5.0.0-beta.15

package/dist/runtime/wait-continuation.js

@@ -0,0 +1,92 @@
+/**
+ * Wait-continuation dispatch: delay + idempotency-key selection.
+ *
+ * When V2 suspension processing observes a pending wait, it enqueues a
+ * delayed "continuation" message that fires once the wait elapses and
+ * drives the next replay (which completes the wait via the "complete
+ * elapsed waits" pass). This module decides the message's `delaySeconds`
+ * and `idempotencyKey`.
+ *
+ * The continuation is keyed on the wait's correlationId: while a wait is
+ * pending, every replay pass over the run re-observes it (e.g., once per
+ * step completion in `Promise.all([steps..., sleep()])`), and without
+ * dedupe each pass would enqueue another delayed continuation — each one
+ * a spurious full replay when the wait elapses, and each a fresh message
+ * that resets the delivery-attempt runaway guard. A key is attached in
+ * all cases: some worlds (e.g. world-postgres) serialize key-less
+ * workflow messages per run, which would park the continuation behind
+ * the handler's own inline step execution and defeat the race semantics
+ * the continuation exists to provide.
+ *
+ * The bare correlationId cannot be the key in every case, though: world
+ * dedupe windows outlive the first delivery (VQS keeps idempotency
+ * records until message-retention TTL; world-postgres keeps a
+ * completed-keys cache), so once a key has been used, a later enqueue
+ * under the same key is silently dropped. Any situation where a
+ * continuation is delivered while its wait is still pending therefore
+ * needs a fresh key for the re-enqueue, or the wait's timer is lost and
+ * the run stalls until unrelated traffic happens to wake it. Two such
+ * situations exist, each with its own key variation:
+ *
+ * - Waits longer than the maximum queue delay are chained: the delay is
+ *   clamped to `WAIT_CONTINUATION_MAX_DELAY_SECONDS` (23h — VQS messages
+ *   have a 24h retention limit, and one hour of buffer matches
+ *   world-vercel's own clamp for delayed re-enqueues), so the
+ *   continuation intentionally fires early, re-observes the wait, and
+ *   must enqueue the next hop. The key is suffixed with the hop index
+ *   (`ceil(timeoutSeconds / maxDelay)`): stable for every re-observation
+ *   within the same hop window (so passes dedupe), decremented at each
+ *   hop delivery (so the chain always advances). Worlds without a delay
+ *   limit (world-postgres, world-local) simply take the same ≤23h hops.
+ *
+ * - Near-elapsed waits (≤2s remaining) get a second-bucketed suffix. A
+ *   continuation delivered marginally early (clock skew between the
+ *   enqueuing and handling hosts; the ceil() on the delay can leave a ~0
+ *   margin) re-observes the wait as pending with ~1s remaining and must
+ *   be able to enqueue a fresh short-delay retry. The bucket suffix
+ *   keeps that retry enqueueable (its ≥1s delay guarantees a later
+ *   bucket) while still collapsing same-instant duplicates.
+ *
+ * Mid-range waits (more than the near-elapsed threshold, at most one
+ * hop) use the bare correlationId: every re-observation targets the same
+ * deadline, so deduping to the first message is semantically lossless.
+ * Host clock skew beyond the near-elapsed threshold could in principle
+ * deliver such a continuation early enough to re-observe its wait and
+ * lose the re-enqueue to the burnt key; the threshold is the skew
+ * tolerance we accept for the benefit of exactly-one continuation per
+ * wait.
+ */
+/**
+ * Maximum `delaySeconds` for a single wait-continuation message. Waits
+ * longer than this are chained across multiple hops. 23 hours: VQS
+ * messages have a 24h retention limit; the 1h buffer mirrors
+ * world-vercel's `MAX_DELAY_SECONDS`.
+ */
+export const WAIT_CONTINUATION_MAX_DELAY_SECONDS = 82_800;
+/**
+ * Waits with at most this many seconds remaining use a second-bucketed
+ * idempotency key so an early-delivered continuation can re-enqueue its
+ * short-delay retry. This is also the host clock-skew tolerance for
+ * mid-range waits keyed on the bare correlationId.
+ */
+export const NEAR_ELAPSED_WAIT_THRESHOLD_SECONDS = 2;
+/**
+ * Computes the queue delay and idempotency key for a wait-continuation
+ * message. `timeoutSeconds` is the time until the wait's `resumeAt`
+ * (floored at 1s by the suspension handler); `waitCorrelationId`
+ * identifies the wait so repeated suspension passes dedupe.
+ */
+export function getWaitContinuationDispatch(timeoutSeconds, waitCorrelationId, now = Date.now()) {
+    if (timeoutSeconds <= NEAR_ELAPSED_WAIT_THRESHOLD_SECONDS) {
+        return {
+            delaySeconds: timeoutSeconds,
+            idempotencyKey: `${waitCorrelationId}:${Math.floor(now / 1000)}`,
+        };
+    }
+    const hop = Math.ceil(timeoutSeconds / WAIT_CONTINUATION_MAX_DELAY_SECONDS);
+    return {
+        delaySeconds: Math.min(timeoutSeconds, WAIT_CONTINUATION_MAX_DELAY_SECONDS),
+        idempotencyKey: hop === 1 ? waitCorrelationId : `${waitCorrelationId}:hop-${hop}`,
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2FpdC1jb250aW51YXRpb24uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvcnVudGltZS93YWl0LWNvbnRpbnVhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBeURHO0FBRUg7Ozs7O0dBS0c7QUFDSCxNQUFNLENBQUMsTUFBTSxtQ0FBbUMsR0FBRyxNQUFNLENBQUM7QUFFMUQ7Ozs7O0dBS0c7QUFDSCxNQUFNLENBQUMsTUFBTSxtQ0FBbUMsR0FBRyxDQUFDLENBQUM7QUFPckQ7Ozs7O0dBS0c7QUFDSCxNQUFNLFVBQVUsMkJBQTJCLENBQ3pDLGNBQXNCLEVBQ3RCLGlCQUF5QixFQUN6QixNQUFjLElBQUksQ0FBQyxHQUFHLEVBQUU7SUFFeEIsSUFBSSxjQUFjLElBQUksbUNBQW1DLEVBQUUsQ0FBQztRQUMxRCxPQUFPO1lBQ0wsWUFBWSxFQUFFLGNBQWM7WUFDNUIsY0FBYyxFQUFFLEdBQUcsaUJBQWlCLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLEdBQUcsSUFBSSxDQUFDLEVBQUU7U0FDakUsQ0FBQztJQUNKLENBQUM7SUFFRCxNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsSUFBSSxDQUFDLGNBQWMsR0FBRyxtQ0FBbUMsQ0FBQyxDQUFDO0lBQzVFLE9BQU87UUFDTCxZQUFZLEVBQUUsSUFBSSxDQUFDLEdBQUcsQ0FBQyxjQUFjLEVBQUUsbUNBQW1DLENBQUM7UUFDM0UsY0FBYyxFQUNaLEdBQUcsS0FBSyxDQUFDLENBQUMsQ0FBQyxDQUFDLGlCQUFpQixDQUFDLENBQUMsQ0FBQyxHQUFHLGlCQUFpQixRQUFRLEdBQUcsRUFBRTtLQUNwRSxDQUFDO0FBQ0osQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogV2FpdC1jb250aW51YXRpb24gZGlzcGF0Y2g6IGRlbGF5ICsgaWRlbXBvdGVuY3kta2V5IHNlbGVjdGlvbi5cbiAqXG4gKiBXaGVuIFYyIHN1c3BlbnNpb24gcHJvY2Vzc2luZyBvYnNlcnZlcyBhIHBlbmRpbmcgd2FpdCwgaXQgZW5xdWV1ZXMgYVxuICogZGVsYXllZCBcImNvbnRpbnVhdGlvblwiIG1lc3NhZ2UgdGhhdCBmaXJlcyBvbmNlIHRoZSB3YWl0IGVsYXBzZXMgYW5kXG4gKiBkcml2ZXMgdGhlIG5leHQgcmVwbGF5ICh3aGljaCBjb21wbGV0ZXMgdGhlIHdhaXQgdmlhIHRoZSBcImNvbXBsZXRlXG4gKiBlbGFwc2VkIHdhaXRzXCIgcGFzcykuIFRoaXMgbW9kdWxlIGRlY2lkZXMgdGhlIG1lc3NhZ2UncyBgZGVsYXlTZWNvbmRzYFxuICogYW5kIGBpZGVtcG90ZW5jeUtleWAuXG4gKlxuICogVGhlIGNvbnRpbnVhdGlvbiBpcyBrZXllZCBvbiB0aGUgd2FpdCdzIGNvcnJlbGF0aW9uSWQ6IHdoaWxlIGEgd2FpdCBpc1xuICogcGVuZGluZywgZXZlcnkgcmVwbGF5IHBhc3Mgb3ZlciB0aGUgcnVuIHJlLW9ic2VydmVzIGl0IChlLmcuLCBvbmNlIHBlclxuICogc3RlcCBjb21wbGV0aW9uIGluIGBQcm9taXNlLmFsbChbc3RlcHMuLi4sIHNsZWVwKCldKWApLCBhbmQgd2l0aG91dFxuICogZGVkdXBlIGVhY2ggcGFzcyB3b3VsZCBlbnF1ZXVlIGFub3RoZXIgZGVsYXllZCBjb250aW51YXRpb24g4oCUIGVhY2ggb25lXG4gKiBhIHNwdXJpb3VzIGZ1bGwgcmVwbGF5IHdoZW4gdGhlIHdhaXQgZWxhcHNlcywgYW5kIGVhY2ggYSBmcmVzaCBtZXNzYWdlXG4gKiB0aGF0IHJlc2V0cyB0aGUgZGVsaXZlcnktYXR0ZW1wdCBydW5hd2F5IGd1YXJkLiBBIGtleSBpcyBhdHRhY2hlZCBpblxuICogYWxsIGNhc2VzOiBzb21lIHdvcmxkcyAoZS5nLiB3b3JsZC1wb3N0Z3Jlcykgc2VyaWFsaXplIGtleS1sZXNzXG4gKiB3b3JrZmxvdyBtZXNzYWdlcyBwZXIgcnVuLCB3aGljaCB3b3VsZCBwYXJrIHRoZSBjb250aW51YXRpb24gYmVoaW5kXG4gKiB0aGUgaGFuZGxlcidzIG93biBpbmxpbmUgc3RlcCBleGVjdXRpb24gYW5kIGRlZmVhdCB0aGUgcmFjZSBzZW1hbnRpY3NcbiAqIHRoZSBjb250aW51YXRpb24gZXhpc3RzIHRvIHByb3ZpZGUuXG4gKlxuICogVGhlIGJhcmUgY29ycmVsYXRpb25JZCBjYW5ub3QgYmUgdGhlIGtleSBpbiBldmVyeSBjYXNlLCB0aG91Z2g6IHdvcmxkXG4gKiBkZWR1cGUgd2luZG93cyBvdXRsaXZlIHRoZSBmaXJzdCBkZWxpdmVyeSAoVlFTIGtlZXBzIGlkZW1wb3RlbmN5XG4gKiByZWNvcmRzIHVudGlsIG1lc3NhZ2UtcmV0ZW50aW9uIFRUTDsgd29ybGQtcG9zdGdyZXMga2VlcHMgYVxuICogY29tcGxldGVkLWtleXMgY2FjaGUpLCBzbyBvbmNlIGEga2V5IGhhcyBiZWVuIHVzZWQsIGEgbGF0ZXIgZW5xdWV1ZVxuICogdW5kZXIgdGhlIHNhbWUga2V5IGlzIHNpbGVudGx5IGRyb3BwZWQuIEFueSBzaXR1YXRpb24gd2hlcmUgYVxuICogY29udGludWF0aW9uIGlzIGRlbGl2ZXJlZCB3aGlsZSBpdHMgd2FpdCBpcyBzdGlsbCBwZW5kaW5nIHRoZXJlZm9yZVxuICogbmVlZHMgYSBmcmVzaCBrZXkgZm9yIHRoZSByZS1lbnF1ZXVlLCBvciB0aGUgd2FpdCdzIHRpbWVyIGlzIGxvc3QgYW5kXG4gKiB0aGUgcnVuIHN0YWxscyB1bnRpbCB1bnJlbGF0ZWQgdHJhZmZpYyBoYXBwZW5zIHRvIHdha2UgaXQuIFR3byBzdWNoXG4gKiBzaXR1YXRpb25zIGV4aXN0LCBlYWNoIHdpdGggaXRzIG93biBrZXkgdmFyaWF0aW9uOlxuICpcbiAqIC0gV2FpdHMgbG9uZ2VyIHRoYW4gdGhlIG1heGltdW0gcXVldWUgZGVsYXkgYXJlIGNoYWluZWQ6IHRoZSBkZWxheSBpc1xuICogICBjbGFtcGVkIHRvIGBXQUlUX0NPTlRJTlVBVElPTl9NQVhfREVMQVlfU0VDT05EU2AgKDIzaCDigJQgVlFTIG1lc3NhZ2VzXG4gKiAgIGhhdmUgYSAyNGggcmV0ZW50aW9uIGxpbWl0LCBhbmQgb25lIGhvdXIgb2YgYnVmZmVyIG1hdGNoZXNcbiAqICAgd29ybGQtdmVyY2VsJ3Mgb3duIGNsYW1wIGZvciBkZWxheWVkIHJlLWVucXVldWVzKSwgc28gdGhlXG4gKiAgIGNvbnRpbnVhdGlvbiBpbnRlbnRpb25hbGx5IGZpcmVzIGVhcmx5LCByZS1vYnNlcnZlcyB0aGUgd2FpdCwgYW5kXG4gKiAgIG11c3QgZW5xdWV1ZSB0aGUgbmV4dCBob3AuIFRoZSBrZXkgaXMgc3VmZml4ZWQgd2l0aCB0aGUgaG9wIGluZGV4XG4gKiAgIChgY2VpbCh0aW1lb3V0U2Vjb25kcyAvIG1heERlbGF5KWApOiBzdGFibGUgZm9yIGV2ZXJ5IHJlLW9ic2VydmF0aW9uXG4gKiAgIHdpdGhpbiB0aGUgc2FtZSBob3Agd2luZG93IChzbyBwYXNzZXMgZGVkdXBlKSwgZGVjcmVtZW50ZWQgYXQgZWFjaFxuICogICBob3AgZGVsaXZlcnkgKHNvIHRoZSBjaGFpbiBhbHdheXMgYWR2YW5jZXMpLiBXb3JsZHMgd2l0aG91dCBhIGRlbGF5XG4gKiAgIGxpbWl0ICh3b3JsZC1wb3N0Z3Jlcywgd29ybGQtbG9jYWwpIHNpbXBseSB0YWtlIHRoZSBzYW1lIOKJpDIzaCBob3BzLlxuICpcbiAqIC0gTmVhci1lbGFwc2VkIHdhaXRzICjiiaQycyByZW1haW5pbmcpIGdldCBhIHNlY29uZC1idWNrZXRlZCBzdWZmaXguIEFcbiAqICAgY29udGludWF0aW9uIGRlbGl2ZXJlZCBtYXJnaW5hbGx5IGVhcmx5IChjbG9jayBza2V3IGJldHdlZW4gdGhlXG4gKiAgIGVucXVldWluZyBhbmQgaGFuZGxpbmcgaG9zdHM7IHRoZSBjZWlsKCkgb24gdGhlIGRlbGF5IGNhbiBsZWF2ZSBhIH4wXG4gKiAgIG1hcmdpbikgcmUtb2JzZXJ2ZXMgdGhlIHdhaXQgYXMgcGVuZGluZyB3aXRoIH4xcyByZW1haW5pbmcgYW5kIG11c3RcbiAqICAgYmUgYWJsZSB0byBlbnF1ZXVlIGEgZnJlc2ggc2hvcnQtZGVsYXkgcmV0cnkuIFRoZSBidWNrZXQgc3VmZml4XG4gKiAgIGtlZXBzIHRoYXQgcmV0cnkgZW5xdWV1ZWFibGUgKGl0cyDiiaUxcyBkZWxheSBndWFyYW50ZWVzIGEgbGF0ZXJcbiAqICAgYnVja2V0KSB3aGlsZSBzdGlsbCBjb2xsYXBzaW5nIHNhbWUtaW5zdGFudCBkdXBsaWNhdGVzLlxuICpcbiAqIE1pZC1yYW5nZSB3YWl0cyAobW9yZSB0aGFuIHRoZSBuZWFyLWVsYXBzZWQgdGhyZXNob2xkLCBhdCBtb3N0IG9uZVxuICogaG9wKSB1c2UgdGhlIGJhcmUgY29ycmVsYXRpb25JZDogZXZlcnkgcmUtb2JzZXJ2YXRpb24gdGFyZ2V0cyB0aGUgc2FtZVxuICogZGVhZGxpbmUsIHNvIGRlZHVwaW5nIHRvIHRoZSBmaXJzdCBtZXNzYWdlIGlzIHNlbWFudGljYWxseSBsb3NzbGVzcy5cbiAqIEhvc3QgY2xvY2sgc2tldyBiZXlvbmQgdGhlIG5lYXItZWxhcHNlZCB0aHJlc2hvbGQgY291bGQgaW4gcHJpbmNpcGxlXG4gKiBkZWxpdmVyIHN1Y2ggYSBjb250aW51YXRpb24gZWFybHkgZW5vdWdoIHRvIHJlLW9ic2VydmUgaXRzIHdhaXQgYW5kXG4gKiBsb3NlIHRoZSByZS1lbnF1ZXVlIHRvIHRoZSBidXJudCBrZXk7IHRoZSB0aHJlc2hvbGQgaXMgdGhlIHNrZXdcbiAqIHRvbGVyYW5jZSB3ZSBhY2NlcHQgZm9yIHRoZSBiZW5lZml0IG9mIGV4YWN0bHktb25lIGNvbnRpbnVhdGlvbiBwZXJcbiAqIHdhaXQuXG4gKi9cblxuLyoqXG4gKiBNYXhpbXVtIGBkZWxheVNlY29uZHNgIGZvciBhIHNpbmdsZSB3YWl0LWNvbnRpbnVhdGlvbiBtZXNzYWdlLiBXYWl0c1xuICogbG9uZ2VyIHRoYW4gdGhpcyBhcmUgY2hhaW5lZCBhY3Jvc3MgbXVsdGlwbGUgaG9wcy4gMjMgaG91cnM6IFZRU1xuICogbWVzc2FnZXMgaGF2ZSBhIDI0aCByZXRlbnRpb24gbGltaXQ7IHRoZSAxaCBidWZmZXIgbWlycm9yc1xuICogd29ybGQtdmVyY2VsJ3MgYE1BWF9ERUxBWV9TRUNPTkRTYC5cbiAqL1xuZXhwb3J0IGNvbnN0IFdBSVRfQ09OVElOVUFUSU9OX01BWF9ERUxBWV9TRUNPTkRTID0gODJfODAwO1xuXG4vKipcbiAqIFdhaXRzIHdpdGggYXQgbW9zdCB0aGlzIG1hbnkgc2Vjb25kcyByZW1haW5pbmcgdXNlIGEgc2Vjb25kLWJ1Y2tldGVkXG4gKiBpZGVtcG90ZW5jeSBrZXkgc28gYW4gZWFybHktZGVsaXZlcmVkIGNvbnRpbnVhdGlvbiBjYW4gcmUtZW5xdWV1ZSBpdHNcbiAqIHNob3J0LWRlbGF5IHJldHJ5LiBUaGlzIGlzIGFsc28gdGhlIGhvc3QgY2xvY2stc2tldyB0b2xlcmFuY2UgZm9yXG4gKiBtaWQtcmFuZ2Ugd2FpdHMga2V5ZWQgb24gdGhlIGJhcmUgY29ycmVsYXRpb25JZC5cbiAqL1xuZXhwb3J0IGNvbnN0IE5FQVJfRUxBUFNFRF9XQUlUX1RIUkVTSE9MRF9TRUNPTkRTID0gMjtcblxuZXhwb3J0IGludGVyZmFjZSBXYWl0Q29udGludWF0aW9uRGlzcGF0Y2gge1xuICBkZWxheVNlY29uZHM6IG51bWJlcjtcbiAgaWRlbXBvdGVuY3lLZXk6IHN0cmluZztcbn1cblxuLyoqXG4gKiBDb21wdXRlcyB0aGUgcXVldWUgZGVsYXkgYW5kIGlkZW1wb3RlbmN5IGtleSBmb3IgYSB3YWl0LWNvbnRpbnVhdGlvblxuICogbWVzc2FnZS4gYHRpbWVvdXRTZWNvbmRzYCBpcyB0aGUgdGltZSB1bnRpbCB0aGUgd2FpdCdzIGByZXN1bWVBdGBcbiAqIChmbG9vcmVkIGF0IDFzIGJ5IHRoZSBzdXNwZW5zaW9uIGhhbmRsZXIpOyBgd2FpdENvcnJlbGF0aW9uSWRgXG4gKiBpZGVudGlmaWVzIHRoZSB3YWl0IHNvIHJlcGVhdGVkIHN1c3BlbnNpb24gcGFzc2VzIGRlZHVwZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFdhaXRDb250aW51YXRpb25EaXNwYXRjaChcbiAgdGltZW91dFNlY29uZHM6IG51bWJlcixcbiAgd2FpdENvcnJlbGF0aW9uSWQ6IHN0cmluZyxcbiAgbm93OiBudW1iZXIgPSBEYXRlLm5vdygpXG4pOiBXYWl0Q29udGludWF0aW9uRGlzcGF0Y2gge1xuICBpZiAodGltZW91dFNlY29uZHMgPD0gTkVBUl9FTEFQU0VEX1dBSVRfVEhSRVNIT0xEX1NFQ09ORFMpIHtcbiAgICByZXR1cm4ge1xuICAgICAgZGVsYXlTZWNvbmRzOiB0aW1lb3V0U2Vjb25kcyxcbiAgICAgIGlkZW1wb3RlbmN5S2V5OiBgJHt3YWl0Q29ycmVsYXRpb25JZH06JHtNYXRoLmZsb29yKG5vdyAvIDEwMDApfWAsXG4gICAgfTtcbiAgfVxuXG4gIGNvbnN0IGhvcCA9IE1hdGguY2VpbCh0aW1lb3V0U2Vjb25kcyAvIFdBSVRfQ09OVElOVUFUSU9OX01BWF9ERUxBWV9TRUNPTkRTKTtcbiAgcmV0dXJuIHtcbiAgICBkZWxheVNlY29uZHM6IE1hdGgubWluKHRpbWVvdXRTZWNvbmRzLCBXQUlUX0NPTlRJTlVBVElPTl9NQVhfREVMQVlfU0VDT05EUyksXG4gICAgaWRlbXBvdGVuY3lLZXk6XG4gICAgICBob3AgPT09IDEgPyB3YWl0Q29ycmVsYXRpb25JZCA6IGAke3dhaXRDb3JyZWxhdGlvbklkfTpob3AtJHtob3B9YCxcbiAgfTtcbn1cbiJdfQ==

package/dist/runtime/wait-until.d.ts

@@ -0,0 +1,18 @@
+export declare function waitUntil(promise: Promise<unknown>): void;
+/**
+ * Schedule a background promise via `waitUntil`, guaranteeing that the
+ * promise handed to `waitUntil` can never reject. Nothing consumes a
+ * `waitUntil` promise, so a rejection surfaces as an `unhandledRejection`
+ * and can crash the process — even when the same underlying error is
+ * correctly handled by an awaited copy elsewhere.
+ *
+ * Expected client-disconnect errors (`AbortError` / `ResponseAborted`)
+ * are ignored. Any other error is passed to `onError` and swallowed.
+ */
+export declare function safeWaitUntil(promise: Promise<unknown>, onError: (err: unknown) => void): void;
+/**
+ * A small wrapper around `waitUntil` that also returns
+ * the result of the awaited promise.
+ */
+export declare function waitedUntil<T>(fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=wait-until.d.ts.map

package/dist/runtime/wait-until.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-until.d.ts","sourceRoot":"","sources":["../../src/runtime/wait-until.ts"],"names":[],"mappings":"AAAA,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI,CAIzD;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAC9B,IAAI,CAcN;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUrE"}

package/dist/runtime/wait-until.js

@@ -0,0 +1,42 @@
+export function waitUntil(promise) {
+    void import('@vercel/functions').then(({ waitUntil }) => {
+        waitUntil(promise);
+    });
+}
+/**
+ * Schedule a background promise via `waitUntil`, guaranteeing that the
+ * promise handed to `waitUntil` can never reject. Nothing consumes a
+ * `waitUntil` promise, so a rejection surfaces as an `unhandledRejection`
+ * and can crash the process — even when the same underlying error is
+ * correctly handled by an awaited copy elsewhere.
+ *
+ * Expected client-disconnect errors (`AbortError` / `ResponseAborted`)
+ * are ignored. Any other error is passed to `onError` and swallowed.
+ */
+export function safeWaitUntil(promise, onError) {
+    waitUntil(promise.catch((err) => {
+        const isAbortError = err?.name === 'AbortError' || err?.name === 'ResponseAborted';
+        if (!isAbortError) {
+            try {
+                onError(err);
+            }
+            catch {
+                // Never let onError break the no-reject guarantee.
+            }
+        }
+    }));
+}
+/**
+ * A small wrapper around `waitUntil` that also returns
+ * the result of the awaited promise.
+ */
+export async function waitedUntil(fn) {
+    const result = fn();
+    waitUntil(result.catch(() => {
+        // Ignore error from the promise being rejected.
+        // It's expected that the invoker of `waitedUntil`
+        // will handle the error.
+    }));
+    return result;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2FpdC11bnRpbC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9ydW50aW1lL3dhaXQtdW50aWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsTUFBTSxVQUFVLFNBQVMsQ0FBQyxPQUF5QjtJQUNqRCxLQUFLLE1BQU0sQ0FBQyxtQkFBbUIsQ0FBQyxDQUFDLElBQUksQ0FBQyxDQUFDLEVBQUUsU0FBUyxFQUFFLEVBQUUsRUFBRTtRQUN0RCxTQUFTLENBQUMsT0FBTyxDQUFDLENBQUM7SUFDckIsQ0FBQyxDQUFDLENBQUM7QUFDTCxDQUFDO0FBRUQ7Ozs7Ozs7OztHQVNHO0FBQ0gsTUFBTSxVQUFVLGFBQWEsQ0FDM0IsT0FBeUIsRUFDekIsT0FBK0I7SUFFL0IsU0FBUyxDQUNQLE9BQU8sQ0FBQyxLQUFLLENBQUMsQ0FBQyxHQUFHLEVBQUUsRUFBRTtRQUNwQixNQUFNLFlBQVksR0FDaEIsR0FBRyxFQUFFLElBQUksS0FBSyxZQUFZLElBQUksR0FBRyxFQUFFLElBQUksS0FBSyxpQkFBaUIsQ0FBQztRQUNoRSxJQUFJLENBQUMsWUFBWSxFQUFFLENBQUM7WUFDbEIsSUFBSSxDQUFDO2dCQUNILE9BQU8sQ0FBQyxHQUFHLENBQUMsQ0FBQztZQUNmLENBQUM7WUFBQyxNQUFNLENBQUM7Z0JBQ1AsbURBQW1EO1lBQ3JELENBQUM7UUFDSCxDQUFDO0lBQ0gsQ0FBQyxDQUFDLENBQ0gsQ0FBQztBQUNKLENBQUM7QUFFRDs7O0dBR0c7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLFdBQVcsQ0FBSSxFQUFvQjtJQUN2RCxNQUFNLE1BQU0sR0FBRyxFQUFFLEVBQUUsQ0FBQztJQUNwQixTQUFTLENBQ1AsTUFBTSxDQUFDLEtBQUssQ0FBQyxHQUFHLEVBQUU7UUFDaEIsZ0RBQWdEO1FBQ2hELGtEQUFrRDtRQUNsRCx5QkFBeUI7SUFDM0IsQ0FBQyxDQUFDLENBQ0gsQ0FBQztJQUNGLE9BQU8sTUFBTSxDQUFDO0FBQ2hCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgZnVuY3Rpb24gd2FpdFVudGlsKHByb21pc2U6IFByb21pc2U8dW5rbm93bj4pOiB2b2lkIHtcbiAgdm9pZCBpbXBvcnQoJ0B2ZXJjZWwvZnVuY3Rpb25zJykudGhlbigoeyB3YWl0VW50aWwgfSkgPT4ge1xuICAgIHdhaXRVbnRpbChwcm9taXNlKTtcbiAgfSk7XG59XG5cbi8qKlxuICogU2NoZWR1bGUgYSBiYWNrZ3JvdW5kIHByb21pc2UgdmlhIGB3YWl0VW50aWxgLCBndWFyYW50ZWVpbmcgdGhhdCB0aGVcbiAqIHByb21pc2UgaGFuZGVkIHRvIGB3YWl0VW50aWxgIGNhbiBuZXZlciByZWplY3QuIE5vdGhpbmcgY29uc3VtZXMgYVxuICogYHdhaXRVbnRpbGAgcHJvbWlzZSwgc28gYSByZWplY3Rpb24gc3VyZmFjZXMgYXMgYW4gYHVuaGFuZGxlZFJlamVjdGlvbmBcbiAqIGFuZCBjYW4gY3Jhc2ggdGhlIHByb2Nlc3Mg4oCUIGV2ZW4gd2hlbiB0aGUgc2FtZSB1bmRlcmx5aW5nIGVycm9yIGlzXG4gKiBjb3JyZWN0bHkgaGFuZGxlZCBieSBhbiBhd2FpdGVkIGNvcHkgZWxzZXdoZXJlLlxuICpcbiAqIEV4cGVjdGVkIGNsaWVudC1kaXNjb25uZWN0IGVycm9ycyAoYEFib3J0RXJyb3JgIC8gYFJlc3BvbnNlQWJvcnRlZGApXG4gKiBhcmUgaWdub3JlZC4gQW55IG90aGVyIGVycm9yIGlzIHBhc3NlZCB0byBgb25FcnJvcmAgYW5kIHN3YWxsb3dlZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHNhZmVXYWl0VW50aWwoXG4gIHByb21pc2U6IFByb21pc2U8dW5rbm93bj4sXG4gIG9uRXJyb3I6IChlcnI6IHVua25vd24pID0+IHZvaWRcbik6IHZvaWQge1xuICB3YWl0VW50aWwoXG4gICAgcHJvbWlzZS5jYXRjaCgoZXJyKSA9PiB7XG4gICAgICBjb25zdCBpc0Fib3J0RXJyb3IgPVxuICAgICAgICBlcnI/Lm5hbWUgPT09ICdBYm9ydEVycm9yJyB8fCBlcnI/Lm5hbWUgPT09ICdSZXNwb25zZUFib3J0ZWQnO1xuICAgICAgaWYgKCFpc0Fib3J0RXJyb3IpIHtcbiAgICAgICAgdHJ5IHtcbiAgICAgICAgICBvbkVycm9yKGVycik7XG4gICAgICAgIH0gY2F0Y2gge1xuICAgICAgICAgIC8vIE5ldmVyIGxldCBvbkVycm9yIGJyZWFrIHRoZSBuby1yZWplY3QgZ3VhcmFudGVlLlxuICAgICAgICB9XG4gICAgICB9XG4gICAgfSlcbiAgKTtcbn1cblxuLyoqXG4gKiBBIHNtYWxsIHdyYXBwZXIgYXJvdW5kIGB3YWl0VW50aWxgIHRoYXQgYWxzbyByZXR1cm5zXG4gKiB0aGUgcmVzdWx0IG9mIHRoZSBhd2FpdGVkIHByb21pc2UuXG4gKi9cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiB3YWl0ZWRVbnRpbDxUPihmbjogKCkgPT4gUHJvbWlzZTxUPik6IFByb21pc2U8VD4ge1xuICBjb25zdCByZXN1bHQgPSBmbigpO1xuICB3YWl0VW50aWwoXG4gICAgcmVzdWx0LmNhdGNoKCgpID0+IHtcbiAgICAgIC8vIElnbm9yZSBlcnJvciBmcm9tIHRoZSBwcm9taXNlIGJlaW5nIHJlamVjdGVkLlxuICAgICAgLy8gSXQncyBleHBlY3RlZCB0aGF0IHRoZSBpbnZva2VyIG9mIGB3YWl0ZWRVbnRpbGBcbiAgICAgIC8vIHdpbGwgaGFuZGxlIHRoZSBlcnJvci5cbiAgICB9KVxuICApO1xuICByZXR1cm4gcmVzdWx0O1xufVxuIl19

package/dist/runtime.d.ts

@@ -18,5 +18,7 @@ export { createWorld, getWorld, getWorldHandlers, setWorld, } from './runtime/wo
  * @param workflowCode - The workflow bundle code containing all workflow functions
  * @returns A function that can be used as a Vercel API route
  */
-export declare function workflowEntrypoint(workflowCode: string): (req: Request) => Promise<Response>;
+export declare function workflowEntrypoint(workflowCode: string, options?: {
+    namespace?: string;
+}): (req: Request) => Promise<Response>;
 //# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,KAAK,EAGV,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AA4CzB,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,MAAM,EACN,GAAG,EACH,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,GACnC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,SAAS,EACT,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,UAAU,EACV,uBAAuB,EACvB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACpC,KAAK,GACN,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,QAAQ,GACT,MAAM,oBAAoB,CAAC;AA+F5B;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,GACnB,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAymCrC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,KAAK,EAKV,KAAK,WAAW,EAEjB,MAAM,iBAAiB,CAAC;AA6CzB,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,MAAM,EACN,GAAG,EACH,KAAK,sBAAsB,EAC3B,KAAK,6BAA6B,GACnC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,SAAS,EACT,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,UAAU,EACV,uBAAuB,EACvB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,SAAS,GACV,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,+BAA+B,EACpC,KAAK,GACN,MAAM,oBAAoB,CAAC;AAK5B,OAAO,EACL,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,QAAQ,GACT,MAAM,oBAAoB,CAAC;AA+F5B;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CA8tCrC"}