@qimen-lab/core 0.1.1

package/dist/http/HttpClient.esm.js

@@ -0,0 +1,123 @@
+/**
+ * HttpClient 类
+ *
+ * 提供简单的 HTTP 请求接口
+ * - 内部构建 RequestContext
+ * - 调用 HttpExecutor 执行请求
+ * - 保持简单的 API
+ */
+import { RequestContextBuilder } from '@qimenjs/context';
+import { HttpExecutor } from './HttpExecutor';
+/**
+ * HttpClient 类
+ */
+export class HttpClient {
+    /**
+     * 构造函数
+     *
+     * @param domain - 域名
+     */
+    constructor(domain = 'default') {
+        this.domain = domain;
+        this.executor = new HttpExecutor();
+    }
+    /**
+     * 构建 RequestContext
+     */
+    buildContext(method, url, options = {}) {
+        let builder = RequestContextBuilder.create()
+            .withDomain(this.domain)
+            .withUrl(url)
+            .withMethod(method);
+        if (options.headers) {
+            builder = builder.withHeaders(options.headers);
+        }
+        if (options.body !== undefined) {
+            builder = builder.withBody(options.body);
+        }
+        if (options.queryParams) {
+            builder = builder.withQueryParams(options.queryParams);
+        }
+        const context = builder.build();
+        // 存储额外的选项到 metadata
+        if (options.timeout) {
+            context.metadata.timeout = options.timeout;
+        }
+        if (options.onProgress) {
+            context.metadata.onProgress = options.onProgress;
+        }
+        return context;
+    }
+    /**
+     * 发送请求
+     */
+    request(method, url, options = {}) {
+        // 构建 RequestContext
+        const context = this.buildContext(method, url, options);
+        // 创建可取消的任务
+        const task = this.executor.createTask(context);
+        return {
+            context: task.promise.then(result => result.context),
+            cancel: task.cancel,
+        };
+    }
+    /**
+     * GET 请求
+     */
+    get(url, options) {
+        return this.request('GET', url, options);
+    }
+    /**
+     * POST 请求
+     */
+    post(url, body, options) {
+        return this.request('POST', url, { ...options, body });
+    }
+    /**
+     * PUT 请求
+     */
+    put(url, body, options) {
+        return this.request('PUT', url, { ...options, body });
+    }
+    /**
+     * PATCH 请求
+     */
+    patch(url, body, options) {
+        return this.request('PATCH', url, { ...options, body });
+    }
+    /**
+     * DELETE 请求
+     */
+    delete(url, options) {
+        return this.request('DELETE', url, options);
+    }
+    /**
+     * 上传文件
+     *
+     * @param url - 请求 URL
+     * @param body - 请求体（通常是 FormData）
+     * @param onProgress - 进度回调
+     * @param options - 其他选项
+     */
+    upload(url, body, onProgress, options) {
+        return this.request('POST', url, {
+            ...options,
+            body,
+            onProgress,
+        });
+    }
+    /**
+     * 下载文件
+     *
+     * @param url - 请求 URL
+     * @param onProgress - 进度回调
+     * @param options - 其他选项
+     */
+    download(url, onProgress, options) {
+        return this.request('GET', url, {
+            ...options,
+            onProgress,
+        });
+    }
+}
+//# sourceMappingURL=HttpClient.js.map

package/dist/http/HttpClient.esm.js.map

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

package/dist/http/HttpClient.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * HttpClient 类
+ *
+ * 提供简单的 HTTP 请求接口
+ * - 内部构建 RequestContext
+ * - 调用 HttpExecutor 执行请求
+ * - 保持简单的 API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpClient = void 0;
+const context_1 = require("@qimenjs/context");
+const HttpExecutor_1 = require("./HttpExecutor");
+/**
+ * HttpClient 类
+ */
+class HttpClient {
+    /**
+     * 构造函数
+     *
+     * @param domain - 域名
+     */
+    constructor(domain = 'default') {
+        this.domain = domain;
+        this.executor = new HttpExecutor_1.HttpExecutor();
+    }
+    /**
+     * 构建 RequestContext
+     */
+    buildContext(method, url, options = {}) {
+        let builder = context_1.RequestContextBuilder.create()
+            .withDomain(this.domain)
+            .withUrl(url)
+            .withMethod(method);
+        if (options.headers) {
+            builder = builder.withHeaders(options.headers);
+        }
+        if (options.body !== undefined) {
+            builder = builder.withBody(options.body);
+        }
+        if (options.queryParams) {
+            builder = builder.withQueryParams(options.queryParams);
+        }
+        const context = builder.build();
+        // 存储额外的选项到 metadata
+        if (options.timeout) {
+            context.metadata.timeout = options.timeout;
+        }
+        if (options.onProgress) {
+            context.metadata.onProgress = options.onProgress;
+        }
+        return context;
+    }
+    /**
+     * 发送请求
+     */
+    request(method, url, options = {}) {
+        // 构建 RequestContext
+        const context = this.buildContext(method, url, options);
+        // 创建可取消的任务
+        const task = this.executor.createTask(context);
+        return {
+            context: task.promise.then(result => result.context),
+            cancel: task.cancel,
+        };
+    }
+    /**
+     * GET 请求
+     */
+    get(url, options) {
+        return this.request('GET', url, options);
+    }
+    /**
+     * POST 请求
+     */
+    post(url, body, options) {
+        return this.request('POST', url, { ...options, body });
+    }
+    /**
+     * PUT 请求
+     */
+    put(url, body, options) {
+        return this.request('PUT', url, { ...options, body });
+    }
+    /**
+     * PATCH 请求
+     */
+    patch(url, body, options) {
+        return this.request('PATCH', url, { ...options, body });
+    }
+    /**
+     * DELETE 请求
+     */
+    delete(url, options) {
+        return this.request('DELETE', url, options);
+    }
+    /**
+     * 上传文件
+     *
+     * @param url - 请求 URL
+     * @param body - 请求体（通常是 FormData）
+     * @param onProgress - 进度回调
+     * @param options - 其他选项
+     */
+    upload(url, body, onProgress, options) {
+        return this.request('POST', url, {
+            ...options,
+            body,
+            onProgress,
+        });
+    }
+    /**
+     * 下载文件
+     *
+     * @param url - 请求 URL
+     * @param onProgress - 进度回调
+     * @param options - 其他选项
+     */
+    download(url, onProgress, options) {
+        return this.request('GET', url, {
+            ...options,
+            onProgress,
+        });
+    }
+}
+exports.HttpClient = HttpClient;
+//# sourceMappingURL=HttpClient.js.map

package/dist/http/HttpClient.js.map

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

package/dist/http/HttpExecutor.d.ts

@@ -0,0 +1,64 @@
+/**
+ * HttpExecutor 核心类
+ *
+ * 负责执行 HTTP 请求的核心逻辑
+ * - 接收 RequestContext
+ * - 处理 domain 配置
+ * - 从 HttpActionRegistrar 获取 actions
+ * - 执行管道
+ * - 返回处理后的上下文
+ */
+import type { RequestContext } from '@qimenjs/context';
+/**
+ * HTTP 执行结果
+ */
+export interface HttpExecutionResult {
+    /**
+     * 执行后的上下文
+     */
+    context: RequestContext;
+    /**
+     * 是否成功
+     */
+    success: boolean;
+    /**
+     * 错误信息（如果有）
+     */
+    error?: any;
+}
+/**
+ * HttpExecutor 核心类
+ */
+export declare class HttpExecutor {
+    /**
+     * 处理 domain 配置
+     *
+     * @param context - 请求上下文
+     * @deprecated Domain 配置已在 RequestContextBuilder.build() 中获取并缓存
+     */
+    private processDomainConfig;
+    /**
+     * 获取 actions 列表
+     *
+     * @returns actions 列表
+     */
+    private getActions;
+    /**
+     * 执行 HTTP 请求
+     *
+     * @param context - 请求上下文
+     * @returns 执行结果
+     */
+    execute(context: RequestContext): Promise<HttpExecutionResult>;
+    /**
+     * 创建可取消的执行任务
+     *
+     * @param context - 请求上下文
+     * @returns 包含 promise 和 cancel 方法的对象
+     */
+    createTask(context: RequestContext): {
+        promise: Promise<HttpExecutionResult>;
+        cancel: (reason?: string) => void;
+    };
+}
+//# sourceMappingURL=HttpExecutor.d.ts.map

package/dist/http/HttpExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpExecutor.d.ts","sourceRoot":"","sources":["../../../src/http/HttpExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAKvD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;OAEG;IACH,OAAO,EAAE,cAAc,CAAC;IAExB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,GAAG,CAAC;CACf;AAED;;GAEG;AACH,qBAAa,YAAY;IACrB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAKlB;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAwCpE;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG;QACjC,OAAO,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAC;QACtC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;KACrC;CA4BJ"}

package/dist/http/HttpExecutor.esm.js

@@ -0,0 +1,109 @@
+/**
+ * HttpExecutor 核心类
+ *
+ * 负责执行 HTTP 请求的核心逻辑
+ * - 接收 RequestContext
+ * - 处理 domain 配置
+ * - 从 HttpActionRegistrar 获取 actions
+ * - 执行管道
+ * - 返回处理后的上下文
+ */
+import { pipeline } from '@qimenjs/pipeline';
+import { HttpActionRegistrar } from './HttpActionRegistrar';
+/**
+ * HttpExecutor 核心类
+ */
+export class HttpExecutor {
+    /**
+     * 处理 domain 配置
+     *
+     * @param context - 请求上下文
+     * @deprecated Domain 配置已在 RequestContextBuilder.build() 中获取并缓存
+     */
+    processDomainConfig(context) {
+        // Domain 配置已在 RequestContextBuilder.build() 中获取并缓存到 context.metadata.domainConfig
+        // 这里不需要再做任何处理
+    }
+    /**
+     * 获取 actions 列表
+     *
+     * @returns actions 列表
+     */
+    getActions() {
+        const registrar = HttpActionRegistrar.getInstance();
+        return registrar.getPipeline();
+    }
+    /**
+     * 执行 HTTP 请求
+     *
+     * @param context - 请求上下文
+     * @returns 执行结果
+     */
+    async execute(context) {
+        try {
+            // 处理 domain 配置
+            this.processDomainConfig(context);
+            // 获取 actions
+            const actions = this.getActions();
+            // 如果有 actions，执行管道
+            if (actions.length > 0) {
+                // 转换为 pipeline 需要的格式
+                const processors = actions.map(action => ({
+                    name: action.name,
+                    weight: action.category,
+                    offset: action.offset,
+                    execute: async (ctx) => {
+                        await action.handler(ctx);
+                    },
+                }));
+                // 执行管道
+                await pipeline.execute(context, processors);
+            }
+            return {
+                context,
+                success: !context.error,
+                error: context.error,
+            };
+        }
+        catch (error) {
+            // 捕获执行过程中的错误
+            context.error = error;
+            return {
+                context,
+                success: false,
+                error,
+            };
+        }
+    }
+    /**
+     * 创建可取消的执行任务
+     *
+     * @param context - 请求上下文
+     * @returns 包含 promise 和 cancel 方法的对象
+     */
+    createTask(context) {
+        const controller = new AbortController();
+        // 将 controller 存储到 context.metadata
+        context.metadata._httpController = controller;
+        const promise = new Promise(resolve => {
+            // 监听取消事件
+            controller.signal.addEventListener('abort', () => {
+                context.metadata.isAborted = true;
+                resolve({
+                    context,
+                    success: false,
+                    error: new Error('Request cancelled'),
+                });
+            });
+            // 执行请求
+            this.execute(context).then(resolve);
+        });
+        return {
+            promise,
+            cancel: (reason) => {
+                controller.abort(reason || 'user_cancelled');
+            },
+        };
+    }
+}
+//# sourceMappingURL=HttpExecutor.js.map

package/dist/http/HttpExecutor.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpExecutor.js","sourceRoot":"","sources":["../../../src/http/HttpExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7C,OAAO,EAAE,mBAAmB,EAAwB,MAAM,uBAAuB,CAAC;AAsBlF;;GAEG;AACH,MAAM,OAAO,YAAY;IACrB;;;;;OAKG;IACK,mBAAmB,CAAC,OAAuB;QAC/C,kFAAkF;QAClF,cAAc;IAClB,CAAC;IAED;;;;OAIG;IACK,UAAU;QACd,MAAM,SAAS,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC;QACpD,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACjC,IAAI,CAAC;YACD,eAAe;YACf,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAElC,aAAa;YACb,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAElC,mBAAmB;YACnB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,qBAAqB;gBACrB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACtC,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,MAAM,EAAE,MAAM,CAAC,QAAQ;oBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,OAAO,EAAE,KAAK,EAAE,GAAmB,EAAE,EAAE;wBACnC,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBAC9B,CAAC;iBACJ,CAAC,CAAC,CAAC;gBAEJ,OAAO;gBACP,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAChD,CAAC;YAED,OAAO;gBACH,OAAO;gBACP,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK;gBACvB,KAAK,EAAE,OAAO,CAAC,KAAK;aACvB,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,aAAa;YACb,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;YACtB,OAAO;gBACH,OAAO;gBACP,OAAO,EAAE,KAAK;gBACd,KAAK;aACR,CAAC;QACN,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,OAAuB;QAI9B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QAEzC,oCAAoC;QACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,GAAG,UAAU,CAAC;QAE9C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAsB,OAAO,CAAC,EAAE;YACvD,SAAS;YACT,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;gBAClC,OAAO,CAAC;oBACJ,OAAO;oBACP,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,IAAI,KAAK,CAAC,mBAAmB,CAAC;iBACxC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;YAEH,OAAO;YACP,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,OAAO;YACH,OAAO;YACP,MAAM,EAAE,CAAC,MAAe,EAAE,EAAE;gBACxB,UAAU,CAAC,KAAK,CAAC,MAAM,IAAI,gBAAgB,CAAC,CAAC;YACjD,CAAC;SACJ,CAAC;IACN,CAAC;CACJ"}

package/dist/http/HttpExecutor.js

@@ -0,0 +1,113 @@
+"use strict";
+/**
+ * HttpExecutor 核心类
+ *
+ * 负责执行 HTTP 请求的核心逻辑
+ * - 接收 RequestContext
+ * - 处理 domain 配置
+ * - 从 HttpActionRegistrar 获取 actions
+ * - 执行管道
+ * - 返回处理后的上下文
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpExecutor = void 0;
+const pipeline_1 = require("@qimenjs/pipeline");
+const HttpActionRegistrar_1 = require("./HttpActionRegistrar");
+/**
+ * HttpExecutor 核心类
+ */
+class HttpExecutor {
+    /**
+     * 处理 domain 配置
+     *
+     * @param context - 请求上下文
+     * @deprecated Domain 配置已在 RequestContextBuilder.build() 中获取并缓存
+     */
+    processDomainConfig(context) {
+        // Domain 配置已在 RequestContextBuilder.build() 中获取并缓存到 context.metadata.domainConfig
+        // 这里不需要再做任何处理
+    }
+    /**
+     * 获取 actions 列表
+     *
+     * @returns actions 列表
+     */
+    getActions() {
+        const registrar = HttpActionRegistrar_1.HttpActionRegistrar.getInstance();
+        return registrar.getPipeline();
+    }
+    /**
+     * 执行 HTTP 请求
+     *
+     * @param context - 请求上下文
+     * @returns 执行结果
+     */
+    async execute(context) {
+        try {
+            // 处理 domain 配置
+            this.processDomainConfig(context);
+            // 获取 actions
+            const actions = this.getActions();
+            // 如果有 actions，执行管道
+            if (actions.length > 0) {
+                // 转换为 pipeline 需要的格式
+                const processors = actions.map(action => ({
+                    name: action.name,
+                    weight: action.category,
+                    offset: action.offset,
+                    execute: async (ctx) => {
+                        await action.handler(ctx);
+                    },
+                }));
+                // 执行管道
+                await pipeline_1.pipeline.execute(context, processors);
+            }
+            return {
+                context,
+                success: !context.error,
+                error: context.error,
+            };
+        }
+        catch (error) {
+            // 捕获执行过程中的错误
+            context.error = error;
+            return {
+                context,
+                success: false,
+                error,
+            };
+        }
+    }
+    /**
+     * 创建可取消的执行任务
+     *
+     * @param context - 请求上下文
+     * @returns 包含 promise 和 cancel 方法的对象
+     */
+    createTask(context) {
+        const controller = new AbortController();
+        // 将 controller 存储到 context.metadata
+        context.metadata._httpController = controller;
+        const promise = new Promise(resolve => {
+            // 监听取消事件
+            controller.signal.addEventListener('abort', () => {
+                context.metadata.isAborted = true;
+                resolve({
+                    context,
+                    success: false,
+                    error: new Error('Request cancelled'),
+                });
+            });
+            // 执行请求
+            this.execute(context).then(resolve);
+        });
+        return {
+            promise,
+            cancel: (reason) => {
+                controller.abort(reason || 'user_cancelled');
+            },
+        };
+    }
+}
+exports.HttpExecutor = HttpExecutor;
+//# sourceMappingURL=HttpExecutor.js.map

package/dist/http/HttpExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpExecutor.js","sourceRoot":"","sources":["../../../src/http/HttpExecutor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAGH,gDAA6C;AAE7C,+DAAkF;AAsBlF;;GAEG;AACH,MAAa,YAAY;IACrB;;;;;OAKG;IACK,mBAAmB,CAAC,OAAuB;QAC/C,kFAAkF;QAClF,cAAc;IAClB,CAAC;IAED;;;;OAIG;IACK,UAAU;QACd,MAAM,SAAS,GAAG,yCAAmB,CAAC,WAAW,EAAE,CAAC;QACpD,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC;IACnC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAO,CAAC,OAAuB;QACjC,IAAI,CAAC;YACD,eAAe;YACf,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAElC,aAAa;YACb,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAElC,mBAAmB;YACnB,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,qBAAqB;gBACrB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACtC,IAAI,EAAE,MAAM,CAAC,IAAI;oBACjB,MAAM,EAAE,MAAM,CAAC,QAAQ;oBACvB,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,OAAO,EAAE,KAAK,EAAE,GAAmB,EAAE,EAAE;wBACnC,MAAM,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;oBAC9B,CAAC;iBACJ,CAAC,CAAC,CAAC;gBAEJ,OAAO;gBACP,MAAM,mBAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAChD,CAAC;YAED,OAAO;gBACH,OAAO;gBACP,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK;gBACvB,KAAK,EAAE,OAAO,CAAC,KAAK;aACvB,CAAC;QACN,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,aAAa;YACb,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;YACtB,OAAO;gBACH,OAAO;gBACP,OAAO,EAAE,KAAK;gBACd,KAAK;aACR,CAAC;QACN,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,OAAuB;QAI9B,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QAEzC,oCAAoC;QACpC,OAAO,CAAC,QAAQ,CAAC,eAAe,GAAG,UAAU,CAAC;QAE9C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAsB,OAAO,CAAC,EAAE;YACvD,SAAS;YACT,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE;gBAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC;gBAClC,OAAO,CAAC;oBACJ,OAAO;oBACP,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,IAAI,KAAK,CAAC,mBAAmB,CAAC;iBACxC,CAAC,CAAC;YACP,CAAC,CAAC,CAAC;YAEH,OAAO;YACP,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,OAAO;YACH,OAAO;YACP,MAAM,EAAE,CAAC,MAAe,EAAE,EAAE;gBACxB,UAAU,CAAC,KAAK,CAAC,MAAM,IAAI,gBAAgB,CAAC,CAAC;YACjD,CAAC;SACJ,CAAC;IACN,CAAC;CACJ;AAzGD,oCAyGC"}

package/dist/http/StreamClient.d.ts

@@ -0,0 +1,86 @@
+/**
+ * StreamClient 类
+ *
+ * 专门用于处理流式数据请求（如 SSE、AI 流式 API）
+ * - 使用 Async Generator 模式，支持 for await 消费
+ * - 基于 RequestContextBuilder 构建上下文
+ * - 通过 HttpExecutor 执行 prepare 管道后，直接消费 ReadableStream
+ *
+ * @module http/StreamClient
+ */
+import { type RequestContext } from '@qimenjs/context';
+import type { HttpMethod } from './types/http-context';
+/**
+ * 流式请求选项
+ */
+export interface StreamRequestOptions {
+    /**
+     * 请求头
+     */
+    headers?: Record<string, string>;
+    /**
+     * 查询参数
+     */
+    queryParams?: Record<string, any>;
+}
+/**
+ * 流式请求任务
+ */
+export interface StreamTask<T = any> {
+    /**
+     * 异步生成器，用于 for await 消费
+     */
+    stream: AsyncIterableIterator<T>;
+    /**
+     * 取消流式请求
+     */
+    cancel: (reason?: string) => void;
+    /**
+     * 请求上下文
+     */
+    context: RequestContext;
+}
+/**
+ * StreamClient 类
+ *
+ * 专门用于处理流式数据请求，特别是 AI 相关的流式 API
+ * 使用 Async Generator 模式，支持 for await 消费
+ */
+export declare class StreamClient {
+    private domain;
+    private executor;
+    /**
+     * 构造函数
+     *
+     * @param domain - 域名，默认为 'default'
+     */
+    constructor(domain?: string);
+    /**
+     * 发起流式请求
+     *
+     * @param method - HTTP 方法
+     * @param url - 请求 URL
+     * @param body - 请求体
+     * @param options - 请求选项
+     * @returns StreamTask 对象，包含异步生成器、取消方法和上下文
+     */
+    request<T = any>(method: HttpMethod, url: string, body?: any, options?: StreamRequestOptions): StreamTask<T>;
+    /**
+     * 发起 POST 流式请求（最常用的 AI 流式接口）
+     *
+     * @param url - 请求 URL
+     * @param body - 请求体
+     * @param options - 请求选项
+     * @returns StreamTask 对象
+     */
+    post<T = any>(url: string, body?: any, options?: StreamRequestOptions): StreamTask<T>;
+    /**
+     * 发起 GET 流式请求
+     *
+     * @param url - 请求 URL
+     * @param options - 请求选项
+     * @returns StreamTask 对象
+     */
+    get<T = any>(url: string, options?: StreamRequestOptions): StreamTask<T>;
+}
+//# sourceMappingURL=StreamClient.d.ts.map

package/dist/http/StreamClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamClient.d.ts","sourceRoot":"","sources":["../../../src/http/StreamClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,GAAG;IAC/B;;OAEG;IACH,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAEjC;;OAEG;IACH,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAElC;;OAEG;IACH,OAAO,EAAE,cAAc,CAAC;CAC3B;AAED;;;;;GAKG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAe;IAE/B;;;;OAIG;gBACS,MAAM,GAAE,MAAkB;IAKtC;;;;;;;;OAQG;IACH,OAAO,CAAC,CAAC,GAAG,GAAG,EACX,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,GAAE,oBAAyB,GACnC,UAAU,CAAC,CAAC,CAAC;IAyGhB;;;;;;;OAOG;IACH,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,UAAU,CAAC,CAAC,CAAC;IAIrF;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,UAAU,CAAC,CAAC,CAAC;CAG3E"}