@juspay/neurolink 8.26.1 → 8.28.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [8.28.0](https://github.com/juspay/neurolink/compare/v8.27.0...v8.28.0) (2026-01-02)
+
+### Features
+
+- **(video-provider):** Add video generation provider (VIDEO-GEN-003) ([e8a6eb2](https://github.com/juspay/neurolink/commit/e8a6eb2c46cf69fc341a703d7032ac381bebac23))
+
+## [8.27.0](https://github.com/juspay/neurolink/compare/v8.26.1...v8.27.0) (2026-01-01)
+
+### Features
+
+- **(validation):** Video generation input validation (VIDEO-GEN-002) ([b58a532](https://github.com/juspay/neurolink/commit/b58a532fa822b365ab26a145b20719982377b73a))
+
 ## [8.26.1](https://github.com/juspay/neurolink/compare/v8.26.0...v8.26.1) (2025-12-31)
 
 ### Bug Fixes

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

@@ -0,0 +1,91 @@
+/**
+ * Vertex AI Video Generation Handler
+ *
+ * Standalone module for Veo 3.1 video generation via Vertex AI.
+ * Generates videos from an input image and text prompt.
+ *
+ * Based on Vertex AI Veo 3.1 video generation API
+ *
+ * @module adapters/video/vertexVideoHandler
+ * @see https://cloud.google.com/vertex-ai/generative-ai/docs/video/generate-videos
+ */
+import { ErrorCategory, ErrorSeverity } from "../../constants/enums.js";
+import type { VideoGenerationResult, VideoOutputOptions } from "../../types/multimodal.js";
+import { NeuroLinkError } from "../../utils/errorHandling.js";
+/**
+ * Video generation runtime error codes
+ *
+ * These are for runtime/execution errors during video generation.
+ * Input validation errors (missing image, invalid options, etc.) are handled
+ * by parameterValidation.ts using ERROR_CODES from errorHandling.ts.
+ *
+ * Following TTS pattern (TTS_ERROR_CODES + TTSError in ttsProcessor.ts)
+ */
+export declare const VIDEO_ERROR_CODES: {
+    /** Video generation API call failed */
+    readonly GENERATION_FAILED: "VIDEO_GENERATION_FAILED";
+    /** Provider (Vertex AI) not properly configured */
+    readonly PROVIDER_NOT_CONFIGURED: "VIDEO_PROVIDER_NOT_CONFIGURED";
+    /** Polling for video completion timed out */
+    readonly POLL_TIMEOUT: "VIDEO_POLL_TIMEOUT";
+};
+/**
+ * Video generation error class
+ * Extends NeuroLinkError for consistent error handling across the SDK
+ */
+export declare class VideoError extends NeuroLinkError {
+    constructor(options: {
+        code: string;
+        message: string;
+        category?: ErrorCategory;
+        severity?: ErrorSeverity;
+        retriable?: boolean;
+        context?: Record<string, unknown>;
+        originalError?: Error;
+    });
+}
+/**
+ * Check if Vertex AI is configured for video generation
+ *
+ * @returns True if Google Cloud credentials are available
+ *
+ * @example
+ * ```typescript
+ * if (!isVertexVideoConfigured()) {
+ *   console.error("Set GOOGLE_APPLICATION_CREDENTIALS to enable video generation");
+ * }
+ * ```
+ */
+export declare function isVertexVideoConfigured(): boolean;
+/**
+ * Generate video using Vertex AI Veo 3.1
+ *
+ * Creates a video from an input image and text prompt using Google's Veo 3.1 model.
+ * The video is generated with optional audio and can be customized for resolution,
+ * duration, and aspect ratio.
+ *
+ * @param image - Input image buffer (JPEG, PNG, or WebP)
+ * @param prompt - Text prompt describing desired video motion/content (max 500 chars)
+ * @param options - Video output options (resolution, length, aspect ratio, audio)
+ * @returns VideoGenerationResult with video buffer and metadata
+ *
+ * @throws {VideoError} When credentials are not configured (PROVIDER_NOT_CONFIGURED)
+ * @throws {VideoError} When API returns an error (GENERATION_FAILED)
+ * @throws {VideoError} When polling times out (POLL_TIMEOUT)
+ *
+ * @example
+ * ```typescript
+ * import { generateVideoWithVertex } from "@juspay/neurolink/adapters/video/vertexVideoHandler";
+ * import { readFileSync, writeFileSync } from "fs";
+ *
+ * const image = readFileSync("./input.png");
+ * const result = await generateVideoWithVertex(
+ *   image,
+ *   "Smooth cinematic camera movement with dramatic lighting",
+ *   { resolution: "720p", length: 6, aspectRatio: "16:9", audio: true }
+ * );
+ *
+ * writeFileSync("output.mp4", result.data);
+ * ```
+ */
+export declare function generateVideoWithVertex(image: Buffer, prompt: string, options?: VideoOutputOptions): Promise<VideoGenerationResult>;