@telorun/http-client 0.1.1 → 0.1.2

package/dist/http-request-controller.d.ts

@@ -1,25 +1,30 @@
+import { Readable } from "stream";
 import type { ResourceContext, ResourceInstance } from "@telorun/sdk";
 interface TeloResponse {
     status: number;
     headers: Record<string, string>;
     body: unknown;
 }
-interface HttpRequestManifest {
-    client?: string;
+interface HttpRequestInputs {
     url: string;
     method?: string;
     query?: Record<string, string>;
     headers?: Record<string, string>;
     body?: string | Record<string, unknown>;
+}
+interface HttpRequestManifest extends HttpRequestInputs {
+    client?: string;
     timeout?: number;
     throwOnHttpError?: boolean;
     retries?: number;
+    mode?: "buffer" | "stream";
+    inputs?: HttpRequestInputs;
 }
 declare class HttpRequestResource implements ResourceInstance {
     private readonly manifest;
     private readonly ctx;
     constructor(manifest: HttpRequestManifest, ctx: ResourceContext);
-    invoke(input: any): Promise<TeloResponse>;
+    invoke(input: any): Promise<TeloResponse | Readable>;
 }
 export declare function register(): void;
 export declare function create(resource: HttpRequestManifest, ctx: ResourceContext): Promise<HttpRequestResource>;

package/dist/http-request-controller.js

@@ -1,3 +1,4 @@
+import { PassThrough } from "stream";
 const MAX_REDIRECTS = 5;
 const DEFAULT_TIMEOUT = 10000;
 function createNetworkError(code, message, url) {
@@ -37,7 +38,7 @@ function normalizeHeaders(headers) {
     }
     return result;
 }
-async function executeRequest(url, method, headers, body, timeout) {
+async function executeRequest(url, method, headers, body, timeout, stream = false) {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeout);
     let currentUrl = url;
@@ -71,6 +72,34 @@ async function executeRequest(url, method, headers, body, timeout) {
             response.headers.forEach((value, key) => {
                 responseHeaders[key.toLowerCase()] = value;
             });
+            // Stream mode: pump body into a PassThrough eagerly so data flows immediately
+            if (stream) {
+                const webStream = response.body;
+                const body = new PassThrough();
+                (async () => {
+                    if (!webStream) {
+                        body.end();
+                        return;
+                    }
+                    const reader = webStream.getReader();
+                    try {
+                        while (true) {
+                            const { done, value } = await reader.read();
+                            if (done)
+                                break;
+                            body.push(Buffer.from(value));
+                        }
+                        body.end();
+                    }
+                    catch (err) {
+                        body.destroy(err);
+                    }
+                    finally {
+                        reader.releaseLock();
+                    }
+                })();
+                return { status: response.status, headers: responseHeaders, body };
+            }
             // Deserialize body
             const contentType = responseHeaders["content-type"] ?? "";
             let responseBody;
@@ -91,13 +120,13 @@ async function executeRequest(url, method, headers, body, timeout) {
         clearTimeout(timeoutId);
     }
 }
-async function executeWithRetry(url, method, headers, body, timeout, retriesLeft) {
+async function executeWithRetry(url, method, headers, body, timeout, retriesLeft, stream = false) {
     try {
-        return await executeRequest(url, method, headers, body, timeout);
+        return await executeRequest(url, method, headers, body, timeout, stream);
     }
     catch (err) {
         if (retriesLeft > 0 && err.error === "NetworkError") {
-            return executeWithRetry(url, method, headers, body, timeout, retriesLeft - 1);
+            return executeWithRetry(url, method, headers, body, timeout, retriesLeft - 1, stream);
         }
         throw err;
     }
@@ -126,12 +155,22 @@ class HttpRequestResource {
             clientHeaders = normalizeHeaders(client.headers ?? {});
             clientTimeout = client.timeout ?? DEFAULT_TIMEOUT;
         }
-        // Expand template fields
-        const rawUrl = ctx.expandValue(m.url, input ?? {});
-        const method = (ctx.expandValue(m.method ?? "GET", input ?? {}) || "GET").toUpperCase();
-        const requestHeaders = normalizeHeaders(ctx.expandValue(m.headers ?? {}, input ?? {}) ?? {});
-        const query = ctx.expandValue(m.query ?? {}, input ?? {}) ?? {};
-        const body = m.body !== undefined ? ctx.expandValue(m.body, input ?? {}) : undefined;
+        // Expand template fields from manifest.inputs using runtime input as context
+        // Manifest-level fields (url, method, etc.) serve as defaults when inputs is absent
+        const manifestInputs = {
+            url: m.url,
+            method: m.method,
+            query: m.query,
+            headers: m.headers,
+            body: m.body,
+            ...m.inputs,
+        };
+        const resolved = ctx.expandValue(manifestInputs, input ?? {});
+        const rawUrl = resolved.url;
+        const method = ((resolved.method ?? "GET") || "GET").toUpperCase();
+        const requestHeaders = normalizeHeaders((resolved.headers ?? {}));
+        const query = (resolved.query ?? {});
+        const body = resolved.body;
         const effectiveTimeout = m.timeout ?? clientTimeout;
         const retries = m.retries ?? 0;
         const throwOnHttpError = m.throwOnHttpError ?? false;
@@ -166,10 +205,13 @@ class HttpRequestResource {
                 serializedBody = String(body);
             }
         }
-        const response = await executeWithRetry(fullUrl, method, mergedHeaders, serializedBody, effectiveTimeout, retries);
+        const response = await executeWithRetry(fullUrl, method, mergedHeaders, serializedBody, effectiveTimeout, retries, m.mode === "stream");
         if (throwOnHttpError && response.status >= 400) {
             throw new Error(`HTTP ${response.status} error from ${fullUrl}`);
         }
+        if (m.mode === "stream") {
+            return response.body;
+        }
         return response;
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telorun/http-client",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "type": "module",
   "exports": {
     "./http-client": {
@@ -16,7 +16,7 @@
     "dist/**"
   ],
   "dependencies": {
-    "@telorun/sdk": "0.2.5"
+    "@telorun/sdk": "0.2.6"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",