@agtlantis/core 0.5.0 → 0.5.1

package/dist/execution/utils.js

@@ -0,0 +1,93 @@
+/**
+ * Calculate duration from start time in milliseconds.
+ *
+ * @param startTime - The start timestamp from Date.now()
+ * @returns Duration in milliseconds
+ */
+export function getDuration(startTime) {
+    return Date.now() - startTime;
+}
+/**
+ * Combine multiple AbortSignals into a single signal.
+ * The combined signal aborts when ANY of the source signals abort.
+ *
+ * Node 18 compatible - doesn't use AbortSignal.any() which is Node 20+.
+ *
+ * @param signals - AbortSignals to combine
+ * @returns A new AbortSignal that aborts when any input signal aborts
+ *
+ * @example
+ * ```typescript
+ * const userController = new AbortController();
+ * const timeoutController = new AbortController();
+ *
+ * const combined = combineSignals(userController.signal, timeoutController.signal);
+ *
+ * // Either abort triggers the combined signal
+ * userController.abort(); // combined.aborted === true
+ * ```
+ */
+export function combineSignals(...signals) {
+    const controller = new AbortController();
+    for (const signal of signals) {
+        // If any signal is already aborted, immediately abort and return
+        if (signal.aborted) {
+            controller.abort(signal.reason);
+            return controller.signal;
+        }
+        // Listen for future aborts
+        signal.addEventListener('abort', () => controller.abort(signal.reason), {
+            once: true,
+        });
+    }
+    return controller.signal;
+}
+/**
+ * A Promise that can be resolved or rejected externally.
+ *
+ * Useful for bridging callback-based APIs to async/await patterns.
+ * The resolve/reject functions are exposed as instance properties,
+ * allowing external code to control when the promise settles.
+ *
+ * @typeParam T - The type of the resolved value (defaults to void)
+ *
+ * @example
+ * ```typescript
+ * const deferred = new Deferred<string>();
+ *
+ * // Later, in a callback:
+ * someApi.onData((data) => deferred.resolve(data));
+ * someApi.onError((err) => deferred.reject(err));
+ *
+ * // Await the result:
+ * const result = await deferred.promise;
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // In async generator for event notification:
+ * let pending = new Deferred<void>();
+ * const subscriber = () => pending.resolve();
+ *
+ * while (!done) {
+ *   await pending.promise;
+ *   pending = new Deferred<void>(); // Reset for next wait
+ * }
+ * ```
+ */
+export class Deferred {
+    promise;
+    resolve;
+    reject;
+    constructor() {
+        let res;
+        let rej;
+        this.promise = new Promise((resolve, reject) => {
+            res = resolve;
+            rej = reject;
+        });
+        this.resolve = res;
+        this.reject = rej;
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/execution/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/execution/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAU;IACrD,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;AAAA,CAC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAAC,GAAG,OAAsB,EAAe;IACrE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAEzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,iEAAiE;QACjE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,OAAO,UAAU,CAAC,MAAM,CAAC;QAC3B,CAAC;QAED,2BAA2B;QAC3B,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE;YACtE,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU,CAAC,MAAM,CAAC;AAAA,CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,OAAO,QAAQ;IACV,OAAO,CAAa;IACpB,OAAO,CAAqB;IAC5B,MAAM,CAAyB;IAExC,cAAc;QACZ,IAAI,GAAwB,CAAC;QAC7B,IAAI,GAA4B,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;YACjD,GAAG,GAAG,OAAO,CAAC;YACd,GAAG,GAAG,MAAM,CAAC;QAAA,CACd,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,GAAG,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC;IAAA,CACnB;CACF"}