@vargai/gateway 0.1.0

package/README.md

@@ -0,0 +1,170 @@
+# @vargai/gateway
+
+typescript client for varg gateway api — unified proxy over fal, elevenlabs, replicate, higgsfield.
+
+## installation
+
+```bash
+bun add @vargai/gateway
+```
+
+## usage
+
+```typescript
+import { VargClient } from "@vargai/gateway";
+
+const client = new VargClient({
+  apiKey: "varg_xxx",
+  baseUrl: "https://api.varg.ai/v1", // optional, defaults to this
+  providerKeys: {
+    // optional BYOK
+    fal: "fal_xxx",
+    elevenlabs: "el_xxx",
+  },
+});
+
+// generate video
+const videoJob = await client.createVideo({
+  model: "kling-v2.6",
+  prompt: "cat jumping over fence",
+  duration: 5,
+});
+
+// poll until complete
+const result = await client.waitForJob(videoJob.job_id);
+console.log(result.output?.url);
+
+// or check manually
+const job = await client.getJob(videoJob.job_id);
+if (job.status === "completed") {
+  console.log(job.output?.url);
+}
+```
+
+## api
+
+### `createVideo(params)`
+
+generate video. returns job reference.
+
+```typescript
+const job = await client.createVideo({
+  model: "kling-v2.6",
+  prompt: "warrior princess on cliff",
+  duration: 5,
+  aspect_ratio: "16:9",
+  files: [{ url: "https://s3.varg.ai/u/..." }], // optional reference images
+});
+```
+
+### `createImage(params)`
+
+generate image. returns job reference.
+
+```typescript
+const job = await client.createImage({
+  model: "flux-schnell",
+  prompt: "cyberpunk cityscape",
+  aspect_ratio: "16:9",
+});
+```
+
+### `createSpeech(params)`
+
+text-to-speech. returns job reference.
+
+```typescript
+const job = await client.createSpeech({
+  model: "eleven_turbo_v2_5",
+  text: "hello world",
+  voice: "rachel",
+});
+```
+
+### `createMusic(params)`
+
+generate music. returns job reference.
+
+```typescript
+const job = await client.createMusic({
+  model: "elevenlabs",
+  prompt: "epic orchestral theme",
+  duration: 30,
+});
+```
+
+### `uploadFile(file, mediaType)`
+
+upload file (image, video, audio). returns file reference.
+
+```typescript
+const file = Bun.file("./hero.png");
+const upload = await client.uploadFile(file, "image/png");
+console.log(upload.url); // use in files array
+```
+
+### `getJob(id)`
+
+get job status and output.
+
+```typescript
+const job = await client.getJob("job_a1b2c3");
+if (job.status === "completed") {
+  console.log(job.output?.url);
+}
+```
+
+### `waitForJob(id, opts?)`
+
+poll until job completes. returns final job.
+
+```typescript
+const job = await client.waitForJob("job_a1b2c3", {
+  pollIntervalMs: 2000, // default
+  maxAttempts: 150, // default (5 minutes)
+});
+```
+
+### `cancelJob(id)`
+
+cancel a running job.
+
+```typescript
+await client.cancelJob("job_a1b2c3");
+```
+
+## schemas
+
+all schemas are exported for validation:
+
+```typescript
+import {
+  VideoRequestSchema,
+  ImageRequestSchema,
+  SpeechRequestSchema,
+  MusicRequestSchema,
+  JobResponseSchema,
+  FileUploadResponseSchema,
+} from "@vargai/gateway";
+```
+
+## errors
+
+```typescript
+import { VargGatewayError } from "@vargai/gateway";
+
+try {
+  await client.createVideo({ model: "invalid", prompt: "test" });
+} catch (error) {
+  if (error instanceof VargGatewayError) {
+    console.log(error.message);
+    console.log(error.statusCode); // 400, 401, 404, 502, etc.
+    console.log(error.field); // validation error field
+    console.log(error.provider); // provider that failed
+  }
+}
+```
+
+## license
+
+mit

package/dist/client.d.ts

@@ -0,0 +1,38 @@
+import { type FileUploadResponse, type ImageRequest, type JobResponse, type MusicRequest, type SpeechRequest, type VideoRequest } from "./schemas.ts";
+export interface VargClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+    providerKeys?: {
+        fal?: string;
+        elevenlabs?: string;
+        higgsfield?: string;
+        replicate?: string;
+    };
+}
+export interface WaitForJobOptions {
+    pollIntervalMs?: number;
+    maxAttempts?: number;
+}
+export declare class VargGatewayError extends Error {
+    statusCode?: number | undefined;
+    field?: string | undefined;
+    provider?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, field?: string | undefined, provider?: string | undefined);
+}
+export declare class VargClient {
+    private apiKey;
+    private baseUrl;
+    private providerKeys;
+    constructor(config: VargClientConfig);
+    private getHeaders;
+    private handleResponse;
+    createVideo(params: VideoRequest): Promise<JobResponse>;
+    createImage(params: ImageRequest): Promise<JobResponse>;
+    createSpeech(params: SpeechRequest): Promise<JobResponse>;
+    createMusic(params: MusicRequest): Promise<JobResponse>;
+    uploadFile(file: Blob | Buffer, mediaType: string): Promise<FileUploadResponse>;
+    getJob(id: string): Promise<JobResponse>;
+    cancelJob(id: string): Promise<void>;
+    waitForJob(id: string, options?: WaitForJobOptions): Promise<JobResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,kBAAkB,EAEvB,KAAK,YAAY,EAEjB,KAAK,WAAW,EAEhB,KAAK,YAAY,EAEjB,KAAK,aAAa,EAElB,KAAK,YAAY,EAElB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IAGhC,UAAU,CAAC,EAAE,MAAM;IACnB,KAAK,CAAC,EAAE,MAAM;IACd,QAAQ,CAAC,EAAE,MAAM;gBAHxB,OAAO,EAAE,MAAM,EACR,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,QAAQ,CAAC,EAAE,MAAM,YAAA;CAK3B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAmC;gBAE3C,MAAM,EAAE,gBAAgB;IAMpC,OAAO,CAAC,UAAU;YAsBJ,cAAc;IAuBtB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAUvD,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAUvD,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC;IAUzD,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAUvD,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA2B/E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAQxC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;CAgBhF"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { VargClient, VargGatewayError } from "./client.ts";
+export type { VargClientConfig, WaitForJobOptions } from "./client.ts";
+export { createVarg } from "./provider.ts";
+export type { VargProvider } from "./provider.ts";
+export { ErrorResponseSchema, FileInputSchema, FileUploadResponseSchema, ImageRequestSchema, JobResponseSchema, JobStatusSchema, MusicRequestSchema, SpeechRequestSchema, VideoRequestSchema, } from "./schemas.ts";
+export type { ErrorResponse, FileInput, FileUploadResponse, ImageRequest, JobResponse, JobStatus, MusicRequest, SpeechRequest, VideoRequest, } from "./schemas.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,aAAa,EACb,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,GACb,MAAM,cAAc,CAAC"}