vargai 0.4.0-alpha44 → 0.4.0-alpha46

package/launch-videos/06-kawaii-fruits.tsx

@@ -65,12 +65,12 @@ export default (
     />
 
     {/* Scene 1-4: Each character waves individually */}
-    {CHARACTERS.map((char, i) => (
-      <Clip key={char.name} duration={2.5}>
+    {characterImages.map((charImage, i) => (
+      <Clip key={CHARACTERS[i]?.name ?? i} duration={2.5}>
         <Video
           prompt={{
             text: "character waves hello enthusiastically, bounces up and down slightly, eyes squint with joy, tiny feet wiggle",
-            images: [characterImages[i]!],
+            images: [charImage],
           }}
           model={fal.videoModel("kling-v2.5")}
           duration={5}

package/launch-videos/07-ugc-weight-loss.tsx

@@ -96,8 +96,8 @@ const voiceover = Speech({
 // === MUSIC ===
 const MUSIC_PROMPT =
   "upbeat motivational pop, inspiring transformation music, energetic but not overwhelming, modern fitness vibe";
-const MUSIC_DURATION = 15;
-const MUSIC_VOLUME = 0.15; // Low volume so voiceover is clear
+const _MUSIC_DURATION = 15;
+const _MUSIC_VOLUME = 0.15; // Low volume so voiceover is clear
 
 // === CAPTIONS SETTINGS ===
 const CAPTIONS_STYLE = "tiktok";

package/package.json

@@ -69,7 +69,7 @@
     "sharp": "^0.34.5",
     "zod": "^4.2.1"
   },
-  "version": "0.4.0-alpha44",
+  "version": "0.4.0-alpha46",
   "exports": {
     ".": "./src/index.ts",
     "./ai": "./src/ai-sdk/index.ts",

package/skills/varg-video-generation/scripts/setup.ts

@@ -9,14 +9,8 @@
  *   bun scripts/setup.ts
  */
 
-import {
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  symlinkSync,
-  writeFileSync,
-} from "node:fs";
-import { dirname, join } from "node:path";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
 
 const COLORS = {
   reset: "\x1b[0m",
@@ -228,7 +222,7 @@ Get your free API key at: ${COLORS.cyan}https://fal.ai/dashboard/keys${COLORS.re
   }
 
   if (added) {
-    writeFileSync(gitignorePath, gitignoreContent.trim() + "\n");
+    writeFileSync(gitignorePath, `${gitignoreContent.trim()}\n`);
     log.success("Updated .gitignore");
   } else {
     log.info(".gitignore already configured");

package/src/ai-sdk/cache.ts

@@ -43,7 +43,7 @@ function parseTTL(ttl: number | string | undefined): number | undefined {
   const match = ttl.match(/^(\d+)(s|m|h|d)$/);
   if (!match) return undefined;
 
-  const value = Number.parseInt(match[1]!, 10);
+  const value = Number.parseInt(match[1] ?? "0", 10);
   const unit = match[2];
 
   switch (unit) {

package/src/ai-sdk/examples/google-image.ts

@@ -22,8 +22,8 @@ async function main() {
       await Bun.write("output/google-mountain.png", images[0].uint8Array);
       console.log("   saved to output/google-mountain.png");
     }
-  } catch (error: any) {
-    console.error("   error:", error.message || error);
+  } catch (error) {
+    console.error("   error:", error instanceof Error ? error.message : error);
   }
 
   console.log("\n2. image-to-image with nano-banana-pro/edit...");
@@ -52,8 +52,8 @@ async function main() {
       );
       console.log("   saved to output/google-mountain-sunset.png");
     }
-  } catch (error: any) {
-    console.error("   error:", error.message || error);
+  } catch (error) {
+    console.error("   error:", error instanceof Error ? error.message : error);
   }
 
   console.log("\ndone!");

package/src/ai-sdk/examples/higgsfield-image.ts

@@ -15,8 +15,10 @@ async function main() {
     aspectRatio: "1:1",
   });
 
-  console.log(`image generated: ${images[0]!.uint8Array.byteLength} bytes`);
-  await Bun.write("output/higgsfield-default.png", images[0]!.uint8Array);
+  const firstImage = images[0];
+  if (!firstImage) throw new Error("No image generated");
+  console.log(`image generated: ${firstImage.uint8Array.byteLength} bytes`);
+  await Bun.write("output/higgsfield-default.png", firstImage.uint8Array);
 
   console.log("\ngenerating with model settings...");
   const { images: styledImages } = await generateImage({
@@ -28,10 +30,12 @@ async function main() {
     aspectRatio: "16:9",
   });
 
-  console.log(`styled image: ${styledImages[0]!.uint8Array.byteLength} bytes`);
+  const firstStyledImage = styledImages[0];
+  if (!firstStyledImage) throw new Error("No styled image generated");
+  console.log(`styled image: ${firstStyledImage.uint8Array.byteLength} bytes`);
   await Bun.write(
     "output/higgsfield-cinematic.png",
-    styledImages[0]!.uint8Array,
+    firstStyledImage.uint8Array,
   );
 
   console.log("\ngenerating with provider defaults...");
@@ -47,12 +51,14 @@ async function main() {
     aspectRatio: "4:3",
   });
 
+  const firstEnhancedImage = enhancedImages[0];
+  if (!firstEnhancedImage) throw new Error("No enhanced image generated");
   console.log(
-    `enhanced image: ${enhancedImages[0]!.uint8Array.byteLength} bytes`,
+    `enhanced image: ${firstEnhancedImage.uint8Array.byteLength} bytes`,
   );
   await Bun.write(
     "output/higgsfield-enhanced.png",
-    enhancedImages[0]!.uint8Array,
+    firstEnhancedImage.uint8Array,
   );
 
   console.log("\ndone!");

package/src/ai-sdk/examples/replicate-bg-removal.ts

@@ -14,10 +14,12 @@ async function main() {
     n: 1,
   });
 
-  console.log(`source image: ${sourceImages[0]!.uint8Array.byteLength} bytes`);
-  await Bun.write("output/bg-removal-source.png", sourceImages[0]!.uint8Array);
+  const firstSourceImage = sourceImages[0];
+  if (!firstSourceImage) throw new Error("No source image generated");
+  console.log(`source image: ${firstSourceImage.uint8Array.byteLength} bytes`);
+  await Bun.write("output/bg-removal-source.png", firstSourceImage.uint8Array);
 
-  const sourceFile = File.from(sourceImages[0]!);
+  const sourceFile = File.from(firstSourceImage);
 
   console.log("\nremoving background...");
   const { images: processedImages } = await generateImage({
@@ -27,12 +29,14 @@ async function main() {
     },
   });
 
+  const firstProcessedImage = processedImages[0];
+  if (!firstProcessedImage) throw new Error("No processed image generated");
   console.log(
-    `processed image: ${processedImages[0]!.uint8Array.byteLength} bytes`,
+    `processed image: ${firstProcessedImage.uint8Array.byteLength} bytes`,
   );
   await Bun.write(
     "output/bg-removal-result.png",
-    processedImages[0]!.uint8Array,
+    firstProcessedImage.uint8Array,
   );
 
   console.log("\nusing alternative model...");
@@ -43,8 +47,10 @@ async function main() {
     },
   });
 
-  console.log(`alt result: ${altImages[0]!.uint8Array.byteLength} bytes`);
-  await Bun.write("output/bg-removal-alt.png", altImages[0]!.uint8Array);
+  const firstAltImage = altImages[0];
+  if (!firstAltImage) throw new Error("No alt image generated");
+  console.log(`alt result: ${firstAltImage.uint8Array.byteLength} bytes`);
+  await Bun.write("output/bg-removal-alt.png", firstAltImage.uint8Array);
 
   console.log("\ndone!");
 }

package/src/ai-sdk/examples/talking-lion.ts

@@ -26,7 +26,9 @@ Whether you're building social content or creative apps, Varg has got you covere
     }),
   ]);
 
-  const image = File.from(imageResult.images[0]!);
+  const firstImage = imageResult.images[0];
+  if (!firstImage) throw new Error("No image generated");
+  const image = File.from(firstImage);
   const audio = File.from(speechResult.audio);
 
   console.log(`image: ${(await image.data()).byteLength} bytes`);

package/src/ai-sdk/examples/video-generation.ts

@@ -20,7 +20,9 @@ async function main() {
   });
 
   console.log("animating image to video...");
-  const image = File.from(images[0]!);
+  const firstImage = images[0];
+  if (!firstImage) throw new Error("No image generated");
+  const image = File.from(firstImage);
   const { video: animatedVideo } = await generateVideo({
     model: fal.videoModel("wan-2.5"),
     prompt: {

package/src/ai-sdk/examples/workflow-animated-girl.ts

@@ -30,7 +30,9 @@ Don't forget to like and subscribe for more content like this!`;
     cacheKey: ["animated-girl", "portrait"],
   });
 
-  const imageData = images[0]!.uint8Array;
+  const firstImage = images[0];
+  if (!firstImage) throw new Error("No image generated");
+  const imageData = firstImage.uint8Array;
   await Bun.write("output/workflow-girl-image.png", imageData);
   console.log("saved: output/workflow-girl-image.png");
 

package/src/ai-sdk/examples/workflow-before-after.ts

@@ -24,7 +24,9 @@ async function main() {
     cacheKey: ["before-after", "before-image"],
   });
 
-  const beforeImage = beforeImages[0]!.uint8Array;
+  const firstBeforeImage = beforeImages[0];
+  if (!firstBeforeImage) throw new Error("No before image generated");
+  const beforeImage = firstBeforeImage.uint8Array;
   await Bun.write("output/workflow-before-image.png", beforeImage);
   console.log("saved: output/workflow-before-image.png");
 
@@ -37,7 +39,9 @@ async function main() {
     cacheKey: ["before-after", "after-image"],
   });
 
-  const afterImage = afterImages[0]!.uint8Array;
+  const firstAfterImage = afterImages[0];
+  if (!firstAfterImage) throw new Error("No after image generated");
+  const afterImage = firstAfterImage.uint8Array;
   await Bun.write("output/workflow-after-image.png", afterImage);
   console.log("saved: output/workflow-after-image.png");
 

package/src/ai-sdk/examples/workflow-character-grid.ts

@@ -71,7 +71,9 @@ async function main() {
         n: 1,
         cacheKey: ["character-grid", name],
       });
-      const data = images[0]!.uint8Array;
+      const firstImage = images[0];
+      if (!firstImage) throw new Error(`No image generated for ${name}`);
+      const data = firstImage.uint8Array;
       await Bun.write(`output/character-${i}-${name.toLowerCase()}.png`, data);
       return {
         name,

package/src/ai-sdk/examples/workflow-slideshow.ts

@@ -46,7 +46,9 @@ And ending with this amazing view.`;
         n: 1,
         cacheKey: ["slideshow", "scene", i],
       });
-      const data = images[0]!.uint8Array;
+      const firstImage = images[0];
+      if (!firstImage) throw new Error(`No image generated for scene ${i}`);
+      const data = firstImage.uint8Array;
       await Bun.write(`output/workflow-scene-${i}.png`, data);
       return `output/workflow-scene-${i}.png`;
     }),
@@ -62,7 +64,9 @@ And ending with this amazing view.`;
     cacheKey: ["slideshow", "talking-head"],
   });
 
-  const talkingImage = talkingImages[0]!.uint8Array;
+  const firstTalkingImage = talkingImages[0];
+  if (!firstTalkingImage) throw new Error("No talking head image generated");
+  const talkingImage = firstTalkingImage.uint8Array;
   await Bun.write("output/workflow-talking-head.png", talkingImage);
 
   console.log("\nstep 3: generating voiceover...");
@@ -121,7 +125,7 @@ And ending with this amazing view.`;
   await Bun.write("output/workflow-slideshow.srt", srtContent);
 
   console.log("\nstep 7: creating slideshow with pip...");
-  const clips = sceneImages.map((imagePath, i) => ({
+  const clips = sceneImages.map((imagePath, _i) => ({
     duration: 2,
     layers: [
       { type: "image" as const, path: imagePath },

package/src/ai-sdk/file.ts

@@ -1,4 +1,5 @@
 import type { ImageModelV3File } from "@ai-sdk/provider";
+import type { StorageProvider } from "./storage/types";
 
 export class File {
   private _data: Uint8Array | null = null;
@@ -8,13 +9,14 @@ export class File {
 
   private constructor(
     options:
-      | { data: Uint8Array; mediaType: string }
+      | { data: Uint8Array; mediaType: string; url?: string }
       | { url: string; mediaType?: string }
       | { loader: () => Promise<Uint8Array>; mediaType: string },
   ) {
     if ("data" in options) {
       this._data = options.data;
       this._mediaType = options.mediaType;
+      this._url = options.url ?? null;
     } else if ("url" in options) {
       this._url = options.url;
       this._mediaType = options.mediaType ?? inferMediaType(options.url);
@@ -46,10 +48,12 @@ export class File {
   static fromGenerated(generated: {
     uint8Array: Uint8Array;
     mediaType: string;
+    url?: string;
   }): File {
     return new File({
       data: generated.uint8Array,
       mediaType: generated.mediaType,
+      url: generated.url,
     });
   }
 
@@ -119,6 +123,10 @@ export class File {
     return this._mediaType.startsWith("video/");
   }
 
+  get url(): string | null {
+    return this._url;
+  }
+
   async data(): Promise<Uint8Array> {
     if (this._data) return this._data;
     if (this._loader) {
@@ -142,38 +150,41 @@ export class File {
     return new Blob([data], { type: this._mediaType });
   }
 
-  async url(uploader?: (blob: Blob) => Promise<string>): Promise<string> {
-    if (this._url && !this._data && !this._loader) {
-      return this._url;
-    }
-    const blob = await this.blob();
-    if (uploader) return uploader(blob);
-    try {
-      const { fal } = await import("@fal-ai/client");
-      return fal.storage.upload(blob);
-    } catch {
-      throw new Error("No uploader provided and @fal-ai/client not available.");
-    }
+  /**
+   * Upload file to storage and return the URL. Returns cached URL if already uploaded.
+   * @param storage - Storage provider to use for upload
+   * @returns URL of the uploaded file
+   */
+  async upload(storage: StorageProvider): Promise<string> {
+    if (this._url) return this._url;
+    const data = await this.data();
+    const key = `varg/${Date.now()}-${Math.random().toString(36).slice(2)}${this.extensionFromMediaType()}`;
+    this._url = await storage.upload(data, key, this._mediaType);
+    return this._url;
   }
 
   async base64(): Promise<string> {
     const data = await this.arrayBuffer();
     let binary = "";
-    for (let i = 0; i < data.byteLength; i++) {
-      binary += String.fromCharCode(data[i]!);
+    for (const byte of data) {
+      binary += String.fromCharCode(byte);
     }
     return btoa(binary);
   }
 
   async toInput(): Promise<ImageModelV3File> {
-    if (this._url && !this._data && !this._loader) {
+    if (this._url) {
       return { type: "url", url: this._url };
     }
     const data = await this.arrayBuffer();
     return { type: "file", mediaType: this._mediaType, data };
   }
 
-  async toTemp(): Promise<string> {
+  /**
+   * Write file data to a temporary file and return the path.
+   * @returns Path to the temporary file
+   */
+  async toTempFile(): Promise<string> {
     const data = await this.data();
     const ext = this.extensionFromMediaType();
     const tmpDir = process.env.TMPDIR ?? "/tmp";
@@ -189,10 +200,10 @@ export class File {
       | File,
   ): Promise<string> {
     if (file instanceof File) {
-      return file.toTemp();
+      return file.toTempFile();
     }
     const f = File.from(file);
-    return f.toTemp();
+    return f.toTempFile();
   }
 
   private extensionFromMediaType(): string {

package/src/ai-sdk/generate-element.ts

@@ -24,8 +24,8 @@ export function scene(
 
   for (let i = 0; i < strings.length; i++) {
     text += strings[i];
-    if (i < elements.length) {
-      const el = elements[i]!;
+    const el = elements[i];
+    if (el) {
       const count = el.images.length;
 
       if (count === 1) {

package/src/ai-sdk/generate-video.ts

@@ -59,9 +59,8 @@ class DefaultGeneratedVideo implements GeneratedVideo {
 
   get base64(): string {
     let binary = "";
-    const bytes = this._data;
-    for (let i = 0; i < bytes.byteLength; i++) {
-      binary += String.fromCharCode(bytes[i]!);
+    for (const byte of this._data) {
+      binary += String.fromCharCode(byte);
     }
     return btoa(binary);
   }
@@ -158,7 +157,7 @@ export async function generateVideo(
   }
 
   return {
-    video: videos[0]!,
+    video: videos[0] as GeneratedVideo,
     videos,
     warnings,
   };

package/src/ai-sdk/index.ts

@@ -54,8 +54,14 @@ export {
   type Clip as EditlyClip,
   type EditlyConfig,
   editly,
+  type FFmpegBackend,
   type Layer as EditlyLayer,
+  localBackend,
 } from "./providers/editly";
+export {
+  createRendiBackend,
+  type RendiBackendOptions,
+} from "./providers/editly/rendi";
 export {
   createElevenLabs,
   type ElevenLabsProvider,
@@ -92,6 +98,12 @@ export {
   createTogetherProvider,
   together,
 } from "./providers/together";
+export {
+  falStorage,
+  type R2StorageOptions,
+  r2Storage,
+  type StorageProvider,
+} from "./storage";
 export type {
   VideoModelV3,
   VideoModelV3CallOptions,

package/src/ai-sdk/middleware/placeholder.ts

@@ -35,9 +35,9 @@ function hslToHex(hsl: string): string {
   const match = hsl.match(/hsl\((\d+),(\d+)%,(\d+)%\)/);
   if (!match) return "333333";
 
-  const h = Number.parseInt(match[1]!) / 360;
-  const s = Number.parseInt(match[2]!) / 100;
-  const l = Number.parseInt(match[3]!) / 100;
+  const h = Number.parseInt(match[1] ?? "0", 10) / 360;
+  const s = Number.parseInt(match[2] ?? "0", 10) / 100;
+  const l = Number.parseInt(match[3] ?? "0", 10) / 100;
 
   const hue2rgb = (p: number, q: number, t: number) => {
     if (t < 0) t += 1;

package/src/ai-sdk/middleware/wrap-image-model.ts

@@ -1,8 +1,4 @@
-import type {
-  ImageModelV3,
-  ImageModelV3CallOptions,
-  ImageModelV3Middleware,
-} from "@ai-sdk/provider";
+import type { ImageModelV3, ImageModelV3Middleware } from "@ai-sdk/provider";
 import { wrapImageModel } from "ai";
 import { generatePlaceholder } from "./placeholder";
 import type { RenderMode } from "./wrap-video-model";

package/src/ai-sdk/providers/editly/backends/index.ts

@@ -4,5 +4,6 @@ export type {
   FFmpegInput,
   FFmpegRunOptions,
   FFmpegRunResult,
+  FilePath,
   VideoInfo,
 } from "./types";

package/src/ai-sdk/providers/editly/backends/local.ts

@@ -1,9 +1,11 @@
 import { $ } from "bun";
+import { File } from "../../../file";
 import type {
   FFmpegBackend,
   FFmpegInput,
   FFmpegRunOptions,
   FFmpegRunResult,
+  FilePath,
   VideoInfo,
 } from "./types";
 
@@ -38,16 +40,23 @@ export class LocalBackend implements FFmpegBackend {
     };
   }
 
-  private buildInputArgs(inputs: FFmpegInput[]): string[] {
+  async resolvePath(path: FilePath): Promise<string> {
+    if (typeof path === "string") return path;
+    return path.url ?? (await path.toTempFile());
+  }
+
+  private async buildInputArgs(inputs: FFmpegInput[]): Promise<string[]> {
     const args: string[] = [];
     for (const input of inputs) {
-      if (typeof input === "string") {
+      if (input instanceof File) {
+        args.push("-i", await this.resolvePath(input));
+      } else if (typeof input === "string") {
         args.push("-i", input);
       } else if ("raw" in input) {
         args.push(...input.raw);
       } else {
         if (input.options) args.push(...input.options);
-        args.push("-i", input.path);
+        args.push("-i", await this.resolvePath(input.path));
       }
     }
     return args;
@@ -63,7 +72,7 @@ export class LocalBackend implements FFmpegBackend {
       verbose,
     } = options;
 
-    const inputArgs = this.buildInputArgs(inputs);
+    const inputArgs = await this.buildInputArgs(inputs);
 
     const ffmpegArgs = [
       "-hide_banner",

package/src/ai-sdk/providers/editly/backends/types.ts

@@ -3,6 +3,7 @@
  * Allows switching between local ffmpeg and cloud services like Rendi
  */
 
+import type { File } from "../../../file";
 import type { VideoInfo } from "../types";
 
 /**
@@ -10,14 +11,16 @@ import type { VideoInfo } from "../types";
  */
 export type { VideoInfo };
 
+export type FilePath = File | string;
+
 /**
- * Represents an input to ffmpeg - can be a simple path/URL or structured with options
+ * Represents an input to ffmpeg - can be a simple path/URL, File, or structured with options
  */
 export type FFmpegInput =
-  | string
+  | FilePath
   | {
-      /** Path or URL to the input file */
-      path: string;
+      /** Path, URL, or File for the input */
+      path: FilePath;
       /** Options to apply BEFORE the -i flag (e.g. -ss 5 for seeking) */
       options?: string[];
     }
@@ -65,6 +68,13 @@ export interface FFmpegBackend {
    */
   ffprobe(input: string): Promise<VideoInfo>;
 
+  /**
+   * Resolve a FilePath to a string path/URL for ffmpeg
+   * Local backend: returns URL if available, otherwise writes to temp
+   * Rendi backend: uploads local files, returns URL
+   */
+  resolvePath(path: FilePath): Promise<string>;
+
   /**
    * Run ffmpeg command
    * @param options - Execution options including args, inputs, and output path

package/src/ai-sdk/providers/editly/index.ts

@@ -161,7 +161,7 @@ function isTextOverlayLayer(layer: Layer): boolean {
 
 function buildBaseClipFilter(
   clip: ProcessedClip,
-  clipIndex: number,
+  _clipIndex: number,
   width: number,
   height: number,
   inputOffset: number,
@@ -416,8 +416,7 @@ function buildAudioFilter(
   let inputIdx = videoInputCount;
 
   if (videoSourceAudio && videoSourceAudio.length > 0) {
-    for (let i = 0; i < videoSourceAudio.length; i++) {
-      const src = videoSourceAudio[i]!;
+    for (const [i, src] of videoSourceAudio.entries()) {
       const { inputIndex, startTime, duration, cutFrom, mixVolume } = src;
 
       const shouldInclude =
@@ -460,8 +459,7 @@ function buildAudioFilter(
     inputIdx++;
   }
 
-  for (let i = 0; i < audioTracks.length; i++) {
-    const track = audioTracks[i]!;
+  for (const [i, track] of audioTracks.entries()) {
     audioInputs.push(track.path);
     const label = `atrk${i}`;
 
@@ -483,8 +481,7 @@ function buildAudioFilter(
     inputIdx++;
   }
 
-  for (let i = 0; i < clipAudioLayers.length; i++) {
-    const { layer, clipStartTime } = clipAudioLayers[i]!;
+  for (const [i, { layer, clipStartTime }] of clipAudioLayers.entries()) {
     audioInputs.push(layer.path);
     const label = `aclip${i}`;
 

package/src/ai-sdk/providers/editly/layers.ts

@@ -37,7 +37,6 @@ function getCropPositionExpr(position: CropPosition | undefined): {
       return { x: "(iw-ow)/2", y: "ih-oh" };
     case "bottom-right":
       return { x: "iw-ow", y: "ih-oh" };
-    case "center":
     default:
       return { x: "(iw-ow)/2", y: "(ih-oh)/2" };
   }