@vargai/sdk 0.1.1 → 0.2.0

package/service/music/index.ts

@@ -5,9 +5,9 @@
  * supports text-to-music with customizable styles, lyrics, and parameters
  */
 
+import { writeFile } from "node:fs/promises";
 import { textToMusic } from "../../lib/fal";
 import { uploadFromUrl } from "../../utilities/s3";
-import { writeFile } from "node:fs/promises";
 
 // types
 export interface GenerateMusicOptions {
@@ -84,12 +84,19 @@ export async function generateMusic(
     tags: result.data.tags,
     lyrics: result.data.lyrics,
     audio: Array.isArray(result.data.audio)
-      ? result.data.audio.map((a: any) => ({
-          url: a.url,
-          fileName: a.file_name,
-          contentType: a.content_type,
-          fileSize: a.file_size,
-        }))
+      ? result.data.audio.map(
+          (a: {
+            url: string;
+            file_name: string;
+            content_type: string;
+            file_size: number;
+          }) => ({
+            url: a.url,
+            fileName: a.file_name,
+            contentType: a.content_type,
+            fileSize: a.file_size,
+          }),
+        )
       : [
           {
             url: result.data.audio.url,
@@ -104,6 +111,8 @@ export async function generateMusic(
   if (outputPath) {
     for (let i = 0; i < musicResult.audio.length; i++) {
       const audio = musicResult.audio[i];
+      if (!audio) continue;
+
       const ext = format || "wav";
       const filePath =
         musicResult.audio.length === 1
@@ -123,6 +132,8 @@ export async function generateMusic(
     const uploadUrls: string[] = [];
     for (let i = 0; i < musicResult.audio.length; i++) {
       const audio = musicResult.audio[i];
+      if (!audio) continue;
+
       const objectKey = `music/${Date.now()}-${i + 1}.${format || "wav"}`;
       const uploadUrl = await uploadFromUrl(audio.url, objectKey);
       uploadUrls.push(uploadUrl);
@@ -170,8 +181,13 @@ environment:
     switch (command) {
       case "generate": {
         const prompt = args[1];
-        const format = (args[2] || "mp3") as "flac" | "mp3" | "wav" | "ogg" | "m4a";
-        const numSongs = (parseInt(args[3]) || 1) as 1 | 2;
+        const format = (args[2] || "mp3") as
+          | "flac"
+          | "mp3"
+          | "wav"
+          | "ogg"
+          | "m4a";
+        const numSongs = (Number.parseInt(args[3] || "1", 10) || 1) as 1 | 2;
         const upload = args[4] === "true";
 
         if (!prompt) {
@@ -206,11 +222,11 @@ environment:
 
         for (let i = 1; i < args.length; i++) {
           const arg = args[i];
-          if (["mp3", "wav", "flac", "ogg", "m4a"].includes(arg)) {
+          if (arg && ["mp3", "wav", "flac", "ogg", "m4a"].includes(arg)) {
             format = arg as "flac" | "mp3" | "wav" | "ogg" | "m4a";
           } else if (arg === "true") {
             upload = true;
-          } else {
+          } else if (arg) {
             tags.push(arg);
           }
         }
@@ -246,11 +262,11 @@ environment:
 
         for (let i = 1; i < args.length; i++) {
           const arg = args[i];
-          if (["mp3", "wav", "flac", "ogg", "m4a"].includes(arg)) {
+          if (arg && ["mp3", "wav", "flac", "ogg", "m4a"].includes(arg)) {
             format = arg as "flac" | "mp3" | "wav" | "ogg" | "m4a";
           } else if (arg === "true") {
             upload = true;
-          } else {
+          } else if (arg) {
             tags.push(arg);
           }
         }
@@ -293,4 +309,3 @@ environment:
 if (import.meta.main) {
   cli();
 }
-

package/tsconfig.json

@@ -3,7 +3,7 @@
     // Environment setup & latest features
     "lib": ["ESNext"],
     "target": "ESNext",
-    "module": "Preserve",
+    "module": "ESNext",
     "moduleDetection": "force",
     "jsx": "react-jsx",
     "allowJs": true,

package/utilities/s3.ts

@@ -80,10 +80,10 @@ export function getPublicUrl(objectKey: string): string {
   const endpoint = process.env.CLOUDFLARE_R2_API_URL || "";
 
   if (endpoint.includes("localhost")) {
-    return `${endpoint}/${BUCKET}/${objectKey}`;
+    return `${endpoint}/${objectKey}`;
   }
 
-  return `http://s3.varg.ai/${BUCKET}/${objectKey}`;
+  return `https://s3.varg.ai/${objectKey}`;
 }
 
 // cli runner

package/HIGGSFIELD_REWRITE_SUMMARY.md

@@ -1,300 +0,0 @@
-# Higgsfield API Rewrite Summary
-
-## Overview
-
-Successfully rewrote the Higgsfield API wrapper from using `@higgsfield/client` library to direct HTTP requests using the native `fetch()` API.
-
-## Changes Made
-
-### New Files Created
-
-1. **`lib/higgsfield/index.ts`** - Base HTTP client
-   - `HiggsfieldClient` class with queue management
-   - Submit requests, check status, cancel requests
-   - Automatic polling with status updates
-   - Webhook support
-   - Type-safe responses
-
-2. **`lib/higgsfield/soul.ts`** - Soul model implementation
-   - `SoulClient` extending base client
-   - `generateSoul()` convenience function
-   - `listSoulStyles()` function
-   - CLI runner with full features
-   - Soul-specific types and constants
-
-3. **`lib/higgsfield/README.md`** - Comprehensive documentation
-   - Usage examples
-   - API reference
-   - Best practices
-   - Webhook integration guide
-
-4. **`lib/higgsfield/MIGRATION.md`** - Migration guide
-   - Before/after comparisons
-   - Breaking changes checklist
-   - Common patterns
-   - Rollback plan
-
-5. **`lib/higgsfield/example.ts`** - Working examples
-   - 6 different usage patterns
-   - Simple generation
-   - Style usage
-   - Queue management
-   - Webhook integration
-   - Batch generation
-   - Error handling
-
-### Files Modified
-
-1. **`lib/higgsfield.ts`** - Backward compatible wrapper
-   - Re-exports new implementation
-   - Legacy function support
-   - Same CLI commands work
-
-2. **`service/image/index.ts`** - Updated to new API
-   - Changed response structure access
-   - Added status checking
-   - Updated parameter names
-
-3. **`package.json`** - Removed dependency
-   - Removed `@higgsfield/client@^0.1.2`
-   - Cleaner dependencies
-
-4. **`lib/README.md`** - Updated documentation
-   - New Higgsfield section
-   - HTTP-based approach
-   - Migration notes
-
-## Architecture
-
-```
-lib/higgsfield/
-├── index.ts           # Base HiggsfieldClient class
-├── soul.ts            # Soul model-specific implementation
-├── example.ts         # Usage examples
-├── README.md          # Full documentation
-└── MIGRATION.md       # Migration guide
-
-lib/higgsfield.ts      # Backward-compatible wrapper
-```
-
-## Key Features
-
-### Core Functionality
-- ✅ Direct HTTP requests (no client library)
-- ✅ Async queue pattern implementation
-- ✅ Submit requests
-- ✅ Check status
-- ✅ Cancel requests
-- ✅ Wait for completion with polling
-- ✅ Webhook support
-
-### Developer Experience
-- ✅ Full TypeScript types
-- ✅ Backward compatible API
-- ✅ CLI tools
-- ✅ Examples
-- ✅ Documentation
-- ✅ Migration guide
-
-### Production Ready
-- ✅ Error handling
-- ✅ Status validation
-- ✅ Timeout support
-- ✅ Webhook retries
-- ✅ Idempotent operations
-
-## API Comparison
-
-### Old Implementation
-```typescript
-import { HiggsfieldClient } from "@higgsfield/client";
-
-const client = new HiggsfieldClient({ apiKey, apiSecret });
-const jobSet = await client.generate("/v1/text2image/soul", params);
-const url = jobSet.jobs[0].results.raw.url;
-```
-
-### New Implementation
-```typescript
-import { generateSoul } from "./lib/higgsfield/soul";
-
-const result = await generateSoul(params);
-const url = result.images[0].url;
-```
-
-## Request/Response Flow
-
-### 1. Submit Request
-```
-POST https://platform.higgsfield.ai/soul
-Authorization: Key {api_key}:{api_secret}
-
-Response:
-{
-  "status": "queued",
-  "request_id": "uuid",
-  "status_url": "...",
-  "cancel_url": "..."
-}
-```
-
-### 2. Poll Status
-```
-GET https://platform.higgsfield.ai/requests/{id}/status
-Authorization: Key {api_key}:{api_secret}
-
-Response:
-{
-  "status": "completed",
-  "request_id": "uuid",
-  "images": [{ "url": "..." }]
-}
-```
-
-### 3. Cancel (Optional)
-```
-POST https://platform.higgsfield.ai/requests/{id}/cancel
-Authorization: Key {api_key}:{api_secret}
-
-Response: 202 Accepted (success) or 400 Bad Request
-```
-
-## Status States
-
-| Status | Description | Can Cancel? |
-|--------|-------------|-------------|
-| `queued` | Waiting in queue | ✅ Yes |
-| `in_progress` | Currently processing | ❌ No |
-| `completed` | Successfully finished | ❌ No |
-| `failed` | Error occurred | ❌ No |
-| `nsfw` | Content moderation failed | ❌ No |
-| `canceled` | Request was canceled | ❌ No |
-
-## Testing
-
-### Run Examples
-```bash
-# Simple generation
-bun run lib/higgsfield/example.ts simple
-
-# With styles
-bun run lib/higgsfield/example.ts style
-
-# All examples
-bun run lib/higgsfield/example.ts all
-```
-
-### CLI Testing
-```bash
-# Generate image
-bun run lib/higgsfield/soul.ts generate "beautiful sunset"
-
-# List styles
-bun run lib/higgsfield/soul.ts list_styles
-
-# Backward compatible
-bun run lib/higgsfield.ts generate_soul "beautiful sunset"
-```
-
-## Benefits
-
-### Technical
-- No external client library dependency
-- Direct HTTP control
-- Smaller bundle size
-- Better TypeScript types
-- Follows official API exactly
-
-### Functional
-- Webhook support for production
-- Cancel pending requests
-- Custom polling intervals
-- Status update callbacks
-- Better error messages
-
-### Developer
-- Comprehensive documentation
-- Working examples
-- Migration guide
-- Modular architecture
-- Easy to extend
-
-## Migration Path
-
-1. ✅ New HTTP implementation created
-2. ✅ Backward compatibility maintained
-3. ✅ Documentation provided
-4. ✅ Examples created
-5. ✅ Existing code updated (`service/image/index.ts`)
-6. ⏭️ Team can migrate gradually
-7. ⏭️ Remove `@higgsfield/client` dependency when ready
-
-## Backward Compatibility
-
-All existing commands still work:
-
-```bash
-# Old commands (still work)
-bun run lib/higgsfield.ts generate_soul "prompt"
-bun run lib/higgsfield.ts list_styles
-```
-
-The `lib/higgsfield.ts` file acts as a wrapper, re-exporting the new implementation while maintaining the old interface.
-
-## Next Steps
-
-1. **Test the implementation** with real API credentials
-2. **Update other services** that use Higgsfield (if any)
-3. **Run bun install** to remove unused dependency
-4. **Update .gitignore** if needed
-5. **Consider adding tests** for the HTTP client
-
-## Files Changed
-
-```
-✅ Created:
-  - lib/higgsfield/index.ts
-  - lib/higgsfield/soul.ts
-  - lib/higgsfield/README.md
-  - lib/higgsfield/MIGRATION.md
-  - lib/higgsfield/example.ts
-
-✅ Modified:
-  - lib/higgsfield.ts (backward compatible wrapper)
-  - service/image/index.ts (updated to new API)
-  - package.json (removed @higgsfield/client)
-  - lib/README.md (updated docs)
-
-✅ No breaking changes for existing code
-✅ All linter errors fixed
-✅ TypeScript types verified
-```
-
-## Success Criteria
-
-- ✅ Direct HTTP requests instead of client library
-- ✅ Matches official API documentation
-- ✅ Async queue pattern implemented
-- ✅ Webhook support added
-- ✅ Cancel requests functionality
-- ✅ Status polling with callbacks
-- ✅ Backward compatible
-- ✅ Comprehensive documentation
-- ✅ Working examples
-- ✅ No linter errors
-- ✅ TypeScript types
-- ✅ Migration guide
-
-## Conclusion
-
-The Higgsfield API wrapper has been successfully rewritten to use direct HTTP requests instead of the `@higgsfield/client` library. The new implementation:
-
-- Is more maintainable (no external client dependency)
-- Follows the official API exactly
-- Provides more features (webhooks, cancellation)
-- Maintains backward compatibility
-- Is well-documented with examples
-
-The migration can be done gradually, and all existing code continues to work without changes.
-
-

package/TEST_RESULTS.md

@@ -1,122 +0,0 @@
-# test results
-
-## ✅ both fal approaches working
-
-### approach 1: lib/ai-sdk/fal.ts (vercel ai sdk)
-
-```bash
-$ bun run lib/ai-sdk/fal.ts generate_image "futuristic spaceship" "fal-ai/flux/dev" "16:9"
-
-[ai-sdk/fal] generating image with fal-ai/flux/dev
-[ai-sdk/fal] prompt: futuristic spaceship interior
-[ai-sdk/fal] aspect ratio: 16:9
-[ai-sdk/fal] completed!
-
-image saved to: /tmp/fal-ai-sdk-1763772836608.png
-
-metadata:
-{
-  "images": [
-    {
-      "width": 1024,
-      "height": 576,
-      "contentType": "image/jpeg",
-      "nsfw": false
-    }
-  ]
-}
-```
-
-✅ benefits:
-- clean typed api
-- auto image save + open
-- aspect ratio support
-- consistent with other ai-sdk providers
-
-### approach 2: lib/fal.ts (fal client direct)
-
-```bash
-$ bun run lib/fal.ts generate_image "ancient temple ruins"
-
-[fal] generating image with fal-ai/flux-pro/v1.1
-[fal] prompt: ancient temple ruins at sunset
-[fal] processing...
-[fal] completed!
-
-{
-  "data": {
-    "images": [
-      {
-        "url": "https://v3b.fal.media/files/b/koala/L5LYGCHZ4aZ_CKZsmPbUe.jpg",
-        "width": 1024,
-        "height": 768,
-        "content_type": "image/jpeg"
-      }
-    ],
-    "seed": 2946158106
-  }
-}
-```
-
-✅ benefits:
-- full api access
-- queue updates
-- video support
-- custom parameters
-
-## cli tests ✅
-
-all help menus working:
-
-```bash
-bun run lib/ai-sdk/fal.ts                    # ✓
-bun run lib/fal.ts                            # ✓
-bun run lib/higgsfield.ts                     # ✓
-bun run service/image.ts                      # ✓
-bun run service/video.ts                      # ✓
-bun run utilities/s3.ts                       # ✓
-```
-
-## library imports ✅
-
-```typescript
-import { generateImage } from "./index"
-import * as aiSdkFal from "./index"
-
-// both approaches available
-```
-
-## actual generation tests ✅
-
-successfully generated and opened:
-- cyberpunk city (16:9, ai-sdk)
-- spaceship interior (16:9, ai-sdk)
-- temple ruins (4:3, fal client)
-- aurora borealis (4:3, fal client)
-
-all images ~15-20 seconds generation time
-
-## what works
-
-1. **dual fal implementations** - ai-sdk for simplicity, client for power ✓
-2. **all cli scripts executable** with proper help menus ✓
-3. **library imports functional** ✓
-4. **actual image generation working** ✓
-5. **automatic image opening** (ai-sdk version) ✓
-6. **queue progress updates** (fal client) ✓
-
-## file structure
-
-```
-lib/
-├── ai-sdk/
-│   └── fal.ts          # vercel ai sdk approach
-├── fal.ts              # fal client approach
-└── higgsfield.ts       # soul character generation
-```
-
-## recommendations
-
-- **use lib/ai-sdk/fal.ts** for standard image generation
-- **use lib/fal.ts** for video or advanced features
-- **use service/**.ts for high-level operations with s3 upload

package/output.txt

@@ -1 +0,0 @@
- Let's say I've just joined the Roark team as a marketer and I want to add a new article to the website to boost our SEO. The devs won't get to this task anytime soon, but thanks to YoloCode AI, I can take care of it myself. Any changes I make show up instantly on the right so I can see exactly how it looked in production before opening a pull request. So now I'm ready to submit and push this feature and here we go!