skapi-js 2.0.0-rc.2 → 2.0.0-rc.3

package/dist/skapi.d.mts

@@ -1248,6 +1248,31 @@ declare class Skapi {
         statusCode: number;
         url: string;
     }>(params: Params[] | Form<Params>, url?: string): Promise<Response | Response[]>;
+    /**
+     * Relays a request to a destination of your choosing from the server side,
+     * with the service api key added where the browser cannot read it, and
+     * streams the destination's response back as it arrives.
+     *
+     * The body is relayed verbatim, so an html form reaches the destination as the
+     * same multipart or urlencoded payload the browser would have sent, files
+     * included. Supply options.onStream to receive the response chunk by chunk.
+     *
+     * @param form Form element, submit event, FormData, or a plain object. Sent to the destination verbatim.
+     * @param options Destination url, method, headers, and an optional onStream callback.
+     * @returns A promise that resolves to the destination's response.
+     */
+    forwardRequest(form: any, options: {
+        url: string;
+        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD';
+        headers?: {
+            [key: string]: string;
+        };
+        apiKeyHeader?: string;
+        apiKeyScheme?: string;
+        onStream?: (chunk: string) => void;
+        signal?: AbortSignal;
+        responseType?: 'json' | 'text' | 'response';
+    }): Promise<any>;
     /**
      * Returns a normalized response object for form-based handler flows.
      * @returns A promise that resolves to Promise<any>.

package/dist/skapi.d.ts

@@ -1248,6 +1248,31 @@ declare class Skapi {
         statusCode: number;
         url: string;
     }>(params: Params[] | Form<Params>, url?: string): Promise<Response | Response[]>;
+    /**
+     * Relays a request to a destination of your choosing from the server side,
+     * with the service api key added where the browser cannot read it, and
+     * streams the destination's response back as it arrives.
+     *
+     * The body is relayed verbatim, so an html form reaches the destination as the
+     * same multipart or urlencoded payload the browser would have sent, files
+     * included. Supply options.onStream to receive the response chunk by chunk.
+     *
+     * @param form Form element, submit event, FormData, or a plain object. Sent to the destination verbatim.
+     * @param options Destination url, method, headers, and an optional onStream callback.
+     * @returns A promise that resolves to the destination's response.
+     */
+    forwardRequest(form: any, options: {
+        url: string;
+        method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD';
+        headers?: {
+            [key: string]: string;
+        };
+        apiKeyHeader?: string;
+        apiKeyScheme?: string;
+        onStream?: (chunk: string) => void;
+        signal?: AbortSignal;
+        responseType?: 'json' | 'text' | 'response';
+    }): Promise<any>;
     /**
      * Returns a normalized response object for form-based handler flows.
      * @returns A promise that resolves to Promise<any>.