16 Commits

Author SHA1 Message Date
b53968df8b update no Stop 2025-06-18 14:59:56 +08:00
ca154ba883 feat: update new options 2025-06-07 19:07:28 +08:00
14dec5f5c5 add query adapter 2025-06-07 17:00:30 +08:00
452f821d06 fix: fix adapter 2025-06-03 21:12:33 +08:00
27adb05c39 fix: fix bugs 2025-06-03 20:04:37 +08:00
66905f13a9 "chore: 更新依赖及适配Blob响应" 2025-06-02 11:36:59 +08:00
366840bb1d fix: change base query 2025-05-25 00:06:10 +08:00
8385ab05f6 fix 2025-05-24 09:26:10 +08:00
515c6e6cf7 query add chain 2025-05-20 10:14:15 +08:00
1104efaa1a perf 2025-05-15 22:21:52 +08:00
cf6ca31aa4 query add cacel request 2025-04-06 21:35:29 +08:00
320bc93c69 temp 2025-04-05 22:27:46 +08:00
0570acb78f temp 2025-03-30 00:36:51 +08:00
fd5437292a fix: fix onopen 2025-03-22 14:34:17 +08:00
64b37e369d types change for afterResponse 2025-03-22 13:29:02 +08:00
8f85ed4d4d feat: 支持GET请求 因为GET的请求可以缓存 2025-03-22 13:19:40 +08:00
7 changed files with 281 additions and 74 deletions

View File

@@ -1,4 +1,5 @@
import { QueryClient } from '@abearxiong/query'; // @ts-ignore
import { QueryClient } from '@kevisual/query';
const query = new QueryClient({ url: '/api/router', io: true }); const query = new QueryClient({ url: '/api/router', io: true });

View File

@@ -1,6 +1,6 @@
{ {
"name": "@kevisual/query", "name": "@kevisual/query",
"version": "0.0.13", "version": "0.0.29",
"main": "dist/index.js", "main": "dist/index.js",
"module": "dist/index.js", "module": "dist/index.js",
"types": "dist/index.d.ts", "types": "dist/index.d.ts",
@@ -9,6 +9,7 @@
"scripts": { "scripts": {
"build": "npm run clean && rollup -c", "build": "npm run clean && rollup -c",
"build:app": "npm run build && rsync dist/* ../deploy/dist", "build:app": "npm run build && rsync dist/* ../deploy/dist",
"dev:lib": "rollup -c -w",
"clean": "rm -rf dist" "clean": "rm -rf dist"
}, },
"files": [ "files": [
@@ -24,12 +25,12 @@
"devDependencies": { "devDependencies": {
"@rollup/plugin-node-resolve": "^16.0.1", "@rollup/plugin-node-resolve": "^16.0.1",
"@rollup/plugin-typescript": "^12.1.2", "@rollup/plugin-typescript": "^12.1.2",
"rollup": "^4.36.0", "rollup": "^4.41.1",
"rollup-plugin-dts": "^6.2.0", "rollup-plugin-dts": "^6.2.1",
"ts-node": "^10.9.2", "ts-node": "^10.9.2",
"tslib": "^2.8.1", "tslib": "^2.8.1",
"typescript": "^5.8.2", "typescript": "^5.8.3",
"zustand": "^5.0.3" "zustand": "^5.0.5"
}, },
"packageManager": "yarn@1.22.22", "packageManager": "yarn@1.22.22",
"publishConfig": { "publishConfig": {
@@ -58,6 +59,6 @@
} }
}, },
"dependencies": { "dependencies": {
"openai": "^4.88.0" "openai": "^5.0.1"
} }
} }

View File

@@ -1,6 +1,6 @@
# query # query
应的 fetch 内容的一部分功能的封装。 对 fetch 功能的的一部分功能的封装。主要处理header的token的提交和response中的处理json。
主要目的:请求路径默认`/api/router`,使用`post`,`post`的数据分流使用`path``key`. 主要目的:请求路径默认`/api/router`,使用`post`,`post`的数据分流使用`path``key`.
@@ -8,7 +8,6 @@
## query ## query
```ts ```ts
const query = new Query(); const query = new Query();
const res = await query.post({ const res = await query.post({
@@ -35,4 +34,21 @@ type Data = {
type DataOpts = Partial<QueryOpts> & { type DataOpts = Partial<QueryOpts> & {
beforeRequest?: Fn; beforeRequest?: Fn;
}; };
``` ```
## 适配的@kevisual/router的代码
```ts
import { App } from '@kevisual/router';
const app = new App();
app
.route({
path: 'demo',
key: '1',
})
.define(async (ctx) => {
ctx.body = 234;
})
.addTo(app);
```

View File

@@ -1,42 +1,89 @@
type AdapterOpts = { export const methods = ['GET', 'POST'] as const;
url: string; export type Method = (typeof methods)[number];
headers?: Record<string, string>;
body?: Record<string, any>;
timeout?: number;
};
type SimpleObject = Record<string, any>;
export type AdapterOpts = {
url?: string;
headers?: Record<string, string>;
body?: Record<string, any> | FormData; // body 可以是对象、字符串或 FormData
timeout?: number;
method?: Method;
isBlob?: boolean; // 是否返回 Blob 对象, 第一优先
isText?: boolean; // 是否返回文本内容, 第二优先
isPostFile?: boolean; // 是否为文件上传
};
export const isTextForContentType = (contentType: string | null) => {
if (!contentType) return false;
const textTypes = ['text/', 'xml', 'html', 'javascript', 'css', 'csv', 'plain', 'x-www-form-urlencoded'];
return textTypes.some((type) => contentType.includes(type));
};
/** /**
* *
* @param opts * @param opts
* @param overloadOpts 覆盖fetch的默认配置 * @param overloadOpts 覆盖fetch的默认配置
* @returns * @returns
*/ */
export const adapter = async (opts: AdapterOpts, overloadOpts?: RequestInit) => { export const adapter = async (opts: AdapterOpts = {}, overloadOpts?: RequestInit) => {
const controller = new AbortController(); const controller = new AbortController();
const signal = controller.signal; const signal = controller.signal;
const isBlob = opts.isBlob || false; // 是否返回 Blob 对象
const isText = opts.isText || false; // 是否返回文本内容
const isPostFile = opts.isPostFile || false; // 是否为文件上传
const timeout = opts.timeout || 60000 * 3; // 默认超时时间为 60s * 3 const timeout = opts.timeout || 60000 * 3; // 默认超时时间为 60s * 3
const timer = setTimeout(() => { const timer = setTimeout(() => {
controller.abort(); controller.abort();
}, timeout); }, timeout);
let method = overloadOpts?.method || opts?.method || 'POST';
return fetch(opts.url, { let headers = { ...opts?.headers, ...overloadOpts?.headers };
method: 'POST', let origin = '';
headers: { let url: URL;
if (opts?.url?.startsWith('http')) {
url = new URL(opts.url);
} else {
origin = window?.location?.origin || 'http://localhost:51015';
url = new URL(opts.url, origin);
}
const isGet = method === 'GET';
if (isGet) {
url.search = new URLSearchParams(opts.body as SimpleObject).toString();
}
let body: string | FormData | undefined = undefined;
if (isGet) {
body = undefined;
} else if (isPostFile) {
body = opts.body as FormData; // 如果是文件上传,直接使用 FormData
} else {
headers = {
'Content-Type': 'application/json', 'Content-Type': 'application/json',
...opts.headers, ...headers,
}, };
body: JSON.stringify(opts.body), body = JSON.stringify(opts.body); // 否则将对象转换为 JSON 字符串
}
return fetch(url, {
method: method.toUpperCase(),
signal, signal,
body: body,
...overloadOpts, ...overloadOpts,
headers: headers,
}) })
.then((response) => { .then(async (response) => {
// 获取 Content-Type 头部信息 // 获取 Content-Type 头部信息
const contentType = response.headers.get('Content-Type'); const contentType = response.headers.get('Content-Type');
if (isBlob) {
return await response.blob(); // 直接返回 Blob 对象
}
const isJson = contentType && contentType.includes('application/json');
// 判断返回的数据类型 // 判断返回的数据类型
if (contentType && contentType.includes('application/json')) { if (isJson && !isText) {
return response.json(); // 解析为 JSON return await response.json(); // 解析为 JSON
} else if (isTextForContentType(contentType)) {
return {
code: 200,
status: response.status,
data: await response.text(), // 直接返回文本内容
};
} else { } else {
return response.text(); // 解析为文本 return response;
} }
}) })
.catch((err) => { .catch((err) => {

View File

@@ -1,8 +1,11 @@
import { adapter } from './adapter.ts'; import { adapter } from './adapter.ts';
import { QueryWs, QueryWsOpts } from './ws.ts'; import { QueryWs, QueryWsOpts } from './ws.ts';
import { Query } from './query.ts'; import { Query, ClientQuery } from './query.ts';
import { BaseQuery, wrapperError } from './query.ts';
export { QueryOpts, QueryWs, Query, QueryWsOpts, adapter }; export { QueryOpts, QueryWs, ClientQuery, Query, QueryWsOpts, adapter, BaseQuery, wrapperError };
export type { DataOpts, Result, Data } from './query.ts';
type QueryOpts = { type QueryOpts = {
url?: string; url?: string;
@@ -12,14 +15,12 @@ type QueryOpts = {
}; };
/** /**
* 前端调用后端QueryRouter * 前端调用后端QueryRouter, 封装 beforeRequest 和 wss
*/ */
export class QueryClient extends Query { export class QueryClient extends Query {
tokenName: string; tokenName: string;
storage: Storage; storage: Storage;
token: string; token: string;
// 默认不使用ws
qws: QueryWs;
constructor(opts?: QueryOpts & { tokenName?: string; storage?: Storage; io?: boolean }) { constructor(opts?: QueryOpts & { tokenName?: string; storage?: Storage; io?: boolean }) {
super(opts); super(opts);
this.tokenName = opts?.tokenName || 'token'; this.tokenName = opts?.tokenName || 'token';

View File

@@ -1,4 +1,5 @@
import { adapter } from './adapter.ts'; import { adapter, isTextForContentType, Method, AdapterOpts } from './adapter.ts';
import type { QueryWs } from './ws.ts';
/** /**
* 请求前处理函数 * 请求前处理函数
* @param opts 请求配置 * @param opts 请求配置
@@ -10,14 +11,12 @@ export type Fn = (opts: {
body?: Record<string, any>; body?: Record<string, any>;
[key: string]: any; [key: string]: any;
timeout?: number; timeout?: number;
}) => Promise<Record<string, any>>; }) => Promise<Record<string, any> | false>;
export type QueryOpts = { export type QueryOpts = {
url?: string;
adapter?: typeof adapter; adapter?: typeof adapter;
headers?: Record<string, string>; [key: string]: any;
timeout?: number; } & AdapterOpts;
};
export type Data = { export type Data = {
path?: string; path?: string;
key?: string; key?: string;
@@ -44,7 +43,11 @@ export type Result<S = any> = {
// 额外功能 // 额外功能
export type DataOpts = Partial<QueryOpts> & { export type DataOpts = Partial<QueryOpts> & {
beforeRequest?: Fn; beforeRequest?: Fn;
afterResponse?: <S = any>(result: Result<S>, ctx?: { req?: any; res?: any; fetch?: any }) => Promise<S>; afterResponse?: <S = any>(result: Result<S>, ctx?: { req?: any; res?: any; fetch?: any }) => Promise<Result<S>>;
/**
* 是否在stop的时候不请求
*/
noStop?: boolean;
}; };
/** /**
* 设置基础响应, 设置 success 和 showError, * 设置基础响应, 设置 success 和 showError,
@@ -52,7 +55,7 @@ export type DataOpts = Partial<QueryOpts> & {
* showError 是 如果 success 为 false 且 noMsg 为 false, 则调用 showError * showError 是 如果 success 为 false 且 noMsg 为 false, 则调用 showError
* @param res 响应 * @param res 响应
*/ */
export const setBaseResponse = (res: Result) => { export const setBaseResponse = (res: Partial<Result>) => {
res.success = res.code === 200; res.success = res.code === 200;
/** /**
* 显示错误 * 显示错误
@@ -63,6 +66,19 @@ export const setBaseResponse = (res: Result) => {
fn?.(); fn?.();
} }
}; };
return res as Result;
};
export const wrapperError = ({ code, message }: { code?: number; message?: string }) => {
const result = {
code: code || 500,
success: false,
message: message || 'api request error',
showError: (fn?: () => void) => {
//
},
noMsg: true,
};
return result;
}; };
/** /**
* const query = new Query(); * const query = new Query();
@@ -76,7 +92,7 @@ export const setBaseResponse = (res: Result) => {
export class Query { export class Query {
adapter: typeof adapter; adapter: typeof adapter;
url: string; url: string;
beforeRequest?: Fn; beforeRequest?: DataOpts['beforeRequest'];
afterResponse?: DataOpts['afterResponse']; afterResponse?: DataOpts['afterResponse'];
headers?: Record<string, string>; headers?: Record<string, string>;
timeout?: number; timeout?: number;
@@ -84,6 +100,8 @@ export class Query {
* 需要突然停止请求比如401的时候 * 需要突然停止请求比如401的时候
*/ */
stop?: boolean; stop?: boolean;
// 默认不使用ws
qws: QueryWs;
constructor(opts?: QueryOpts) { constructor(opts?: QueryOpts) {
this.adapter = opts?.adapter || adapter; this.adapter = opts?.adapter || adapter;
@@ -93,6 +111,9 @@ export class Query {
}; };
this.timeout = opts?.timeout || 60000 * 3; // 默认超时时间为 60s * 3 this.timeout = opts?.timeout || 60000 * 3; // 默认超时时间为 60s * 3
} }
setQueryWs(qws: QueryWs) {
this.qws = qws;
}
/** /**
* 突然停止请求 * 突然停止请求
*/ */
@@ -120,31 +141,41 @@ export class Query {
*/ */
async post<R = any, P = any>(body: Data & P, options?: DataOpts): Promise<Result<R>> { async post<R = any, P = any>(body: Data & P, options?: DataOpts): Promise<Result<R>> {
const url = options?.url || this.url; const url = options?.url || this.url;
const headers = { ...this.headers, ...options?.headers }; const { headers, adapter, beforeRequest, afterResponse, timeout, ...rest } = options || {};
const adapter = options?.adapter || this.adapter; const _headers = { ...this.headers, ...headers };
const beforeRequest = options?.beforeRequest || this.beforeRequest; const _adapter = adapter || this.adapter;
const afterResponse = options?.afterResponse || this.afterResponse; const _beforeRequest = beforeRequest || this.beforeRequest;
const timeout = options?.timeout || this.timeout; const _afterResponse = afterResponse || this.afterResponse;
const _timeout = timeout || this.timeout;
const req = { const req = {
url: url, url: url,
headers: headers, headers: _headers,
body, body,
timeout, timeout: _timeout,
...rest,
}; };
try { try {
if (beforeRequest) { if (_beforeRequest) {
await beforeRequest(req); const res = await _beforeRequest(req);
if (res === false) {
return wrapperError({
code: 500,
message: 'request is cancel',
// @ts-ignore
req: req,
});
}
} }
} catch (e) { } catch (e) {
console.error('request beforeFn error', e, req); console.error('request beforeFn error', e, req);
return { return wrapperError({
code: 500, code: 500,
success: false,
message: 'api request beforeFn error', message: 'api request beforeFn error',
showError: () => {}, // @ts-ignore
}; req: req,
});
} }
if (this.stop) { if (this.stop && !options?.noStop) {
const that = this; const that = this;
await new Promise((resolve) => { await new Promise((resolve) => {
let timer = 0; let timer = 0;
@@ -160,11 +191,11 @@ export class Query {
}, 1000); }, 1000);
}); });
} }
return adapter(req).then(async (res) => { return _adapter(req).then(async (res) => {
try { try {
setBaseResponse(res); setBaseResponse(res);
if (afterResponse) { if (_afterResponse) {
return await afterResponse(res, { return await _afterResponse(res, {
req, req,
res, res,
fetch: adapter, fetch: adapter,
@@ -173,13 +204,13 @@ export class Query {
return res; return res;
} catch (e) { } catch (e) {
console.error('request error', e, req); console.error('request afterFn error', e, req);
return { return wrapperError({
code: 500, code: 500,
success: false,
message: 'api request afterFn error', message: 'api request afterFn error',
showError: () => {}, // @ts-ignore
}; req: req,
});
} }
}); });
} }
@@ -187,16 +218,65 @@ export class Query {
* 请求前处理,设置请求前处理函数 * 请求前处理,设置请求前处理函数
* @param fn 处理函数 * @param fn 处理函数
*/ */
before(fn: Fn) { before(fn: DataOpts['beforeRequest']) {
this.beforeRequest = fn; this.beforeRequest = fn;
} }
/** /**
* 请求后处理,设置请求后处理函数 * 请求后处理,设置请求后处理函数
* @param fn 处理函数 * @param fn 处理函数
*/ */
after(fn: (result: Result, req?: any) => Promise<any>) { after(fn: DataOpts['afterResponse']) {
this.afterResponse = fn; this.afterResponse = fn;
} }
async fetchText(urlOrOptions?: string | QueryOpts, options?: QueryOpts): Promise<Result<any>> {
let _options = { ...options };
if (typeof urlOrOptions === 'string' && !_options.url) {
_options.url = urlOrOptions;
}
if (typeof urlOrOptions === 'object') {
_options = { ...urlOrOptions, ..._options };
}
const res = await adapter({
method: 'GET',
..._options,
headers: {
...this.headers,
...(_options?.headers || {}),
},
});
return setBaseResponse(res);
}
} }
export { adapter }; export { adapter };
export class BaseQuery<T extends Query = Query, R extends { queryChain?: any; query?: any } = { queryChain: any; query?: T }> {
query: T;
queryDefine: R;
constructor(opts?: { query?: T; queryDefine?: R; clientQuery?: T }) {
if (opts?.clientQuery) {
this.query = opts.clientQuery;
} else {
this.query = opts?.query;
}
if (opts.queryDefine) {
this.queryDefine = opts.queryDefine;
this.queryDefine.query = this.query;
}
}
get chain(): R['queryChain'] {
return this.queryDefine.queryChain;
}
post<R = any, P = any>(data: P, options?: DataOpts): Promise<Result<R>> {
return this.query.post(data, options);
}
get<R = any, P = any>(data: P, options?: DataOpts): Promise<Result<R>> {
return this.query.get(data, options);
}
}
export class ClientQuery extends Query {
constructor(opts?: QueryOpts) {
super({ ...opts, url: opts?.url || '/client/router' });
}
}

View File

@@ -47,31 +47,42 @@ export class QueryWs {
*/ */
async connect(opts?: { timeout?: number }) { async connect(opts?: { timeout?: number }) {
const store = this.store; const store = this.store;
const that = this;
const connected = store.getState().connected; const connected = store.getState().connected;
if (connected) { if (connected) {
return Promise.resolve(true); return Promise.resolve(true);
} }
return new Promise((resolve, reject) => { return new Promise((resolve, reject) => {
const ws = this.ws || new WebSocket(this.url); const ws = that.ws || new WebSocket(that.url);
const timeout = opts?.timeout || 5 * 60 * 1000; // 默认 2 分钟 const timeout = opts?.timeout || 5 * 60 * 1000; // 默认 5 分钟
let timer = setTimeout(() => { let timer = setTimeout(() => {
console.error('WebSocket 连接超时'); const isOpen = ws.readyState === WebSocket.OPEN;
reject('timeout'); if (isOpen) {
console.log('WebSocket 连接成功 in timer');
resolve(true);
return;
}
console.error('WebSocket 连接超时', that.url);
resolve(false);
}, timeout); }, timeout);
ws.onopen = () => { ws.onopen = (ev) => {
store.getState().setConnected(true); store.getState().setConnected(true);
store.getState().setStatus('connected'); store.getState().setStatus('connected');
resolve(true); resolve(true);
clearTimeout(timer); clearTimeout(timer);
}; };
ws.onclose = () => { ws.onclose = (ev) => {
store.getState().setConnected(false); store.getState().setConnected(false);
store.getState().setStatus('disconnected'); store.getState().setStatus('disconnected');
this.ws = null; this.ws = null;
}; };
}); });
} }
/**
* ws.onopen 必须用这个去获取,否者会丢失链接信息
* @param callback
* @returns
*/
listenConnect(callback: () => void) { listenConnect(callback: () => void) {
const store = this.store; const store = this.store;
const { connected } = store.getState(); const { connected } = store.getState();
@@ -96,10 +107,41 @@ export class QueryWs {
); );
return cancel; return cancel;
} }
listenClose(callback: () => void) {
const store = this.store;
const { status } = store.getState();
if (status === 'disconnected') {
callback();
}
const subscriptionOne = (selector: (state: QueryWsStore) => QueryWsStore['status'], listener: QueryWsStoreListener) => {
const unsubscribe = store.subscribe((newState: any, oldState: any) => {
if (selector(newState) !== selector(oldState)) {
listener(newState, oldState);
unsubscribe();
}
});
return unsubscribe;
};
const cancel = subscriptionOne(
(state) => state.status,
(newState, oldState) => {
if (newState.status === 'disconnected') {
callback();
}
},
);
return cancel;
}
onMessage<T = any, U = any>( onMessage<T = any, U = any>(
fn: (data: U, event: MessageEvent) => void, fn: (data: U, event: MessageEvent) => void,
opts?: { opts?: {
/**
* 是否将数据转换为 JSON
*/
isJson?: boolean; isJson?: boolean;
/**
* 选择器
*/
selector?: (data: T) => U; selector?: (data: T) => U;
}, },
) { ) {
@@ -136,7 +178,26 @@ export class QueryWs {
store.getState().setConnected(false); store.getState().setConnected(false);
store.getState().setStatus('disconnected'); store.getState().setStatus('disconnected');
} }
send<T = any, U = any>(data: T, opts?: { isJson?: boolean; wrapper?: (data: T) => U }) { /**
* 发送消息
*
* @param data
* @param opts
* @returns
*/
send<T = any, U = any>(
data: T,
opts?: {
/**
* 是否将数据转换为 JSON
*/
isJson?: boolean;
/**
* 包装数据
*/
wrapper?: (data: T) => U;
},
) {
const ws = this.ws; const ws = this.ws;
const isJson = opts?.isJson ?? true; const isJson = opts?.isJson ?? true;
const wrapper = opts?.wrapper; const wrapper = opts?.wrapper;