@juspay/neurolink 9.86.5 → 9.87.1

package/dist/lib/adapters/video/replicateVideoHandler.js

@@ -51,27 +51,37 @@ export class ReplicateVideoHandler {
         const startTime = Date.now();
         const model = options.model ?? DEFAULT_MODEL;
         const dataUri = `data:image/${this.detectImageType(image)};base64,${image.toString("base64")}`;
-        // Wan-Alpha + most image-to-video models accept this shape; specific
-        // models may require provider-specific extras passed through
-        // VideoOutputOptions.[unknown key].
+        // Replicate image-to-video models do not share an input schema. The
+        // legacy shape below (`image` + `num_frames`/`fps`/`aspect_ratio`) fits
+        // Wan-Alpha-era models; current models (minimax/hailuo-2.3-*,
+        // wan-video/wan-2.7-i2v) key the image as `first_frame_image` /
+        // `first_frame` and take `duration` instead of frame counts — a missing
+        // required image key fails the prediction on submit. `imageInputKey`
+        // selects the image key AND the modern `duration`/`resolution` shape;
+        // omitting it preserves the legacy payload exactly.
         //
-        // `resolution` is forwarded as the `resolution` input parameter.
-        // Wan-Alpha and several other Replicate image-to-video models accept it
-        // (e.g. "720p", "1080p"). Models that do not recognise it will silently
-        // ignore the field — the Replicate API does not reject unknown input keys.
         // `calculateDimensions` still populates the metadata `dimensions` field
         // so downstream consumers always receive correct width/height regardless
         // of whether the model honoured the resolution hint.
-        const inputPayload = {
-            image: dataUri,
-            prompt,
-            num_frames: (options.length ?? 4) * 24, // Assume 24 fps
-            fps: 24,
-            aspect_ratio: options.aspectRatio,
-            ...(options.resolution !== undefined
-                ? { resolution: options.resolution }
-                : {}),
-        };
+        const inputPayload = options.imageInputKey !== undefined
+            ? {
+                [options.imageInputKey]: dataUri,
+                prompt,
+                duration: options.length ?? 4,
+                ...(options.resolution !== undefined
+                    ? { resolution: options.resolution }
+                    : {}),
+            }
+            : {
+                image: dataUri,
+                prompt,
+                num_frames: (options.length ?? 4) * 24, // Assume 24 fps
+                fps: 24,
+                aspect_ratio: options.aspectRatio,
+                ...(options.resolution !== undefined
+                    ? { resolution: options.resolution }
+                    : {}),
+            };
         let prediction;
         try {
             prediction = await predict(auth, { model, input: inputPayload }, { abortSignal: options.abortSignal });

package/dist/lib/types/multimodal.d.ts

@@ -190,6 +190,18 @@ export type VideoOutputOptions = {
      * `image` Buffer argument passed to `generate()`.
      */
     imageUrl?: string;
+    /**
+     * Replicate only: the input-schema key the model expects the image under.
+     * Replicate image-to-video models disagree on this — e.g.
+     * `minimax/hailuo-2.3-fast` requires `first_frame_image`,
+     * `wan-video/wan-2.7-i2v` requires `first_frame` — and a model whose
+     * required image key is missing fails the prediction on submit. Setting
+     * this also switches the payload to the modern `duration`/`resolution`
+     * field shape those models expect (instead of the legacy
+     * `num_frames`/`fps`/`aspect_ratio` shape). Omit for models that accept
+     * the default `image` key.
+     */
+    imageInputKey?: string;
     /**
      * Per-call provider credentials. Takes precedence over instance-level
      * credentials set at construction time, which in turn override env vars.

package/dist/lib/utils/safeFetch.js

@@ -28,13 +28,23 @@ const DEFAULT_TIMEOUT_MS = 60_000;
 function buildPinnedAgent(hostname, ip, family) {
     return new Agent({
         connect: {
-            lookup: (host, _options, callback) => {
+            lookup: (host, options, callback) => {
                 if (host.toLowerCase() !== hostname.toLowerCase()) {
                     // The host the connect layer asks for differs from the URL host —
                     // this happens for absolute Host headers etc. Reject defensively.
                     callback(new Error(`safeFetch: refusing to resolve "${host}" — expected "${hostname}"`), "", 0);
                     return;
                 }
+                // Node ≥20 enables autoSelectFamily (Happy Eyeballs) by default, and
+                // its lookup contract passes `all: true` expecting an address ARRAY.
+                // Answering with the string form there fails the connection with
+                // "Invalid IP address: undefined" — which broke every safeDownload
+                // (Replicate / Runway / Kling asset fetches) on modern Node while
+                // plain curl of the same URL succeeded.
+                if (options?.all) {
+                    callback(null, [{ address: ip, family }]);
+                    return;
+                }
                 callback(null, ip, family);
             },
         },

package/dist/types/multimodal.d.ts

@@ -190,6 +190,18 @@ export type VideoOutputOptions = {
      * `image` Buffer argument passed to `generate()`.
      */
     imageUrl?: string;
+    /**
+     * Replicate only: the input-schema key the model expects the image under.
+     * Replicate image-to-video models disagree on this — e.g.
+     * `minimax/hailuo-2.3-fast` requires `first_frame_image`,
+     * `wan-video/wan-2.7-i2v` requires `first_frame` — and a model whose
+     * required image key is missing fails the prediction on submit. Setting
+     * this also switches the payload to the modern `duration`/`resolution`
+     * field shape those models expect (instead of the legacy
+     * `num_frames`/`fps`/`aspect_ratio` shape). Omit for models that accept
+     * the default `image` key.
+     */
+    imageInputKey?: string;
     /**
      * Per-call provider credentials. Takes precedence over instance-level
      * credentials set at construction time, which in turn override env vars.

package/dist/utils/safeFetch.js

@@ -28,13 +28,23 @@ const DEFAULT_TIMEOUT_MS = 60_000;
 function buildPinnedAgent(hostname, ip, family) {
     return new Agent({
         connect: {
-            lookup: (host, _options, callback) => {
+            lookup: (host, options, callback) => {
                 if (host.toLowerCase() !== hostname.toLowerCase()) {
                     // The host the connect layer asks for differs from the URL host —
                     // this happens for absolute Host headers etc. Reject defensively.
                     callback(new Error(`safeFetch: refusing to resolve "${host}" — expected "${hostname}"`), "", 0);
                     return;
                 }
+                // Node ≥20 enables autoSelectFamily (Happy Eyeballs) by default, and
+                // its lookup contract passes `all: true` expecting an address ARRAY.
+                // Answering with the string form there fails the connection with
+                // "Invalid IP address: undefined" — which broke every safeDownload
+                // (Replicate / Runway / Kling asset fetches) on modern Node while
+                // plain curl of the same URL succeeded.
+                if (options?.all) {
+                    callback(null, [{ address: ip, family }]);
+                    return;
+                }
                 callback(null, ip, family);
             },
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.86.5",
+  "version": "9.87.1",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (58+ servers), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {