@vargai/sdk 0.1.1 → 0.2.0

package/cli/commands/upload.ts

@@ -0,0 +1,215 @@
+/**
+ * varg upload command
+ * upload local files to cloudflare r2 storage
+ */
+
+import { existsSync, statSync } from "node:fs";
+import path from "node:path";
+import { defineCommand } from "citty";
+import { uploadFile } from "../../utilities/s3";
+import { box, c, formatDuration, row, success, error } from "../ui";
+
+/**
+ * Get file type category from extension
+ */
+function getFileType(ext: string): string {
+  const normalized = ext.toLowerCase();
+
+  const imageExts = [".jpg", ".jpeg", ".png", ".gif", ".webp", ".bmp", ".svg"];
+  const videoExts = [".mp4", ".mpeg", ".mpg", ".mov", ".avi", ".webm", ".mkv"];
+  const audioExts = [".mp3", ".wav", ".ogg", ".flac", ".aac", ".m4a"];
+
+  if (imageExts.includes(normalized)) return "image";
+  if (videoExts.includes(normalized)) return "video";
+  if (audioExts.includes(normalized)) return "audio";
+
+  return "file";
+}
+
+/**
+ * Create URL-safe slug from filename
+ */
+function slugify(text: string, maxLength = 40): string {
+  return text
+    .toLowerCase()
+    .replace(/[\s_]+/g, "-")
+    .replace(/[^\w-]/g, "")
+    .replace(/-+/g, "-")
+    .replace(/^-|-$/g, "")
+    .slice(0, maxLength)
+    .replace(/-$/, "") || "file";
+}
+
+/**
+ * Format file size in human readable format
+ */
+function formatSize(bytes: number): string {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+  if (bytes < 1024 * 1024 * 1024)
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+
+/**
+ * Generate S3 object key from file path and optional destination
+ */
+function generateObjectKey(filePath: string, destination?: string): string {
+  const filename = path.basename(filePath);
+
+  if (destination) {
+    // If ends with "/", append original filename
+    if (destination.endsWith("/")) {
+      return `${destination}${filename}`;
+    }
+    // Use destination as-is (full path specified)
+    return destination;
+  }
+
+  // Auto-generate path: uploads/{type}s/{slug}_{uuid}.{ext}
+  const ext = path.extname(filePath);
+  const basename = path.basename(filePath, ext);
+  const fileType = getFileType(ext);
+  const slug = slugify(basename);
+  const uuid = crypto.randomUUID().slice(0, 8);
+
+  return `uploads/${fileType}s/${slug}_${uuid}${ext}`;
+}
+
+export const uploadCmd = defineCommand({
+  meta: {
+    name: "upload",
+    description: "upload local file to cloud storage",
+  },
+  args: {
+    file: {
+      type: "positional",
+      description: "local file path to upload",
+      required: true,
+    },
+    destination: {
+      type: "string",
+      alias: "d",
+      description:
+        "s3 destination path (e.g. users/123/video.mp4 or projects/abc/)",
+    },
+    json: {
+      type: "boolean",
+      description: "output result as json",
+    },
+    quiet: {
+      type: "boolean",
+      description: "minimal output",
+    },
+  },
+  async run({ args }) {
+    const { file: filePath, destination, json, quiet } = args;
+
+    // Validate file exists
+    if (!filePath || !existsSync(filePath)) {
+      if (json) {
+        console.log(
+          JSON.stringify({ success: false, error: "file not found" }),
+        );
+      } else {
+        console.error(`${c.red("error:")} file not found: ${filePath}`);
+      }
+      process.exit(1);
+    }
+
+    // Get file info
+    const stats = statSync(filePath);
+    const filename = path.basename(filePath);
+    const ext = path.extname(filePath);
+    const fileType = getFileType(ext);
+    const fileSize = stats.size;
+
+    // Generate object key
+    const objectKey = generateObjectKey(filePath, destination);
+
+    // Show progress
+    if (!quiet && !json) {
+      const content = [
+        "",
+        row("file", filename),
+        row("size", formatSize(fileSize)),
+        row("type", fileType),
+        "",
+        `  ${c.cyan("◐")} uploading...`,
+        "",
+      ];
+      console.log(box("upload", content));
+    }
+
+    const startTime = Date.now();
+
+    try {
+      const url = await uploadFile(filePath, objectKey);
+      const elapsed = Date.now() - startTime;
+
+      if (json) {
+        console.log(
+          JSON.stringify({
+            success: true,
+            file: filename,
+            size: fileSize,
+            type: fileType,
+            destination: objectKey,
+            url,
+            time: elapsed,
+          }),
+        );
+      } else if (quiet) {
+        console.log(url);
+      } else {
+        // Clear and show result
+        console.log("\x1b[2J\x1b[H");
+
+        const content = [
+          "",
+          row("file", filename),
+          row("size", formatSize(fileSize)),
+          row("type", fileType),
+          "",
+          success(`uploaded in ${formatDuration(elapsed)}`),
+          "",
+          row("destination", objectKey),
+          "",
+        ];
+
+        console.log(box("upload", content));
+        console.log(`\n  ${c.cyan("url")}  ${url}\n`);
+      }
+    } catch (err) {
+      const elapsed = Date.now() - startTime;
+      const errorMsg = err instanceof Error ? err.message : String(err);
+
+      if (json) {
+        console.log(
+          JSON.stringify({ success: false, error: errorMsg, time: elapsed }),
+        );
+      } else if (quiet) {
+        console.error(errorMsg);
+      } else {
+        console.log("\x1b[2J\x1b[H");
+
+        const content = [
+          "",
+          row("file", filename),
+          row("size", formatSize(fileSize)),
+          row("type", fileType),
+          "",
+          error("upload failed"),
+          "",
+          row("error", errorMsg),
+          "",
+        ];
+
+        console.log(box("upload", content));
+      }
+
+      process.exit(1);
+    }
+  },
+});
+

package/cli/index.ts

@@ -10,12 +10,13 @@ import { findCmd } from "./commands/find";
 import { helpCmd } from "./commands/help";
 import { listCmd } from "./commands/list";
 import { runCmd } from "./commands/run";
+import { uploadCmd } from "./commands/upload";
 import { whichCmd } from "./commands/which";
 
 const main = defineCommand({
   meta: {
     name: "varg",
-    version: "0.1.0",
+    version: "0.2.0",
     description: "ai video infrastructure from your terminal",
   },
   subCommands: {
@@ -26,6 +27,7 @@ const main = defineCommand({
     search: findCmd,
     which: whichCmd,
     inspect: whichCmd,
+    upload: uploadCmd,
     help: helpCmd,
   },
 });

package/commitlint.config.js

@@ -0,0 +1,22 @@
+export default {
+  extends: ["@commitlint/config-conventional"],
+  rules: {
+    "type-enum": [
+      2,
+      "always",
+      [
+        "feat", // New feature
+        "fix", // Bug fix
+        "docs", // Documentation changes
+        "style", // Code style changes (formatting, etc)
+        "refactor", // Code refactoring
+        "perf", // Performance improvements
+        "test", // Test changes
+        "build", // Build system changes
+        "ci", // CI/CD changes
+        "chore", // Other changes
+        "revert", // Revert previous commit
+      ],
+    ],
+  },
+};

package/index.ts

@@ -14,6 +14,7 @@ export {
   addCaptions,
   type SubtitleStyle,
 } from "./action/captions";
+export { type CutOptions, type CutResult, cut } from "./action/cut";
 export {
   type CreateMontageOptions,
   createMontage,
@@ -26,11 +27,15 @@ export {
   quickResize,
   quickTrim,
 } from "./action/edit";
+export { type FadeOptions, type FadeResult, fade } from "./action/fade";
 export {
   generateWithFal,
   generateWithSoul,
   type ImageGenerationResult,
 } from "./action/image";
+export { type MergeOptions, type MergeResult, merge } from "./action/merge";
+export { type RemoveOptions, type RemoveResult, remove } from "./action/remove";
+export { type SplitOptions, type SplitResult, split } from "./action/split";
 export {
   type LipsyncOptions,
   lipsync,
@@ -43,6 +48,13 @@ export {
   type TranscribeResult,
   transcribe,
 } from "./action/transcribe";
+export {
+  type TransitionOptions,
+  type TransitionResult,
+  transition,
+} from "./action/transition";
+// new action exports - video editing
+export { type TrimOptions, type TrimResult, trim } from "./action/trim";
 export {
   generateVideoFromImage,
   generateVideoFromText,