@orbytautomation/engine 0.1.0

package/dist/adapters/builtins/HTTPAdapter.d.ts

@@ -0,0 +1,58 @@
+/**
+ * HTTP Adapter
+ *
+ * Executes HTTP requests.
+ *
+ * Supported actions:
+ *   - http.request.get
+ *   - http.request.post
+ *   - http.request.put
+ *   - http.request.patch
+ *   - http.request.delete
+ *   - http.request.head
+ *   - http.request.options
+ *
+ * @module adapters/builtins
+ */
+import { BaseAdapter, type AdapterContext, type AdapterResult } from '@dev-ecosystem/core';
+/**
+ * HTTP adapter for making HTTP requests
+ */
+export declare class HTTPAdapter extends BaseAdapter {
+    readonly name = "http";
+    readonly version = "1.0.0";
+    readonly description = "HTTP request adapter";
+    readonly supportedActions: string[];
+    readonly capabilities: {
+        actions: string[];
+        concurrent: boolean;
+        cacheable: boolean;
+        idempotent: boolean;
+        resources: {
+            network: boolean;
+        };
+        cost: "low";
+    };
+    execute(action: string, input: Record<string, any>, context: AdapterContext): Promise<AdapterResult>;
+    /**
+     * Extract HTTP method from action
+     */
+    private extractMethod;
+    /**
+     * Build fetch request options
+     */
+    private buildRequestOptions;
+    /**
+     * Build request headers
+     */
+    private buildHeaders;
+    /**
+     * Serialize request body
+     */
+    private serializeBody;
+    /**
+     * Parse response body based on content type
+     */
+    private parseResponseBody;
+}
+//# sourceMappingURL=HTTPAdapter.d.ts.map

package/dist/adapters/builtins/HTTPAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/builtins/HTTPAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAwB,MAAM,qBAAqB,CAAC;AAcjH;;GAEG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,0BAA0B;IAC9C,QAAQ,CAAC,gBAAgB,WAAsB;IAC/C,QAAQ,CAAC,YAAY;;;;;;;;;MASnB;IAEI,OAAO,CACX,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC1B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC;IAoFzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;IACH,OAAO,CAAC,YAAY;IA2BpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;YACW,iBAAiB;CAgChC"}

package/dist/adapters/builtins/HTTPAdapter.js

@@ -0,0 +1,213 @@
+/**
+ * HTTP Adapter
+ *
+ * Executes HTTP requests.
+ *
+ * Supported actions:
+ *   - http.request.get
+ *   - http.request.post
+ *   - http.request.put
+ *   - http.request.patch
+ *   - http.request.delete
+ *   - http.request.head
+ *   - http.request.options
+ *
+ * @module adapters/builtins
+ */
+import { BaseAdapter, AdapterResultBuilder } from '@dev-ecosystem/core';
+/**
+ * HTTP adapter for making HTTP requests
+ */
+export class HTTPAdapter extends BaseAdapter {
+    name = 'http';
+    version = '1.0.0';
+    description = 'HTTP request adapter';
+    supportedActions = ['http.request.*'];
+    capabilities = {
+        actions: ['http.request.get', 'http.request.post', 'http.request.put', 'http.request.patch', 'http.request.delete', 'http.request.head', 'http.request.options'],
+        concurrent: true,
+        cacheable: true, // GET requests especially
+        idempotent: false, // Depends on HTTP method
+        resources: {
+            network: true,
+        },
+        cost: 'low',
+    };
+    async execute(action, input, context) {
+        // Validate required inputs
+        this.validateInput(input, ['url']);
+        // Extract method from action (http.request.get -> GET)
+        const method = this.extractMethod(action);
+        // Build request options
+        const requestOptions = this.buildRequestOptions(method, input);
+        // Execute request
+        const startTime = Date.now();
+        try {
+            const response = await fetch(input.url, requestOptions);
+            const duration = Date.now() - startTime;
+            // Parse response body
+            const body = await this.parseResponseBody(response, input);
+            // Convert headers to plain object
+            const headers = {};
+            response.headers.forEach((value, key) => {
+                headers[key] = value;
+            });
+            // Build HTTPResponse (use the interface)
+            const httpResponse = {
+                status: response.status,
+                statusText: response.statusText,
+                headers,
+                body,
+                url: response.url,
+                duration,
+            };
+            // Log request
+            context.log(`HTTP ${method} ${input.url} -> ${response.status} (${duration}ms)`);
+            // Convert to AdapterResult
+            const builder = new AdapterResultBuilder()
+                .duration(duration)
+                .log(`HTTP ${method} ${input.url}`);
+            if (response.ok) {
+                builder
+                    .success(httpResponse)
+                    .effect('network:request');
+            }
+            else {
+                builder.failure({
+                    message: `HTTP request failed: ${response.status} ${response.statusText}`,
+                    code: response.status.toString(),
+                    details: httpResponse,
+                });
+                // Check if we should throw on error status
+                const throwOnError = this.getInput(input, 'throwOnError', true);
+                if (throwOnError) {
+                    const builtResult = builder.build();
+                    throw new Error(builtResult.error.message);
+                }
+            }
+            return builder.build();
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            context.log(`HTTP ${method} ${input.url} failed after ${duration}ms: ${error}`, 'error');
+            return new AdapterResultBuilder()
+                .duration(duration)
+                .failure({
+                message: error.message,
+                stack: error.stack,
+            })
+                .log(`HTTP request error: ${error.message}`)
+                .build();
+        }
+    }
+    /**
+     * Extract HTTP method from action
+     */
+    extractMethod(action) {
+        const parts = action.split('.');
+        const method = parts[parts.length - 1];
+        return method.toUpperCase();
+    }
+    /**
+     * Build fetch request options
+     */
+    buildRequestOptions(method, input) {
+        const options = {
+            method,
+            headers: this.buildHeaders(input),
+        };
+        // Add body for POST, PUT, PATCH
+        if (['POST', 'PUT', 'PATCH'].includes(method)) {
+            if (input.body) {
+                options.body = this.serializeBody(input.body, input.headers);
+            }
+            else if (input.json) {
+                options.body = JSON.stringify(input.json);
+            }
+            else if (input.form) {
+                options.body = new URLSearchParams(input.form).toString();
+            }
+        }
+        // Add other options
+        if (input.mode)
+            options.mode = input.mode;
+        if (input.credentials)
+            options.credentials = input.credentials;
+        if (input.cache)
+            options.cache = input.cache;
+        if (input.redirect)
+            options.redirect = input.redirect;
+        if (input.referrer)
+            options.referrer = input.referrer;
+        if (input.integrity)
+            options.integrity = input.integrity;
+        return options;
+    }
+    /**
+     * Build request headers
+     */
+    buildHeaders(input) {
+        const headers = input.headers || {};
+        // Auto-set Content-Type if not provided
+        if (input.json && !headers['Content-Type']) {
+            headers['Content-Type'] = 'application/json';
+        }
+        if (input.form && !headers['Content-Type']) {
+            headers['Content-Type'] = 'application/x-www-form-urlencoded';
+        }
+        // Add auth header if provided
+        if (input.auth) {
+            if (input.auth.bearer) {
+                headers['Authorization'] = `Bearer ${input.auth.bearer}`;
+            }
+            else if (input.auth.basic) {
+                const encoded = btoa(`${input.auth.basic.username}:${input.auth.basic.password}`);
+                headers['Authorization'] = `Basic ${encoded}`;
+            }
+        }
+        return headers;
+    }
+    /**
+     * Serialize request body
+     */
+    serializeBody(body, headers) {
+        const contentType = headers?.['Content-Type'] || headers?.['content-type'];
+        if (contentType?.includes('application/json')) {
+            return JSON.stringify(body);
+        }
+        if (typeof body === 'string') {
+            return body;
+        }
+        return JSON.stringify(body);
+    }
+    /**
+     * Parse response body based on content type
+     */
+    async parseResponseBody(response, input) {
+        const responseType = this.getInput(input, 'responseType', 'auto');
+        const contentType = response.headers.get('content-type') || '';
+        // Explicit response type
+        if (responseType === 'json') {
+            return response.json();
+        }
+        if (responseType === 'text') {
+            return response.text();
+        }
+        if (responseType === 'blob') {
+            return response.blob();
+        }
+        if (responseType === 'arrayBuffer') {
+            return response.arrayBuffer();
+        }
+        // Auto-detect from content-type
+        if (contentType.includes('application/json')) {
+            return response.json();
+        }
+        if (contentType.includes('text/')) {
+            return response.text();
+        }
+        // Default to text
+        return response.text();
+    }
+}
+//# sourceMappingURL=HTTPAdapter.js.map

package/dist/adapters/builtins/HTTPAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPAdapter.js","sourceRoot":"","sources":["../../../src/adapters/builtins/HTTPAdapter.ts"],"names":[],"mappings":"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"}

package/dist/adapters/builtins/HTTPRequestBuilder.d.ts

@@ -0,0 +1,95 @@
+/**
+ * HTTP Request Builder
+ *
+ * Fluent builder for constructing HTTP requests.
+ */
+export interface HTTPRequestOptions {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeout?: number;
+    retries?: number;
+    signal?: AbortSignal;
+}
+export declare class HTTPRequestBuilder {
+    private options;
+    constructor();
+    /**
+     * Set HTTP method
+     */
+    method(method: string): this;
+    /**
+     * Set URL
+     */
+    url(url: string): this;
+    /**
+     * Set a header
+     */
+    header(name: string, value: string): this;
+    /**
+     * Set multiple headers
+     */
+    headers(headers: Record<string, string>): this;
+    /**
+     * Set request body
+     */
+    body(body: unknown): this;
+    /**
+     * Set JSON body and Content-Type header
+     */
+    json(data: unknown): this;
+    /**
+     * Set form data body
+     */
+    form(data: Record<string, string>): this;
+    /**
+     * Set timeout
+     */
+    timeout(ms: number): this;
+    /**
+     * Set retry count
+     */
+    retries(count: number): this;
+    /**
+     * Set abort signal
+     */
+    signal(signal: AbortSignal): this;
+    /**
+     * Set Bearer token authentication
+     */
+    bearerAuth(token: string): this;
+    /**
+     * Set Basic authentication
+     */
+    basicAuth(username: string, password: string): this;
+    /**
+     * Add query parameters
+     */
+    query(params: Record<string, string | number | boolean>): this;
+    /**
+     * Build the request options
+     */
+    build(): HTTPRequestOptions;
+    /**
+     * Create a GET request builder
+     */
+    static get(url: string): HTTPRequestBuilder;
+    /**
+     * Create a POST request builder
+     */
+    static post(url: string): HTTPRequestBuilder;
+    /**
+     * Create a PUT request builder
+     */
+    static put(url: string): HTTPRequestBuilder;
+    /**
+     * Create a PATCH request builder
+     */
+    static patch(url: string): HTTPRequestBuilder;
+    /**
+     * Create a DELETE request builder
+     */
+    static delete(url: string): HTTPRequestBuilder;
+}
+//# sourceMappingURL=HTTPRequestBuilder.d.ts.map

package/dist/adapters/builtins/HTTPRequestBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPRequestBuilder.d.ts","sourceRoot":"","sources":["../../../src/adapters/builtins/HTTPRequestBuilder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA8B;;IAS7C;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKtB;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAQzC;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK9C;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAKzB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAMzB;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAOxC;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK5B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAKjC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMnD;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI;IAa9D;;OAEG;IACH,KAAK,IAAI,kBAAkB;IAQ3B;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB;IAI3C;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB;IAI5C;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB;IAI3C;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB;IAI7C;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB;CAG/C"}

package/dist/adapters/builtins/HTTPRequestBuilder.js

@@ -0,0 +1,159 @@
+/**
+ * HTTP Request Builder
+ *
+ * Fluent builder for constructing HTTP requests.
+ */
+export class HTTPRequestBuilder {
+    options;
+    constructor() {
+        this.options = {
+            method: 'GET',
+            headers: {},
+        };
+    }
+    /**
+     * Set HTTP method
+     */
+    method(method) {
+        this.options.method = method.toUpperCase();
+        return this;
+    }
+    /**
+     * Set URL
+     */
+    url(url) {
+        this.options.url = url;
+        return this;
+    }
+    /**
+     * Set a header
+     */
+    header(name, value) {
+        if (!this.options.headers) {
+            this.options.headers = {};
+        }
+        this.options.headers[name] = value;
+        return this;
+    }
+    /**
+     * Set multiple headers
+     */
+    headers(headers) {
+        this.options.headers = { ...this.options.headers, ...headers };
+        return this;
+    }
+    /**
+     * Set request body
+     */
+    body(body) {
+        this.options.body = body;
+        return this;
+    }
+    /**
+     * Set JSON body and Content-Type header
+     */
+    json(data) {
+        this.options.body = JSON.stringify(data);
+        this.header('Content-Type', 'application/json');
+        return this;
+    }
+    /**
+     * Set form data body
+     */
+    form(data) {
+        const params = new URLSearchParams(data);
+        this.options.body = params.toString();
+        this.header('Content-Type', 'application/x-www-form-urlencoded');
+        return this;
+    }
+    /**
+     * Set timeout
+     */
+    timeout(ms) {
+        this.options.timeout = ms;
+        return this;
+    }
+    /**
+     * Set retry count
+     */
+    retries(count) {
+        this.options.retries = count;
+        return this;
+    }
+    /**
+     * Set abort signal
+     */
+    signal(signal) {
+        this.options.signal = signal;
+        return this;
+    }
+    /**
+     * Set Bearer token authentication
+     */
+    bearerAuth(token) {
+        this.header('Authorization', `Bearer ${token}`);
+        return this;
+    }
+    /**
+     * Set Basic authentication
+     */
+    basicAuth(username, password) {
+        const credentials = Buffer.from(`${username}:${password}`).toString('base64');
+        this.header('Authorization', `Basic ${credentials}`);
+        return this;
+    }
+    /**
+     * Add query parameters
+     */
+    query(params) {
+        if (!this.options.url) {
+            throw new Error('URL must be set before adding query parameters');
+        }
+        const url = new URL(this.options.url);
+        for (const [key, value] of Object.entries(params)) {
+            url.searchParams.append(key, String(value));
+        }
+        this.options.url = url.toString();
+        return this;
+    }
+    /**
+     * Build the request options
+     */
+    build() {
+        if (!this.options.url) {
+            throw new Error('URL is required');
+        }
+        return this.options;
+    }
+    /**
+     * Create a GET request builder
+     */
+    static get(url) {
+        return new HTTPRequestBuilder().method('GET').url(url);
+    }
+    /**
+     * Create a POST request builder
+     */
+    static post(url) {
+        return new HTTPRequestBuilder().method('POST').url(url);
+    }
+    /**
+     * Create a PUT request builder
+     */
+    static put(url) {
+        return new HTTPRequestBuilder().method('PUT').url(url);
+    }
+    /**
+     * Create a PATCH request builder
+     */
+    static patch(url) {
+        return new HTTPRequestBuilder().method('PATCH').url(url);
+    }
+    /**
+     * Create a DELETE request builder
+     */
+    static delete(url) {
+        return new HTTPRequestBuilder().method('DELETE').url(url);
+    }
+}
+//# sourceMappingURL=HTTPRequestBuilder.js.map

package/dist/adapters/builtins/HTTPRequestBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPRequestBuilder.js","sourceRoot":"","sources":["../../../src/adapters/builtins/HTTPRequestBuilder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,MAAM,OAAO,kBAAkB;IACrB,OAAO,CAA8B;IAE7C;QACE,IAAI,CAAC,OAAO,GAAG;YACb,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAY,EAAE,KAAa;QAChC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,OAA+B;QACrC,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC;QAC/D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAa;QAChB,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAAa;QAChB,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,IAA4B;QAC/B,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,mCAAmC,CAAC,CAAC;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,EAAU;QAChB,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAa;QACnB,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAmB;QACxB,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAa;QACtB,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,UAAU,KAAK,EAAE,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,QAAgB,EAAE,QAAgB;QAC1C,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,IAAI,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,SAAS,WAAW,EAAE,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAiD;QACrD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACrC,CAAC;QAED,OAAO,IAAI,CAAC,OAA6B,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,kBAAkB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,GAAW;QACrB,OAAO,IAAI,kBAAkB,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,kBAAkB,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAW;QACtB,OAAO,IAAI,kBAAkB,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,GAAW;QACvB,OAAO,IAAI,kBAAkB,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/adapters/builtins/HTTPResponseParser.d.ts

@@ -0,0 +1,74 @@
+/**
+ * HTTP Response Parser
+ *
+ * Parses HTTP responses and extracts structured data.
+ */
+export interface ParsedHTTPResponse<T = unknown> {
+    /**
+     * Parsed data
+     */
+    data: T;
+    /**
+     * Response status code
+     */
+    status: number;
+    /**
+     * Response headers
+     */
+    headers: Record<string, string>;
+    /**
+     * Content type
+     */
+    contentType?: string;
+    /**
+     * Parse errors (if any)
+     */
+    errors?: string[];
+}
+export declare class HTTPResponseParser {
+    /**
+     * Parse response based on Content-Type
+     */
+    static parseAuto(response: Response): Promise<ParsedHTTPResponse>;
+    /**
+     * Parse JSON response
+     */
+    static parseJSON<T = unknown>(response: Response, headers?: Record<string, string>): Promise<ParsedHTTPResponse<T>>;
+    /**
+     * Parse text response
+     */
+    static parseText(response: Response, headers?: Record<string, string>): Promise<ParsedHTTPResponse<string>>;
+    /**
+     * Parse binary response (returns base64-encoded string)
+     */
+    static parseBinary(response: Response, headers?: Record<string, string>): Promise<ParsedHTTPResponse<string>>;
+    /**
+     * Parse form data response
+     */
+    static parseFormData(response: Response, headers?: Record<string, string>): Promise<ParsedHTTPResponse<Record<string, string>>>;
+    /**
+     * Extract headers from response
+     */
+    private static extractHeaders;
+    /**
+     * Check if response is successful (2xx status)
+     */
+    static isSuccess(response: Response): boolean;
+    /**
+     * Check if response is a redirect (3xx status)
+     */
+    static isRedirect(response: Response): boolean;
+    /**
+     * Check if response is a client error (4xx status)
+     */
+    static isClientError(response: Response): boolean;
+    /**
+     * Check if response is a server error (5xx status)
+     */
+    static isServerError(response: Response): boolean;
+    /**
+     * Get response status text
+     */
+    static getStatusText(status: number): string;
+}
+//# sourceMappingURL=HTTPResponseParser.d.ts.map

package/dist/adapters/builtins/HTTPResponseParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HTTPResponseParser.d.ts","sourceRoot":"","sources":["../../../src/adapters/builtins/HTTPResponseParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC;IAER;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,qBAAa,kBAAkB;IAC7B;;OAEG;WACU,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAevE;;OAEG;WACU,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAoBzH;;OAEG;WACU,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAYjH;;OAEG;WACU,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAanH;;OAEG;WACU,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAiBrI;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAU7B;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAI7C;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAI9C;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAIjD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAIjD;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAgB7C"}