@dscli/request 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xionchan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# @dscli/request
+
+类型安全、可扩展且兼容 SSR 的请求客户端。根入口使用标准 Fetch API；axios 与 Vue 3 通过显式子路径按需导入。
+
+> 当前为 `0.1.0-alpha.0` 本地候选，尚未发布到 npm。不要把它视为公共稳定版本。
+
+## 安装
+
+该候选尚未发布到 npm。在本仓库的联调项目中使用 workspace 协议：
+
+```sh
+pnpm --filter <consumer-package> add @dscli/request@workspace:*
+```
+
+公共 alpha 发布完成后，安装方式会更新为显式 `@alpha` 或精确版本。
+
+## 用法
+
+```ts
+import { createRequest, RequestError } from '@dscli/request'
+
+const request = createRequest({
+  baseUrl: runtimeConfig.apiBaseUrl,
+  timeout: 8_000
+})
+
+try {
+  const data = await request.get<Data>('/data')
+} catch (error) {
+  if (error instanceof RequestError && error.kind === 'http') {
+    // 调用方处理 HTTP 状态和业务提示。
+  }
+}
+```
+
+## 入口
+
+- `@dscli/request`：`createRequest`、兼容包装 `dsRequest`、类型与 `RequestError`。
+- `@dscli/request/axios`：`createAxiosRequest`，调用方传入 axios 兼容实例。
+- `@dscli/request/vue`：`createRequestPlugin`、`requestClientKey`、`useRequest`。
+
+axios 和 Vue 都是 optional peer dependency：仅在导入相应子路径时安装并使用它们。根入口不包含业务地址、token、自动重试或全局单例。
+
+## 开发
+
+```sh
+pnpm --filter @dscli/request lint
+pnpm --filter @dscli/request typecheck
+pnpm --filter @dscli/request test
+pnpm --filter @dscli/request build
+pnpm verify:request
+```

package/dist/axios/index.d.ts

@@ -0,0 +1,34 @@
+import type { RequestClient, RequestOptions } from '../core/types.js';
+/** axios 实例所需的最小结构，避免将 axios 打入本包。 */
+export interface AxiosLike {
+    request<T = unknown>(config: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+}
+/** axios 使用小写的 arraybuffer/formdata，而统一契约保持 Fetch 风格命名。 */
+export type AxiosResponseType = 'arraybuffer' | 'blob' | 'formdata' | 'json' | 'text';
+export interface AxiosRequestConfig {
+    url: string;
+    method?: string;
+    baseURL?: string;
+    headers?: Record<string, string>;
+    params?: RequestOptions['query'];
+    data?: unknown;
+    signal?: AbortSignal;
+    timeout?: number;
+    responseType?: AxiosResponseType;
+}
+export interface AxiosResponse<T> {
+    data: T;
+    status: number;
+    statusText?: string;
+}
+export interface AxiosRequestClientOptions {
+    baseUrl?: string;
+    headers?: HeadersInit;
+    timeout?: number;
+}
+/**
+ * 将调用方持有的 axios 实例适配为 RequestClient。
+ * axios 的拦截器、重试与认证仍由调用方在原实例上配置。
+ */
+export declare function createAxiosRequest(axios: AxiosLike, defaults?: AxiosRequestClientOptions): RequestClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/axios/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/axios/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAuB,MAAM,kBAAkB,CAAA;AAE1F,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAA;CAC5E;AAED,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAA;AAErF,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,MAAM,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAA;IAChC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,iBAAiB,CAAA;CACjC;AAED,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAA;IACP,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAsDD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,QAAQ,GAAE,yBAA8B,GACvC,aAAa,CAgEf"}

package/dist/axios/index.js

@@ -0,0 +1,113 @@
+import { RequestError } from '../core/errors.js';
+function mergeHeaders(defaultHeaders, headers) {
+    const merged = new Headers(defaultHeaders);
+    if (headers)
+        for (const [key, value] of new Headers(headers))
+            merged.set(key, value);
+    return Object.fromEntries(merged.entries());
+}
+function normalizeTimeout(timeout) {
+    if (timeout === undefined || timeout === 0)
+        return undefined;
+    if (!Number.isFinite(timeout) || timeout < 0) {
+        throw new RequestError('configuration', 'timeout 必须是非负有限毫秒数');
+    }
+    return timeout;
+}
+function createData(options, headers) {
+    if (options.body !== undefined && options.json !== undefined) {
+        throw new RequestError('configuration', 'body 与 json 不能同时提供');
+    }
+    if (options.body !== undefined)
+        return options.body;
+    if (options.json === undefined)
+        return undefined;
+    if (!Object.keys(headers).some((key) => key.toLowerCase() === 'content-type')) {
+        headers['content-type'] = 'application/json';
+    }
+    return options.json;
+}
+/** 将统一响应类型转换为 axios 的运行时枚举，并在调用前拒绝无法表达的原始 Response。 */
+function toAxiosResponseType(responseType) {
+    switch (responseType) {
+        case undefined:
+            return undefined;
+        case 'arrayBuffer':
+            return 'arraybuffer';
+        case 'formData':
+            return 'formdata';
+        case 'response':
+            throw new RequestError('configuration', 'axios 适配器不支持 response 响应类型');
+        default:
+            return responseType;
+    }
+}
+function createMethodRequest(request, method) {
+    return (url, json, options = {}) => request(url, { ...options, method, json });
+}
+/**
+ * 将调用方持有的 axios 实例适配为 RequestClient。
+ * axios 的拦截器、重试与认证仍由调用方在原实例上配置。
+ */
+export function createAxiosRequest(axios, defaults = {}) {
+    const defaultTimeout = normalizeTimeout(defaults.timeout);
+    const request = async (url, options = {}) => {
+        if (url.trim().length === 0)
+            throw new RequestError('configuration', '请求 URL 不能为空');
+        if (options.signal?.aborted) {
+            throw new RequestError('abort', '请求已被调用方取消', { url, cause: options.signal.reason });
+        }
+        const timeout = normalizeTimeout(options.timeout ?? defaultTimeout);
+        const headers = mergeHeaders(defaults.headers, options.headers);
+        const config = {
+            url,
+            method: (options.method ?? 'GET').toUpperCase(),
+            baseURL: defaults.baseUrl,
+            headers,
+            params: options.query,
+            data: createData(options, headers),
+            signal: options.signal,
+            timeout,
+            responseType: toAxiosResponseType(options.responseType)
+        };
+        try {
+            const response = await axios.request(config);
+            if (response.status < 200 || response.status >= 300) {
+                throw new RequestError('http', `请求失败：${response.status}`, {
+                    url,
+                    status: response.status,
+                    statusText: response.statusText
+                });
+            }
+            return response.data;
+        }
+        catch (cause) {
+            if (cause instanceof RequestError)
+                throw cause;
+            const axiosError = cause;
+            if (axiosError.response?.status !== undefined) {
+                throw new RequestError('http', `请求失败：${axiosError.response.status}`, {
+                    url,
+                    status: axiosError.response.status,
+                    statusText: axiosError.response.statusText,
+                    cause
+                });
+            }
+            if (axiosError.code === 'ECONNABORTED') {
+                throw new RequestError('timeout', `请求超时：${timeout ?? 0}ms`, { url, cause });
+            }
+            if (options.signal?.aborted)
+                throw new RequestError('abort', '请求已被取消', { url, cause });
+            throw new RequestError('network', '请求网络失败', { url, cause });
+        }
+    };
+    return {
+        request,
+        get: (url, options = {}) => request(url, { ...options, method: 'GET' }),
+        delete: (url, options = {}) => request(url, { ...options, method: 'DELETE' }),
+        post: createMethodRequest(request, 'POST'),
+        put: createMethodRequest(request, 'PUT'),
+        patch: createMethodRequest(request, 'PATCH')
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/axios/index.js.map

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

package/dist/core/errors.d.ts

@@ -0,0 +1,20 @@
+/** 可供调用方按失败类型处理的请求错误分类。 */
+export type RequestErrorKind = 'configuration' | 'http' | 'network' | 'timeout' | 'abort' | 'parse';
+export interface RequestErrorOptions {
+    url?: string;
+    status?: number;
+    statusText?: string;
+    cause?: unknown;
+}
+/**
+ * 为网络、HTTP、取消和解析失败提供统一上下文。
+ * cause 保留原始异常，避免调用方丢失运行时特有信息。
+ */
+export declare class RequestError extends Error {
+    readonly kind: RequestErrorKind;
+    readonly url?: string;
+    readonly status?: number;
+    readonly statusText?: string;
+    constructor(kind: RequestErrorKind, message: string, options?: RequestErrorOptions);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAEnG,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;gBAEhB,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB;CAQvF"}

package/dist/core/errors.js

@@ -0,0 +1,19 @@
+/**
+ * 为网络、HTTP、取消和解析失败提供统一上下文。
+ * cause 保留原始异常，避免调用方丢失运行时特有信息。
+ */
+export class RequestError extends Error {
+    kind;
+    url;
+    status;
+    statusText;
+    constructor(kind, message, options = {}) {
+        super(message, options.cause === undefined ? undefined : { cause: options.cause });
+        this.name = 'RequestError';
+        this.kind = kind;
+        this.url = options.url;
+        this.status = options.status;
+        this.statusText = options.statusText;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/core/errors.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAkB;IACtB,GAAG,CAAS;IACZ,MAAM,CAAS;IACf,UAAU,CAAS;IAE5B,YAAY,IAAsB,EAAE,OAAe,EAAE,UAA+B,EAAE;QACpF,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAA;QAClF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAA;QACtB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAA;IACtC,CAAC;CACF"}

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+import type { DsRequestOptions, RequestClient, RequestClientOptions } from './types.js';
+export { RequestError } from './errors.js';
+export type { RequestErrorKind, RequestErrorOptions } from './errors.js';
+export type { DsRequestOptions, FetchImplementation, RequestClient, RequestClientOptions, RequestMethod, RequestOptions, RequestQuery, RequestQueryValue, RequestResponseType } from './types.js';
+/**
+ * 创建 fetch 请求客户端。函数在调用 request 前不会访问网络或浏览器全局。
+ */
+export declare function createRequest(defaults?: RequestClientOptions): RequestClient;
+/** 保留旧 API；旧 body 一律按 JSON 序列化，新代码应优先使用 createRequest。 */
+export declare function dsRequest<T = unknown>(url: string, options?: DsRequestOptions): Promise<T>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,gBAAgB,EAEhB,aAAa,EACb,oBAAoB,EAGrB,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,YAAY,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AACxE,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,YAAY,CAAA;AA0HnB;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,GAAE,oBAAyB,GAAG,aAAa,CA2DhF;AAID,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,CAAC,CAAC,CAG9F"}

package/dist/core/index.js

@@ -0,0 +1,167 @@
+import { RequestError } from './errors.js';
+import { appendQuery, normalizeTimeout, resolveRequestUrl } from './url.js';
+export { RequestError } from './errors.js';
+function createAbortContext(signal, timeout) {
+    if (!signal && !timeout) {
+        return { signal: undefined, timedOut: () => false, cleanup: () => undefined };
+    }
+    const controller = new AbortController();
+    let timeoutTriggered = false;
+    const abortFromCaller = () => controller.abort(signal?.reason);
+    if (signal?.aborted)
+        abortFromCaller();
+    else
+        signal?.addEventListener('abort', abortFromCaller, { once: true });
+    const timer = timeout
+        ? setTimeout(() => {
+            timeoutTriggered = true;
+            controller.abort(new Error('请求超时'));
+        }, timeout)
+        : undefined;
+    return {
+        signal: controller.signal,
+        timedOut: () => timeoutTriggered,
+        cleanup: () => {
+            if (timer)
+                clearTimeout(timer);
+            signal?.removeEventListener('abort', abortFromCaller);
+        }
+    };
+}
+function getFetchImplementation(injected) {
+    if (injected)
+        return injected;
+    if (typeof globalThis.fetch !== 'function') {
+        throw new RequestError('configuration', '当前运行时没有可用的 fetch，请通过 createRequest 注入 fetch');
+    }
+    return globalThis.fetch.bind(globalThis);
+}
+function mergeHeaders(defaultHeaders, headers) {
+    const merged = new Headers(defaultHeaders);
+    if (!headers)
+        return merged;
+    for (const [key, value] of new Headers(headers))
+        merged.set(key, value);
+    return merged;
+}
+function createBody(options, headers) {
+    if (options.body !== undefined && options.json !== undefined) {
+        throw new RequestError('configuration', 'body 与 json 不能同时提供');
+    }
+    if (options.body !== undefined)
+        return options.body;
+    if (options.json === undefined)
+        return undefined;
+    let serialized;
+    try {
+        serialized = JSON.stringify(options.json);
+    }
+    catch (cause) {
+        throw new RequestError('configuration', 'json 无法序列化', { cause });
+    }
+    if (serialized === undefined) {
+        throw new RequestError('configuration', 'json 必须是可序列化的值');
+    }
+    if (!headers.has('content-type'))
+        headers.set('content-type', 'application/json');
+    return serialized;
+}
+async function parseResponse(response, responseType) {
+    if (responseType === 'response')
+        return response;
+    if (responseType === 'json' &&
+        (response.status === 204 ||
+            response.status === 205 ||
+            response.headers.get('content-length') === '0')) {
+        return undefined;
+    }
+    try {
+        switch (responseType) {
+            case 'json': {
+                // 部分服务会以 chunked 响应返回 200 空 body，此时没有 content-length 可供提前判断。
+                const text = await response.text();
+                return (text.length === 0 ? undefined : JSON.parse(text));
+            }
+            case 'text':
+                return (await response.text());
+            case 'blob':
+                return (await response.blob());
+            case 'arrayBuffer':
+                return (await response.arrayBuffer());
+            case 'formData':
+                return (await response.formData());
+            default:
+                return response;
+        }
+    }
+    catch (cause) {
+        throw new RequestError('parse', '响应内容无法按指定类型读取', { cause });
+    }
+}
+function createMethodRequest(request, method) {
+    return (url, json, options = {}) => request(url, { ...options, method, json });
+}
+/**
+ * 创建 fetch 请求客户端。函数在调用 request 前不会访问网络或浏览器全局。
+ */
+export function createRequest(defaults = {}) {
+    const defaultTimeout = normalizeTimeout(defaults.timeout);
+    const request = async (url, options = {}) => {
+        const timeout = normalizeTimeout(options.timeout ?? defaultTimeout);
+        const resolvedUrl = appendQuery(resolveRequestUrl(url, defaults.baseUrl), options.query);
+        if (options.signal?.aborted) {
+            throw new RequestError('abort', '请求已被调用方取消', {
+                url: resolvedUrl,
+                cause: options.signal.reason
+            });
+        }
+        const headers = mergeHeaders(defaults.headers, options.headers);
+        const body = createBody(options, headers);
+        const abortContext = createAbortContext(options.signal, timeout);
+        try {
+            const response = await getFetchImplementation(defaults.fetch)(resolvedUrl, {
+                method: (options.method ?? 'GET').toUpperCase(),
+                headers,
+                body,
+                signal: abortContext.signal
+            });
+            if (!response.ok) {
+                throw new RequestError('http', `请求失败：${response.status} ${response.statusText}`.trim(), {
+                    url: resolvedUrl,
+                    status: response.status,
+                    statusText: response.statusText
+                });
+            }
+            return await parseResponse(response, options.responseType ?? 'json');
+        }
+        catch (cause) {
+            if (cause instanceof RequestError)
+                throw cause;
+            if (abortContext.timedOut()) {
+                throw new RequestError('timeout', `请求超时：${timeout}ms`, { url: resolvedUrl, cause });
+            }
+            if (options.signal?.aborted || abortContext.signal?.aborted) {
+                throw new RequestError('abort', '请求已被取消', { url: resolvedUrl, cause });
+            }
+            throw new RequestError('network', '请求网络失败', { url: resolvedUrl, cause });
+        }
+        finally {
+            abortContext.cleanup();
+        }
+    };
+    return {
+        request,
+        get: (url, options = {}) => request(url, { ...options, method: 'GET' }),
+        delete: (url, options = {}) => request(url, { ...options, method: 'DELETE' }),
+        post: createMethodRequest(request, 'POST'),
+        put: createMethodRequest(request, 'PUT'),
+        patch: createMethodRequest(request, 'PATCH')
+    };
+}
+const defaultRequestClient = createRequest();
+/** 保留旧 API；旧 body 一律按 JSON 序列化，新代码应优先使用 createRequest。 */
+export function dsRequest(url, options = {}) {
+    const { body, ...requestOptions } = options;
+    return defaultRequestClient.request(url, { ...requestOptions, json: body });
+}
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

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

package/dist/core/types.d.ts

@@ -0,0 +1,43 @@
+/** 支持自定义方法名，同时为常用 HTTP 方法提供自动补全。 */
+export type RequestMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS' | (string & {});
+/** 请求客户端能够读取的响应形式。 */
+export type RequestResponseType = 'json' | 'text' | 'blob' | 'arrayBuffer' | 'formData' | 'response';
+export type RequestQueryValue = string | number | boolean | bigint | null | undefined;
+/** query 数组会在最终 URL 中编码为重复参数。 */
+export type RequestQuery = Record<string, RequestQueryValue | readonly RequestQueryValue[]>;
+/** 允许在测试、SSR 或受控运行时中注入 fetch 实现。 */
+export type FetchImplementation = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+/** 单次请求选项。`body` 用于原始 BodyInit，`json` 用于 JSON 序列化，两者不能同时出现。 */
+export interface RequestOptions {
+    method?: RequestMethod;
+    headers?: HeadersInit;
+    query?: RequestQuery;
+    body?: BodyInit | null;
+    json?: unknown;
+    signal?: AbortSignal;
+    /** 毫秒；0 或 undefined 表示不设置超时。 */
+    timeout?: number;
+    responseType?: RequestResponseType;
+}
+/** 创建 fetch 请求客户端的默认选项。 */
+export interface RequestClientOptions {
+    baseUrl?: string;
+    headers?: HeadersInit;
+    fetch?: FetchImplementation;
+    /** 毫秒；可被单次请求的 timeout 覆盖。 */
+    timeout?: number;
+}
+/** 统一的请求客户端契约，供 fetch、axios 和 Vue 注入共用。 */
+export interface RequestClient {
+    request<T = unknown>(url: string, options?: RequestOptions): Promise<T>;
+    get<T = unknown>(url: string, options?: Omit<RequestOptions, 'method'>): Promise<T>;
+    delete<T = unknown>(url: string, options?: Omit<RequestOptions, 'method'>): Promise<T>;
+    post<T = unknown>(url: string, json?: unknown, options?: Omit<RequestOptions, 'method' | 'json' | 'body'>): Promise<T>;
+    put<T = unknown>(url: string, json?: unknown, options?: Omit<RequestOptions, 'method' | 'json' | 'body'>): Promise<T>;
+    patch<T = unknown>(url: string, json?: unknown, options?: Omit<RequestOptions, 'method' | 'json' | 'body'>): Promise<T>;
+}
+/** 旧 dsRequest 的兼容选项；body 始终按 JSON 数据处理。 */
+export interface DsRequestOptions extends Omit<RequestOptions, 'body' | 'json'> {
+    body?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/core/url.d.ts

@@ -0,0 +1,8 @@
+import type { RequestQuery } from './types.js';
+/** 校验请求超时，避免 setTimeout 接收 NaN、负数或无穷大。 */
+export declare function normalizeTimeout(timeout: number | undefined): number | undefined;
+/** 解析基础 URL；未提供基础 URL 时保留相对 URL 交由运行时 fetch 处理。 */
+export declare function resolveRequestUrl(url: string, baseUrl: string | undefined): string;
+/** 在保留现有 query 与 hash 的前提下追加 query；null 和 undefined 值会被忽略。 */
+export declare function appendQuery(url: string, query: RequestQuery | undefined): string;
+//# sourceMappingURL=url.d.ts.map

package/dist/core/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/core/url.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,0CAA0C;AAC1C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAMhF;AAED,mDAAmD;AACnD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAWlF;AAED,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,CAqBhF"}

package/dist/core/url.js

@@ -0,0 +1,45 @@
+import { RequestError } from './errors.js';
+/** 校验请求超时，避免 setTimeout 接收 NaN、负数或无穷大。 */
+export function normalizeTimeout(timeout) {
+    if (timeout === undefined || timeout === 0)
+        return undefined;
+    if (!Number.isFinite(timeout) || timeout < 0) {
+        throw new RequestError('configuration', 'timeout 必须是非负有限毫秒数');
+    }
+    return timeout;
+}
+/** 解析基础 URL；未提供基础 URL 时保留相对 URL 交由运行时 fetch 处理。 */
+export function resolveRequestUrl(url, baseUrl) {
+    if (url.trim().length === 0) {
+        throw new RequestError('configuration', '请求 URL 不能为空');
+    }
+    if (!baseUrl)
+        return url;
+    try {
+        return new URL(url, baseUrl).toString();
+    }
+    catch (cause) {
+        throw new RequestError('configuration', '请求 URL 或 baseUrl 无效', { url, cause });
+    }
+}
+/** 在保留现有 query 与 hash 的前提下追加 query；null 和 undefined 值会被忽略。 */
+export function appendQuery(url, query) {
+    if (!query || Object.keys(query).length === 0)
+        return url;
+    const hashIndex = url.indexOf('#');
+    const fragment = hashIndex === -1 ? '' : url.slice(hashIndex);
+    const withoutFragment = hashIndex === -1 ? url : url.slice(0, hashIndex);
+    const queryIndex = withoutFragment.indexOf('?');
+    const pathname = queryIndex === -1 ? withoutFragment : withoutFragment.slice(0, queryIndex);
+    const parameters = new URLSearchParams(queryIndex === -1 ? '' : withoutFragment.slice(queryIndex + 1));
+    for (const [key, value] of Object.entries(query)) {
+        const values = Array.isArray(value) ? value : [value];
+        for (const item of values) {
+            if (item !== null && item !== undefined)
+                parameters.append(key, String(item));
+        }
+    }
+    const serialized = parameters.toString();
+    return `${pathname}${serialized ? `?${serialized}` : ''}${fragment}`;
+}
+//# sourceMappingURL=url.js.map

package/dist/core/url.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createRequest, dsRequest, RequestError } from './core/index.js';
+export type { DsRequestOptions, FetchImplementation, RequestClient, RequestClientOptions, RequestErrorKind, RequestErrorOptions, RequestMethod, RequestOptions, RequestQuery, RequestQueryValue, RequestResponseType } from './core/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AACxE,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createRequest, dsRequest, RequestError } from './core/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/vue/index.d.ts

@@ -0,0 +1,9 @@
+import type { InjectionKey, Plugin } from 'vue';
+import type { RequestClient } from '../core/types.js';
+/** Vue 组件中注入 RequestClient 的稳定 key。 */
+export declare const requestClientKey: InjectionKey<RequestClient>;
+/** 创建 Vue 3 plugin；同一个客户端可由多个应用分别安装。 */
+export declare function createRequestPlugin(client: RequestClient): Plugin;
+/** 在组件 setup 上下文中取得已通过 createRequestPlugin 安装的请求客户端。 */
+export declare function useRequest(): RequestClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/vue/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAO,YAAY,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AAEpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,uCAAuC;AACvC,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,aAAa,CAAkC,CAAA;AAE3F,wCAAwC;AACxC,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAMjE;AAED,wDAAwD;AACxD,wBAAgB,UAAU,IAAI,aAAa,CAM1C"}

package/dist/vue/index.js

@@ -0,0 +1,21 @@
+import { inject } from 'vue';
+import { RequestError } from '../core/errors.js';
+/** Vue 组件中注入 RequestClient 的稳定 key。 */
+export const requestClientKey = Symbol('dscli-request-client');
+/** 创建 Vue 3 plugin；同一个客户端可由多个应用分别安装。 */
+export function createRequestPlugin(client) {
+    return {
+        install(app) {
+            app.provide(requestClientKey, client);
+        }
+    };
+}
+/** 在组件 setup 上下文中取得已通过 createRequestPlugin 安装的请求客户端。 */
+export function useRequest() {
+    const client = inject(requestClientKey, undefined);
+    if (!client) {
+        throw new RequestError('configuration', '未找到 RequestClient，请先安装 createRequestPlugin');
+    }
+    return client;
+}
+//# sourceMappingURL=index.js.map

package/dist/vue/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AAE5B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGhD,uCAAuC;AACvC,MAAM,CAAC,MAAM,gBAAgB,GAAgC,MAAM,CAAC,sBAAsB,CAAC,CAAA;AAE3F,wCAAwC;AACxC,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,OAAO;QACL,OAAO,CAAC,GAAQ;YACd,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAA;QACvC,CAAC;KACF,CAAA;AACH,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,UAAU;IACxB,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAA;IAClD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,YAAY,CAAC,eAAe,EAAE,4CAA4C,CAAC,CAAA;IACvF,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC"}

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@dscli/request",
+  "version": "0.1.0-alpha.0",
+  "description": "类型安全、可扩展且兼容 SSR 的 fetch 请求客户端",
+  "type": "module",
+  "scripts": {
+    "clean": "node ./scripts/clean.mjs",
+    "build": "pnpm run clean && tsc -p tsconfig.build.json",
+    "lint": "eslint src scripts --max-warnings 0",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run --root ../.. packages/request/src",
+    "verify:package": "node ./scripts/verify-package.mjs",
+    "prepack": "pnpm run build"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./axios": {
+      "types": "./dist/axios/index.d.ts",
+      "import": "./dist/axios/index.js"
+    },
+    "./vue": {
+      "types": "./dist/vue/index.d.ts",
+      "import": "./dist/vue/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": "^22.18.0 || >=24.12.0"
+  },
+  "keywords": [
+    "request",
+    "fetch",
+    "axios",
+    "vue",
+    "typescript",
+    "ssr"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitee.com/xionchan/dscli.git",
+    "directory": "packages/request"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "alpha"
+  },
+  "peerDependencies": {
+    "axios": "^1.0.0",
+    "vue": "^3.5.0"
+  },
+  "peerDependenciesMeta": {
+    "axios": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "catalog:",
+    "vitest": "catalog:",
+    "vue": "catalog:"
+  },
+  "author": "游于艺(wx58012007)",
+  "license": "MIT"
+}