@happyrobot-ai/sdk 0.1.18 → 0.1.19

package/core/http.js

@@ -14,6 +14,19 @@ const DEFAULT_BASE_URL = exports.CLUSTER_URLS.us;
 const DEFAULT_TIMEOUT = 30_000;
 const DEFAULT_MAX_RETRIES = 2;
 const INITIAL_BACKOFF_MS = 500;
+function buildRequestBody(config) {
+    if (config.rawBody !== undefined) {
+        // Don't set Content-Type — let the runtime set it (with multipart boundary)
+        return { body: config.rawBody };
+    }
+    if (config.body !== undefined) {
+        return {
+            body: JSON.stringify(config.body),
+            contentType: "application/json",
+        };
+    }
+    return { body: undefined };
+}
 class HttpClient {
     apiKey;
     baseUrl;
@@ -67,8 +80,9 @@ class HttpClient {
             Accept: "application/json",
             ...config.headers,
         };
-        if (config.body !== undefined) {
-            headers["Content-Type"] = "application/json";
+        const { body: requestBody, contentType } = buildRequestBody(config);
+        if (contentType) {
+            headers["Content-Type"] = contentType;
         }
         let lastError;
         for (let attempt = 0; attempt <= maxRetries; attempt++) {
@@ -76,9 +90,7 @@ class HttpClient {
                 const response = await this.fetchWithTimeout(url, {
                     method: config.method,
                     headers,
-                    body: config.body !== undefined
-                        ? JSON.stringify(config.body)
-                        : undefined,
+                    body: requestBody,
                 }, timeout);
                 if (response.ok) {
                     if (response.status === 204) {

package/core/types.d.ts

@@ -22,6 +22,8 @@ export interface RequestConfig {
     query?: Record<string, string | number | boolean | undefined>;
     /** JSON request body. */
     body?: unknown;
+    /** Raw body (e.g. FormData for multipart). Skips JSON serialization and Content-Type. */
+    rawBody?: FormData | Blob | ReadableStream;
     /** Additional headers. */
     headers?: Record<string, string>;
     /** Override timeout for this request. */

package/helpers/trigger-and-wait-for-node-output.d.ts

@@ -3,6 +3,8 @@ import type { RunNodeOutput } from "../types/runs.types";
 export interface TriggerAndWaitForNodeOutputOptions {
     workflowId: string;
     payload?: Record<string, unknown>;
+    /** File to upload (sends as multipart/form-data instead of JSON). */
+    file?: Blob | File;
     environment?: "production" | "staging" | "development";
     nodePersistentId: string;
     timeoutMs?: number;

package/helpers/trigger-and-wait-for-node-output.js

@@ -17,8 +17,9 @@ const NODE_READY_STATUSES = new Set([
     "skipped",
 ]);
 async function triggerAndWaitForNodeOutput(client, options) {
-    const { workflowId, payload, environment = "production", nodePersistentId, timeoutMs = 300_000, pollIntervalMs = 2_000, } = options;
+    const { workflowId, payload, file, environment = "production", nodePersistentId, timeoutMs = 300_000, pollIntervalMs = 2_000, } = options;
     const triggerResponse = await client.workflows.triggerRun(workflowId, {
+        file,
         payload,
         environment,
     });

package/helpers/trigger-and-wait.d.ts

@@ -9,6 +9,8 @@ export interface TriggerAndWaitOptions {
     workflowId: string;
     /** Trigger payload. */
     payload?: Record<string, unknown>;
+    /** File to upload (sends as multipart/form-data instead of JSON). */
+    file?: Blob | File;
     /** Target environment. */
     environment?: "production" | "staging" | "development";
     /** Maximum time to wait in milliseconds. Defaults to 300_000 (5 min). */

package/helpers/trigger-and-wait.js

@@ -25,9 +25,10 @@ const TERMINAL_STATUSES = new Set([
  * ```
  */
 async function triggerAndWait(client, options) {
-    const { workflowId, payload, environment = "production", timeoutMs = 300_000, pollIntervalMs = 2_000, fetchSessions = true, } = options;
+    const { workflowId, payload, file, environment = "production", timeoutMs = 300_000, pollIntervalMs = 2_000, fetchSessions = true, } = options;
     // 1. Trigger the run
     const { run_id } = await client.workflows.triggerRun(workflowId, {
+        file,
         payload,
         environment,
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyrobot-ai/sdk",
-  "version": "0.1.18",
+  "version": "0.1.19",
   "description": "TypeScript SDK for the HappyRobot Public API",
   "main": "./index.js",
   "module": "./index.mjs",

package/resources/workflows.d.ts

@@ -17,7 +17,7 @@
  *   POST   /workflows/:workflow_id/runs
  */
 import type { HttpClient } from "../core/http";
-import type { WorkflowRunsQuery, PaginatedWorkflowRunsResponse, TriggerRunBody, TriggerRunResponse } from "../types/runs.types";
+import type { WorkflowRunsQuery, PaginatedWorkflowRunsResponse, TriggerRunBody, TriggerRunResponse, TriggerRunWithFileBody } from "../types/runs.types";
 import type { ListWorkflowsQuery, WorkflowListItem, PaginatedWorkflowsResponse, CreateWorkflowBody, CreateWorkflowResponse, WorkflowDetailResponse, UpdateWorkflowBody, UpdateWorkflowResponse, DuplicateWorkflowBody, DuplicateWorkflowResponse, ListTemplatesQuery, PaginatedTemplatesResponse, WorkflowPublishResponse, WorkflowUnpublishResponse, CancelRunsResponse, ListWorkflowVersionsQuery, PaginatedWorkflowVersionsResponse } from "../types/workflows.types";
 export declare class WorkflowsResource {
     private readonly http;
@@ -50,6 +50,7 @@ export declare class WorkflowsResource {
     listVersions(workflowId: string, query?: ListWorkflowVersionsQuery): Promise<PaginatedWorkflowVersionsResponse>;
     /** List runs for a workflow. */
     listRuns(workflowId: string, query?: WorkflowRunsQuery): Promise<PaginatedWorkflowRunsResponse>;
-    /** Trigger a run for a workflow. */
-    triggerRun(workflowId: string, body?: TriggerRunBody): Promise<TriggerRunResponse>;
+    /** Trigger a run for a workflow (JSON payload or file upload). */
+    triggerRun(workflowId: string, body?: TriggerRunBody | TriggerRunWithFileBody): Promise<TriggerRunResponse>;
+    private triggerRunWithFile;
 }

package/resources/workflows.js

@@ -121,14 +121,35 @@ class WorkflowsResource {
             query: query,
         });
     }
-    /** Trigger a run for a workflow. */
+    /** Trigger a run for a workflow (JSON payload or file upload). */
     async triggerRun(workflowId, body) {
+        const path = `/workflows/${encodeURIComponent(workflowId)}/runs`;
+        if (body && "file" in body && body.file) {
+            return this.triggerRunWithFile(path, body);
+        }
         return this.http.request({
             method: "POST",
-            path: `/workflows/${encodeURIComponent(workflowId)}/runs`,
+            path,
             body: body ?? {},
         });
     }
+    async triggerRunWithFile(path, body) {
+        const formData = new FormData();
+        formData.append("file", body.file);
+        if (body.payload) {
+            for (const [key, value] of Object.entries(body.payload)) {
+                if (value !== undefined && value !== null) {
+                    formData.append(key, typeof value === "string" ? value : JSON.stringify(value));
+                }
+            }
+        }
+        return this.http.request({
+            method: "POST",
+            path,
+            rawBody: formData,
+            query: { environment: body.environment ?? "production" },
+        });
+    }
 }
 exports.WorkflowsResource = WorkflowsResource;
 //# sourceMappingURL=workflows.js.map

package/types/runs.types.d.ts

@@ -3,10 +3,11 @@
  */
 import type { z } from "zod";
 import type { RunDetailSchema, MarkRunBodySchema, MarkRunResponseSchema, ListFlagsQuerySchema, PaginatedFlagsResponseSchema, FlagItemSchema, GetRunOutputResponseSchema, ListRunNodesQuerySchema, ListRunNodesResponseSchema, RunNodeOutputSchema } from "../../routes/runs/schemas";
-import type { WorkflowRunsQuerySchema, PaginatedWorkflowRunsResponseSchema, TriggerRunBodySchema, TriggerRunResponseSchema } from "../../routes/workflows/:workflow_id/runs/schemas";
+import type { WorkflowRunsQuerySchema, PaginatedWorkflowRunsResponseSchema, TriggerRunBodySchema, TriggerRunWithFileBodySchema, TriggerRunResponseSchema } from "../../routes/workflows/:workflow_id/runs/schemas";
 export type WorkflowRunsQuery = z.input<typeof WorkflowRunsQuerySchema>;
 export type PaginatedWorkflowRunsResponse = z.infer<typeof PaginatedWorkflowRunsResponseSchema>;
 export type TriggerRunBody = z.input<typeof TriggerRunBodySchema>;
+export type TriggerRunWithFileBody = z.input<typeof TriggerRunWithFileBodySchema>;
 export type TriggerRunResponse = z.infer<typeof TriggerRunResponseSchema>;
 export type RunDetail = z.infer<typeof RunDetailSchema>;
 export type MarkRunBody = z.input<typeof MarkRunBodySchema>;