@juspay/neurolink 11.29.0 → 11.29.2

package/CHANGELOG.md

@@ -1,8 +1,8 @@
-## [11.29.0](https://github.com/juspay/neurolink/compare/v11.28.0...v11.29.0) (2026-08-25)
+## [11.29.2](https://github.com/juspay/neurolink/compare/v11.29.1...v11.29.2) (2026-08-25)
 
-### Features
+### Bug Fixes
 
-- **(core):** one dispatch decision for request kind, wired into the core call sites ([bc99c62](https://github.com/juspay/neurolink/commit/bc99c62438a497f3f6259bdb1e4e90d43e973e6b))
+- **(media):** propagate cancellation through the video generation chain ([3bcaff8](https://github.com/juspay/neurolink/commit/3bcaff8876c85705383a8c59f5b4910138ea608b))
 
 ## [11.2.3](https://github.com/juspay/neurolink/compare/v11.2.2...v11.2.3) (2026-08-19)
 

package/dist/adapters/video/vertexVideoHandler.d.ts

@@ -95,6 +95,7 @@ export declare function generateVideoWithVertex(image: Buffer, prompt: string, o
  * @throws {VideoError} When API returns an error or polling times out
  */
 export declare function generateTransitionWithVertex(firstFrame: Buffer, lastFrame: Buffer, prompt: string, options?: {
+    abortSignal?: AbortSignal;
     aspectRatio?: "9:16" | "16:9" | "1:1" | string;
     resolution?: "720p" | "1080p";
     audio?: boolean;

package/dist/adapters/video/vertexVideoHandler.js

@@ -300,6 +300,7 @@ export async function generateVideoWithVertex(image, prompt, options = {}, regio
     const durationSeconds = options.length || 6; // 4, 6, or 8
     const aspectRatio = options.aspectRatio || "16:9";
     const generateAudio = options.audio ?? true;
+    const abortSignal = options.abortSignal;
     logger.debug("Starting Vertex video generation", {
         project,
         location,
@@ -345,9 +346,13 @@ export async function generateVideoWithVertex(image, prompt, options = {}, regio
             },
         };
         logger.debug("Sending video generation request", { endpoint });
-        // Create abort controller for request timeout
+        // Create abort controller for request timeout, chained onto the
+        // caller's cancellation signal so either source stops the request.
         const controller = new AbortController();
         const requestTimeout = setTimeout(() => controller.abort(), 30000); // 30s request timeout
+        const requestSignal = abortSignal
+            ? AbortSignal.any([abortSignal, controller.signal])
+            : controller.signal;
         // Start long-running operation
         let response;
         try {
@@ -358,12 +363,22 @@ export async function generateVideoWithVertex(image, prompt, options = {}, regio
                     "Content-Type": "application/json; charset=utf-8",
                 },
                 body: JSON.stringify(requestBody),
-                signal: controller.signal,
+                signal: requestSignal,
             });
         }
         catch (error) {
             clearTimeout(requestTimeout);
             if (isAbortError(error)) {
+                if (abortSignal?.aborted) {
+                    throw new VideoError({
+                        code: VIDEO_ERROR_CODES.GENERATION_FAILED,
+                        message: "Vertex video generation aborted by caller",
+                        category: ErrorCategory.EXECUTION,
+                        severity: ErrorSeverity.MEDIUM,
+                        retriable: false,
+                        context: { provider: "vertex", endpoint },
+                    });
+                }
                 throw new VideoError({
                     code: VIDEO_ERROR_CODES.GENERATION_FAILED,
                     message: "Video generation request timed out after 30 seconds",
@@ -407,7 +422,8 @@ export async function generateVideoWithVertex(image, prompt, options = {}, regio
         logger.debug("Video generation operation started", { operationName });
         // Poll for completion using fetchPredictOperation endpoint
         const remainingTime = VIDEO_GENERATION_TIMEOUT_MS - (Date.now() - startTime);
-        const videoBuffer = await pollVideoOperation(operationName, accessToken, project, location, Math.max(1000, remainingTime));
+        const videoBuffer = await pollVideoOperation(operationName, accessToken, project, location, Math.max(1000, remainingTime), // Ensure at least 1 second timeout
+        abortSignal);
         const processingTime = Date.now() - startTime;
         // Calculate dimensions based on resolution and aspect ratio
         const dimensions = calculateDimensions(resolution, aspectRatio);
@@ -523,9 +539,12 @@ function extractVideoFromResult(result, operationName) {
  * @returns Response JSON from the poll request
  * @throws VideoError on request failure
  */
-async function makePollRequest(pollEndpoint, operationName, accessToken, timeoutMs = 30000) {
+async function makePollRequest(pollEndpoint, operationName, accessToken, timeoutMs = 30000, abortSignal) {
     const controller = new AbortController();
     const requestTimeout = setTimeout(() => controller.abort(), timeoutMs);
+    const requestSignal = abortSignal
+        ? AbortSignal.any([abortSignal, controller.signal])
+        : controller.signal;
     let response;
     try {
         response = await fetch(pollEndpoint, {
@@ -535,12 +554,22 @@ async function makePollRequest(pollEndpoint, operationName, accessToken, timeout
                 "Content-Type": "application/json; charset=utf-8",
             },
             body: JSON.stringify({ operationName }), // Pass operation name in body
-            signal: controller.signal,
+            signal: requestSignal,
         });
     }
     catch (error) {
         clearTimeout(requestTimeout);
         if (isAbortError(error)) {
+            if (abortSignal?.aborted) {
+                throw new VideoError({
+                    code: VIDEO_ERROR_CODES.GENERATION_FAILED,
+                    message: "Vertex poll for operation aborted by caller",
+                    category: ErrorCategory.EXECUTION,
+                    severity: ErrorSeverity.MEDIUM,
+                    retriable: false,
+                    context: { provider: "vertex", operationName },
+                });
+            }
             throw new VideoError({
                 code: VIDEO_ERROR_CODES.GENERATION_FAILED,
                 message: `Poll request timed out after ${timeoutMs}ms`,
@@ -589,8 +618,16 @@ async function makePollRequest(pollEndpoint, operationName, accessToken, timeout
  *
  * @throws {VideoError} On API error, timeout, or missing video data
  */
-async function pollVideoOperation(operationName, accessToken, project, location, timeoutMs) {
-    return pollOperation(VEO_MODEL, operationName, accessToken, project, location, timeoutMs);
+async function pollVideoOperation(operationName, accessToken, project, location, timeoutMs, abortSignal) {
+    return pollOperation({
+        modelOrEndpoint: VEO_MODEL,
+        operationName,
+        accessToken,
+        project,
+        location,
+        timeoutMs,
+        abortSignal,
+    });
 }
 // ============================================================================
 // TRANSITION GENERATION (Director Mode)
@@ -619,6 +656,7 @@ export async function generateTransitionWithVertex(firstFrame, lastFrame, prompt
     const aspectRatio = options.aspectRatio || "16:9";
     const resolution = options.resolution || "720p";
     const generateAudio = options.audio ?? true;
+    const abortSignal = options.abortSignal;
     logger.debug("Starting transition clip generation", {
         model: VEO_FAST_MODEL,
         durationSeconds,
@@ -658,6 +696,9 @@ export async function generateTransitionWithVertex(firstFrame, lastFrame, prompt
         };
         const controller = new AbortController();
         const requestTimeout = setTimeout(() => controller.abort(), 30000);
+        const requestSignal = abortSignal
+            ? AbortSignal.any([abortSignal, controller.signal])
+            : controller.signal;
         let response;
         try {
             response = await fetch(endpoint, {
@@ -667,12 +708,21 @@ export async function generateTransitionWithVertex(firstFrame, lastFrame, prompt
                     "Content-Type": "application/json; charset=utf-8",
                 },
                 body: JSON.stringify(requestBody),
-                signal: controller.signal,
+                signal: requestSignal,
             });
         }
         catch (error) {
             clearTimeout(requestTimeout);
             if (isAbortError(error)) {
+                if (abortSignal?.aborted) {
+                    throw new VideoError({
+                        code: VIDEO_ERROR_CODES.DIRECTOR_TRANSITION_FAILED,
+                        message: "Vertex transition generation aborted by caller",
+                        category: ErrorCategory.EXECUTION,
+                        severity: ErrorSeverity.MEDIUM,
+                        retriable: false,
+                    });
+                }
                 throw new VideoError({
                     code: VIDEO_ERROR_CODES.DIRECTOR_TRANSITION_FAILED,
                     message: "Transition generation request timed out after 30 seconds",
@@ -708,7 +758,7 @@ export async function generateTransitionWithVertex(firstFrame, lastFrame, prompt
         }
         // Poll with Veo Fast model endpoint
         const remainingTime = VIDEO_GENERATION_TIMEOUT_MS - (Date.now() - startTime);
-        const videoBuffer = await pollTransitionOperation(operationName, accessToken, project, location, Math.max(1000, remainingTime));
+        const videoBuffer = await pollTransitionOperation(operationName, accessToken, project, location, Math.max(1000, remainingTime), abortSignal);
         logger.debug("Transition clip generated", {
             processingTime: Date.now() - startTime,
             videoSize: videoBuffer.length,
@@ -733,8 +783,17 @@ export async function generateTransitionWithVertex(firstFrame, lastFrame, prompt
  * Common polling helper that handles both video and transition operations.
  * Accepts a model name to construct the appropriate endpoint.
  */
-async function pollOperation(modelOrEndpoint, operationName, accessToken, project, location, timeoutMs) {
+async function pollOperation(args) {
+    const { modelOrEndpoint, operationName, accessToken, project, location, timeoutMs, abortSignal, } = args;
     const startTime = Date.now();
+    const makeAbortedError = () => new VideoError({
+        code: VIDEO_ERROR_CODES.GENERATION_FAILED,
+        message: "Vertex poll for operation aborted by caller",
+        category: ErrorCategory.EXECUTION,
+        severity: ErrorSeverity.MEDIUM,
+        retriable: false,
+        context: { provider: "vertex", operationName },
+    });
     // Global endpoint uses aiplatform.googleapis.com (no region prefix),
     // same pattern as the predictLongRunning endpoint at line 374
     const pollHost = location === "global"
@@ -742,7 +801,10 @@ async function pollOperation(modelOrEndpoint, operationName, accessToken, projec
         : `${location}-aiplatform.googleapis.com`;
     const pollEndpoint = `https://${pollHost}/v1/projects/${project}/locations/${location}/publishers/google/models/${modelOrEndpoint}:fetchPredictOperation`;
     while (Date.now() - startTime < timeoutMs) {
-        const result = await makePollRequest(pollEndpoint, operationName, accessToken);
+        if (abortSignal?.aborted) {
+            throw makeAbortedError();
+        }
+        const result = await makePollRequest(pollEndpoint, operationName, accessToken, undefined, abortSignal);
         if (result.done) {
             return extractVideoFromResult(result, operationName);
         }
@@ -750,7 +812,19 @@ async function pollOperation(modelOrEndpoint, operationName, accessToken, projec
             operationName,
             elapsed: Date.now() - startTime,
         });
-        await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
+        // Abortable sleep — a caller abort mid-interval must not wait out the
+        // full poll interval before being observed.
+        await new Promise((resolve, reject) => {
+            const onAbort = () => {
+                clearTimeout(timer);
+                reject(makeAbortedError());
+            };
+            const timer = setTimeout(() => {
+                abortSignal?.removeEventListener("abort", onAbort);
+                resolve();
+            }, POLL_INTERVAL_MS);
+            abortSignal?.addEventListener("abort", onAbort, { once: true });
+        });
     }
     throw new VideoError({
         code: VIDEO_ERROR_CODES.POLL_TIMEOUT,
@@ -765,8 +839,16 @@ async function pollOperation(modelOrEndpoint, operationName, accessToken, projec
  * Poll Vertex AI operation for transition clip completion.
  * Uses the Veo Fast model fetchPredictOperation endpoint.
  */
-async function pollTransitionOperation(operationName, accessToken, project, location, timeoutMs) {
-    return pollOperation(VEO_FAST_MODEL, operationName, accessToken, project, location, timeoutMs);
+async function pollTransitionOperation(operationName, accessToken, project, location, timeoutMs, abortSignal) {
+    return pollOperation({
+        modelOrEndpoint: VEO_FAST_MODEL,
+        operationName,
+        accessToken,
+        project,
+        location,
+        timeoutMs,
+        abortSignal,
+    });
 }
 /**
  * Class wrapper around the standalone Vertex Veo functions, conforming to
@@ -795,6 +877,7 @@ export class VertexVideoHandler {
     }
     generateTransition(firstFrame, lastFrame, prompt, options, region) {
         return generateTransitionWithVertex(firstFrame, lastFrame, prompt, {
+            abortSignal: options?.abortSignal,
             aspectRatio: options?.aspectRatio,
             resolution: options?.resolution,
             audio: options?.audio,