@ybgnb/bili-api 0.0.1 → 0.0.2

package/dist/api/base.d.ts

@@ -0,0 +1,35 @@
+import type { BiliClient } from '../client/client.js';
+import type { ApiResponse, ApiResponseData, RawResponse, ReturnFormat, ReturnFormatMap } from '../types/core/response.js';
+import type { RequestOptions } from '../types/core/request.js';
+import type { BasePageStrategy } from './page/strategies/base.js';
+import { PageApi } from './page/page.js';
+/**
+ * 基础接口封装
+ */
+export declare class BaseApi {
+    client: BiliClient;
+    constructor(client: BiliClient);
+    get clientConfig(): import("../index.js").BiliClientConfig;
+    get logging(): import("../index.js").ClientLogging;
+    get isDebug(): boolean;
+    /**
+     * 记录接口成功的日志
+     */
+    logApiSuccess: (prefix: string, returnFormat: ReturnFormat, response: RawResponse | ApiResponse | ApiResponseData, logResponseData?: boolean) => void;
+    /**
+     * 记录接口错误的日志
+     */
+    logApiError: (prefix: string, error: unknown) => void;
+    request: <RData extends ApiResponseData = ApiResponseData, RRFormat extends ReturnFormat | undefined = undefined>(url: string, options?: Partial<RequestOptions<RRFormat>>) => Promise<ReturnFormatMap<RData, RRFormat>>;
+    get: <RData extends ApiResponseData = ApiResponseData, RRFormat extends ReturnFormat | undefined = undefined>(url: string, options?: Partial<RequestOptions<RRFormat>>) => Promise<ReturnFormatMap<RData, RRFormat>>;
+    post: <RData extends ApiResponseData = ApiResponseData, RRFormat extends ReturnFormat | undefined = undefined>(url: string, options?: Partial<RequestOptions<RRFormat>>) => Promise<ReturnFormatMap<RData, RRFormat>>;
+    save: <RData extends ApiResponseData = ApiResponseData, RRFormat extends ReturnFormat | undefined = undefined>(url: string, options?: Partial<RequestOptions<RRFormat>>) => Promise<ReturnFormatMap<RData, RRFormat>>;
+    /**
+     * 创建翻页器
+     * @param pageStrategy  分页策略
+     * @param url           请求url
+     * @param options       请求选项
+     */
+    createPager: <D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = D[]>(url: string, pageStrategy: BasePageStrategy, options?: Partial<RequestOptions<"ApiResponse">>) => PageApi<D, RD>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/api/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/api/base.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,KAAK,EACV,WAAW,EACX,eAAe,EACf,WAAW,EACX,YAAY,EACZ,eAAe,EAChB,MAAM,2BAA2B,CAAA;AAClC,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAG3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AAExC;;GAEG;AACH,qBAAa,OAAO;IACC,MAAM,EAAE,UAAU;gBAAlB,MAAM,EAAE,UAAU;IAErC,IAAW,YAAY,2CAEtB;IAED,IAAI,OAAO,wCAEV;IAED,IAAI,OAAO,YAEV;IAED;;OAEG;IACH,aAAa,GACX,QAAQ,MAAM,EACd,cAAc,YAAY,EAC1B,UAAU,WAAW,GAAG,WAAW,GAAG,eAAe,EACrD,kBAAkB,OAAO,UAc1B;IAED;;OAEG;IACH,WAAW,GAAI,QAAQ,MAAM,EAAE,OAAO,OAAO,UAW5C;IAED,OAAO,GACL,KAAK,SAAS,eAAe,GAAG,eAAe,EAC/C,QAAQ,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EAErD,KAAK,MAAM,EACX,UAAU,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,KAC1C,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAkH3C;IAED,GAAG,GAAU,KAAK,SAAS,eAAe,GAAG,eAAe,EAAE,QAAQ,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EACjH,KAAK,MAAM,EACX,UAAU,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,KAC1C,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAE3C;IAED,IAAI,GAAU,KAAK,SAAS,eAAe,GAAG,eAAe,EAAE,QAAQ,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EAClH,KAAK,MAAM,EACX,UAAU,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,KAC1C,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAE3C;IAED,IAAI,GAAU,KAAK,SAAS,eAAe,GAAG,eAAe,EAAE,QAAQ,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EAClH,KAAK,MAAM,EACX,UAAU,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,KAC1C,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAE3C;IAED;;;;;OAKG;IACI,WAAW,GAAI,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,CAAC,EAAE,EACjG,KAAK,MAAM,EACX,cAAc,gBAAgB,EAC9B,UAAU,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,oBAGjD;CACF"}

package/dist/api/base.js

@@ -0,0 +1,184 @@
+import { handleUrlParams, mergeParams, parseURL } from '../utils/url.js';
+import { BiliAbortError, BiliApiBusinessError, BiliApiHttpError, BiliError } from '../error/error.js';
+import { defaultRequestOptions } from '../config/config.js';
+import { PageApi } from './page/page.js';
+/**
+ * 基础接口封装
+ */
+export class BaseApi {
+    constructor(client) {
+        this.client = client;
+        /**
+         * 记录接口成功的日志
+         */
+        this.logApiSuccess = (prefix, returnFormat, response, logResponseData) => {
+            if (returnFormat === 'RawResponse') {
+                // this.logging.info(`${prefix} 请求成功 [RawResponse]`)
+                this.logging.info(`${prefix} 请求成功`);
+            }
+            else {
+                const rep = logResponseData || this.isDebug ? JSON.stringify(response) : '';
+                if (returnFormat === 'ApiResponse') {
+                    // this.logging.info(`${prefix} 请求成功 [ApiResponse]`, rep)
+                    this.logging.info(`${prefix} 请求成功`, rep);
+                }
+                else {
+                    this.logging.info(`${prefix} 请求成功`, rep);
+                }
+            }
+        };
+        /**
+         * 记录接口错误的日志
+         */
+        this.logApiError = (prefix, error) => {
+            // 规范化日志输出
+            if (error instanceof BiliAbortError) {
+                this.logging.info(`${prefix} [${error.message}]`);
+            }
+            else if (error instanceof BiliApiHttpError) {
+                this.logging.info(`${prefix} [http error]：${error.message}(${error.status})`);
+            }
+            else if (error instanceof BiliError) {
+                this.logging.info(`${prefix} ${error.message}`);
+            }
+            else {
+                this.logging.info(`${prefix} 出现未知错误`, error);
+            }
+        };
+        this.request = async (url, options) => {
+            const { context, userAgent, timeout: timeoutMS, referer } = this.clientConfig;
+            // 合并默认选项
+            const finalOptions = { ...defaultRequestOptions, url: url, ...options };
+            // 构建日志前缀
+            const userInfo = context?.userInfo.mid ? ` [${context?.userInfo.mid}]` : '';
+            const prefix = `[bili API]${userInfo} ${finalOptions.method} ${new URL(url).pathname}`;
+            try {
+                // 解析 url
+                const { baseUrl, searchParams } = parseURL(url);
+                // 构建查询字符串
+                const mergedParams = mergeParams(searchParams, finalOptions.query);
+                const searchStr = await handleUrlParams(mergedParams, finalOptions.skipWbiSign, finalOptions.wbiSignKeys);
+                // 最终的 url
+                const finalUrl = `${baseUrl}?${searchStr}`;
+                finalOptions.url = finalUrl;
+                if (finalOptions.logRequestParams) {
+                    this.logging.info(`${prefix} 请求中 ${searchStr}`);
+                }
+                else {
+                    this.logging.info(`${prefix} 请求中...`);
+                }
+                let requestBody = finalOptions.data;
+                if (requestBody) {
+                    if (typeof requestBody === 'object') {
+                        if (requestBody instanceof Blob) {
+                        }
+                        else if (requestBody instanceof URLSearchParams) {
+                        }
+                        else if (requestBody instanceof FormData) {
+                        }
+                        else {
+                            // RequestParams
+                            // 过滤掉 null/undefined，其余转字符串
+                            const cleaned = Object.fromEntries(Object.entries(requestBody)
+                                .filter(([, v]) => v != null)
+                                .map(([k, v]) => [k, String(v)]));
+                            requestBody = new URLSearchParams(cleaned);
+                        }
+                    }
+                    else if (typeof requestBody === 'string') {
+                        finalOptions.init = {
+                            ...finalOptions.init,
+                        };
+                        finalOptions.init.headers = {
+                            ...finalOptions.init.headers,
+                            'Content-Type': 'application/json',
+                        };
+                    }
+                }
+                if (finalOptions.method === 'POST') {
+                    // Content-Type 为 x-www-form-urlencoded 的请求时，判断是否需要自动添加 csrf 参数
+                    if (requestBody && finalOptions.autoCsrf && requestBody instanceof URLSearchParams) {
+                        requestBody.set('csrf', context?.userCookie.bili_jct ?? '');
+                    }
+                }
+                // 初始化 fetch 的配置
+                const fetchInit = {
+                    signal: options?.signal
+                        ? AbortSignal.any([options?.signal, AbortSignal.timeout(timeoutMS)])
+                        : AbortSignal.timeout(timeoutMS),
+                    method: finalOptions.method,
+                    body: requestBody,
+                    ...(options?.init ?? {}),
+                    headers: {
+                        'User-Agent': userAgent,
+                        cookie: finalOptions.cookie?.cookie || context?.userCookie.cookie || '',
+                        Referer: typeof referer === 'function' ? referer(finalUrl) : referer,
+                        ...(finalOptions?.init?.headers ?? {}),
+                    },
+                };
+                const httpResponse = await fetch(finalUrl, fetchInit);
+                if (!httpResponse.ok) {
+                    // http 请求错误
+                    throw new BiliApiHttpError(this.clientConfig, finalOptions, httpResponse);
+                }
+                if (finalOptions.returnFormat === 'RawResponse') {
+                    // 直接返回原始响应
+                    this.logApiSuccess(prefix, 'RawResponse', httpResponse, finalOptions.logResponseData);
+                    return httpResponse;
+                }
+                let biliResponse;
+                try {
+                    // 解析 bili 响应数据
+                    biliResponse = await httpResponse.json();
+                }
+                catch (e) {
+                    throw new BiliApiHttpError(this.clientConfig, finalOptions, httpResponse, '解析响应数据错误', e);
+                }
+                // 业务操作失败
+                if (!finalOptions.ignoreBusinessError && biliResponse.code !== 0) {
+                    throw new BiliApiBusinessError(this.clientConfig, finalOptions, biliResponse);
+                }
+                if (finalOptions.returnFormat === 'ApiResponse') {
+                    // 只需要返回响应数据
+                    this.logApiSuccess(prefix, 'ApiResponse', biliResponse, finalOptions.logResponseData);
+                    return biliResponse;
+                }
+                // 返回业务数据
+                this.logApiSuccess(prefix, 'ApiResponseData', biliResponse.data, finalOptions.logResponseData);
+                return biliResponse.data;
+            }
+            catch (error) {
+                this.logApiError(prefix, error);
+                throw error;
+            }
+        };
+        this.get = async (url, options) => {
+            return this.request(url, { ...options, method: 'GET' });
+        };
+        this.post = async (url, options) => {
+            return this.request(url, { ...options, method: 'POST' });
+        };
+        this.save = async (url, options) => {
+            return this.request(url, { ...options, method: 'POST', skipWbiSign: false, autoCsrf: true });
+        };
+        /**
+         * 创建翻页器
+         * @param pageStrategy  分页策略
+         * @param url           请求url
+         * @param options       请求选项
+         */
+        this.createPager = (url, pageStrategy, options) => {
+            return new PageApi(this, pageStrategy, { url, ...options });
+        };
+    }
+    get clientConfig() {
+        return this.client.config;
+    }
+    get logging() {
+        return this.clientConfig.logging;
+    }
+    get isDebug() {
+        return this.clientConfig.logLevel === 'debug';
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/api/base.js.map

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

package/dist/api/page/page.d.ts

@@ -0,0 +1,35 @@
+import { BaseApi } from '../base.js';
+import { WithApi } from '../with-api.js';
+import { BasePageStrategy } from './strategies/base.js';
+import type { RequestOptions, RequestParams } from '../../types/core/request.js';
+import type { ApiResponse, ApiResponseData } from '../../types/core/response.js';
+import type { OnPageFetched, PageRequestOptions } from '../../types/core/page.js';
+export declare class PageApi<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = D[]> extends WithApi {
+    protected pageStrategy: BasePageStrategy;
+    protected requestOptions: Partial<RequestOptions<'ApiResponse'>> & Required<Pick<RequestOptions, 'url' | 'query'>>;
+    protected requestParams: RequestParams;
+    nextPageNum: number;
+    list: D[];
+    lastApiResponse: ApiResponse<RD> | null;
+    /**
+     * 创建分页接口
+     * @param api           BaseApi
+     * @param pageStrategy  分页策略
+     * @param requestOptions  请求选项
+     */
+    constructor(api: BaseApi, pageStrategy: BasePageStrategy, requestOptions: Partial<RequestOptions<'ApiResponse'>> & Pick<RequestOptions, 'url'>);
+    protected mergeRequestOptions(requestOptions?: Partial<RequestOptions<'ApiResponse'>>): void;
+    /**
+     * 获取下一页的数据
+     */
+    fetchNext(requestOptions?: Partial<RequestOptions<'ApiResponse'>>): Promise<D[] | null>;
+    /**
+     * 获取翻页间隔时间
+     */
+    getRequestDelay(requestOptions?: Partial<PageRequestOptions<'ApiResponse'>>): number;
+    /**
+     * 获取所有数据（忽略之前的请求，从页码1重新开始）
+     */
+    fetchAllPage(onPageFetched?: OnPageFetched<D>, requestOptions?: Partial<PageRequestOptions<'ApiResponse'>>): Promise<D[]>;
+}
+//# sourceMappingURL=page.d.ts.map

package/dist/api/page/page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/api/page/page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAGhF,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAEjF,qBAAa,OAAO,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,CAAC,EAAE,CAAE,SAAQ,OAAO;IACjH,SAAS,CAAC,YAAY,EAAE,gBAAgB,CAAA;IACxC,SAAS,CAAC,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,GAAG,OAAO,CAAC,CAAC,CAAA;IAClH,SAAS,CAAC,aAAa,EAAE,aAAa,CAAA;IAGtC,WAAW,EAAE,MAAM,CAAA;IAEnB,IAAI,EAAE,CAAC,EAAE,CAAK;IAEd,eAAe,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,CAAO;IAE9C;;;;;OAKG;gBAED,GAAG,EAAE,OAAO,EACZ,YAAY,EAAE,gBAAgB,EAC9B,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC,GAAG,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC;IAkBtF,SAAS,CAAC,mBAAmB,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IAUrF;;OAEG;IACG,SAAS,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,aAAa,CAAC,CAAC;IA6BvE;;OAEG;IACH,eAAe,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;IAQ3E;;OAEG;IACG,YAAY,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC;CAsBjH"}

package/dist/api/page/page.js

@@ -0,0 +1,102 @@
+import { BaseApi } from '../base.js';
+import { WithApi } from '../with-api.js';
+import { BasePageStrategy } from './strategies/base.js';
+import { mergeParams, parseURL } from '../../utils/url.js';
+import { sleep } from '../../utils/time.js';
+export class PageApi extends WithApi {
+    /**
+     * 创建分页接口
+     * @param api           BaseApi
+     * @param pageStrategy  分页策略
+     * @param requestOptions  请求选项
+     */
+    constructor(api, pageStrategy, requestOptions) {
+        super(api);
+        // 所有已获取的数据
+        this.list = [];
+        // 最后一次的接口响应数据
+        this.lastApiResponse = null;
+        this.pageStrategy = pageStrategy;
+        if (pageStrategy.options.pageNum !== undefined) {
+            this.nextPageNum = pageStrategy.options.pageNum;
+        }
+        else {
+            this.nextPageNum = 1;
+        }
+        // 解析 url
+        const { baseUrl, searchParams } = parseURL(requestOptions.url);
+        // 合并查询参数
+        this.requestParams = mergeParams(searchParams, requestOptions.query);
+        this.requestOptions = { ...requestOptions, url: baseUrl, query: this.requestParams, returnFormat: 'ApiResponse' };
+    }
+    mergeRequestOptions(requestOptions) {
+        this.requestParams = { ...this.requestParams, ...requestOptions?.query };
+        this.requestOptions = {
+            ...this.requestOptions,
+            ...requestOptions,
+            query: this.requestParams,
+            returnFormat: 'ApiResponse',
+        };
+    }
+    /**
+     * 获取下一页的数据
+     */
+    async fetchNext(requestOptions) {
+        this.mergeRequestOptions(requestOptions);
+        // 判断是否有下一页
+        if (!this.pageStrategy.hasNextPage(this.nextPageNum, this.list, this.lastApiResponse)) {
+            return null;
+        }
+        // 更新下一页的查询参数
+        this.pageStrategy.updateNextPageParams(this.nextPageNum, this.requestParams, this.list, this.lastApiResponse);
+        // 获取数据
+        const response = await this.get(this.requestOptions.url, this.requestOptions);
+        this.lastApiResponse = response;
+        if (response.data == null) {
+            return null;
+        }
+        this.nextPageNum++;
+        // 解析当前页的数据
+        const currPageList = this.pageStrategy.getList(response);
+        if (currPageList.length <= 0) {
+            // 数据为空
+            return null;
+        }
+        this.list.push(...currPageList);
+        return currPageList;
+    }
+    /**
+     * 获取翻页间隔时间
+     */
+    getRequestDelay(requestOptions) {
+        return typeof requestOptions?.delay === 'function'
+            ? requestOptions.delay(this.nextPageNum)
+            : typeof requestOptions?.delay === 'number'
+                ? requestOptions.delay
+                : 1122;
+    }
+    /**
+     * 获取所有数据（忽略之前的请求，从页码1重新开始）
+     */
+    async fetchAllPage(onPageFetched, requestOptions) {
+        this.mergeRequestOptions(requestOptions);
+        this.nextPageNum = 1;
+        this.list = [];
+        this.lastApiResponse = null;
+        while (true) {
+            const currList = await this.fetchNext(requestOptions);
+            if (currList === null)
+                break;
+            if (onPageFetched && (await onPageFetched(currList, this.list)) === false) {
+                // 回调方法返回false，结束流程
+                break;
+            }
+            await sleep(this.getRequestDelay(requestOptions), this.requestOptions.signal);
+            if (this.requestOptions.signal?.aborted) {
+                break;
+            }
+        }
+        return this.list;
+    }
+}
+//# sourceMappingURL=page.js.map

package/dist/api/page/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../../src/api/page/page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAGvD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC1D,OAAO,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAA;AAG3C,MAAM,OAAO,OAAuF,SAAQ,OAAO;IAYjH;;;;;OAKG;IACH,YACE,GAAY,EACZ,YAA8B,EAC9B,cAAoF;QAEpF,KAAK,CAAC,GAAG,CAAC,CAAA;QAhBZ,WAAW;QACX,SAAI,GAAQ,EAAE,CAAA;QACd,cAAc;QACd,oBAAe,GAA2B,IAAI,CAAA;QAc5C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAEhC,IAAI,YAAY,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAA;QACjD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,GAAG,CAAC,CAAA;QACtB,CAAC;QAED,SAAS;QACT,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,QAAQ,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;QAC9D,SAAS;QACT,IAAI,CAAC,aAAa,GAAG,WAAW,CAAC,YAAY,EAAE,cAAc,CAAC,KAAK,CAAC,CAAA;QACpE,IAAI,CAAC,cAAc,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,CAAA;IACnH,CAAC;IAES,mBAAmB,CAAC,cAAuD;QACnF,IAAI,CAAC,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,GAAG,cAAc,EAAE,KAAK,EAAE,CAAA;QACxE,IAAI,CAAC,cAAc,GAAG;YACpB,GAAG,IAAI,CAAC,cAAc;YACtB,GAAG,cAAc;YACjB,KAAK,EAAE,IAAI,CAAC,aAAa;YACzB,YAAY,EAAE,aAAa;SAC5B,CAAA;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,CAAC,cAAuD;QACrE,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAA;QAExC,WAAW;QACX,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YACtF,OAAO,IAAI,CAAA;QACb,CAAC;QAED,aAAa;QACb,IAAI,CAAC,YAAY,CAAC,oBAAoB,CAAQ,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,CAAA;QAEpH,OAAO;QACP,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAoB,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC,cAAc,CAAC,CAAA;QAChG,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAA;QAC/B,IAAI,QAAQ,CAAC,IAAI,IAAI,IAAI,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAA;QACb,CAAC;QACD,IAAI,CAAC,WAAW,EAAE,CAAA;QAClB,WAAW;QACX,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAQ,QAAQ,CAAC,CAAA;QAC/D,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC7B,OAAO;YACP,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAA;QAC/B,OAAO,YAAY,CAAA;IACrB,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,cAA2D;QACzE,OAAO,OAAO,cAAc,EAAE,KAAK,KAAK,UAAU;YAChD,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC;YACxC,CAAC,CAAC,OAAO,cAAc,EAAE,KAAK,KAAK,QAAQ;gBACzC,CAAC,CAAC,cAAc,CAAC,KAAK;gBACtB,CAAC,CAAC,IAAI,CAAA;IACZ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,aAAgC,EAAE,cAA2D;QAC9G,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAAC,CAAA;QACxC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,EAAE,CAAA;QACd,IAAI,CAAC,eAAe,GAAG,IAAI,CAAA;QAE3B,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAA;YACrD,IAAI,QAAQ,KAAK,IAAI;gBAAE,MAAK;YAE5B,IAAI,aAAa,IAAI,CAAC,MAAM,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;gBAC1E,mBAAmB;gBACnB,MAAK;YACP,CAAC;YAED,MAAM,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,cAAc,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;YAC7E,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;gBACxC,MAAK;YACP,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;CACF"}

package/dist/api/page/strategies/base.d.ts

@@ -0,0 +1,30 @@
+import type { RequestParams } from '../../../types/core/request.js';
+import type { ApiResponse, ApiResponseData } from '../../../types/core/response.js';
+import type { PageOptions } from '../../../types/core/page.js';
+/**
+ * 分页策略
+ */
+export declare abstract class BasePageStrategy {
+    options: PageOptions;
+    constructor(options: PageOptions);
+    /**
+     * 是否有下一页
+     * @param nextPageNum     下一页的页码
+     * @param list            所有已获取的数据
+     * @param lastResponse    最后一次的接口响应数据
+     */
+    abstract hasNextPage<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = D[]>(nextPageNum: number, list: D[], lastResponse: ApiResponse<RD> | null): boolean;
+    /**
+     * 更新下一页的查询参数
+     * @param nextPageNum     下一页的页码
+     * @param queryParams     已有的查询参数
+     * @param list            所有已获取的数据
+     * @param lastResponse    最后一次的接口响应数据
+     */
+    abstract updateNextPageParams<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = D[]>(nextPageNum: number, queryParams: RequestParams, list: D[], lastResponse: ApiResponse<RD> | null): void;
+    /**
+     * 解析响应的列表数据
+     */
+    abstract getList<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = D[]>(response: ApiResponse<RD>): D[];
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/api/page/strategies/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/api/page/strategies/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAE9D;;GAEG;AACH,8BAAsB,gBAAgB;IACjB,OAAO,EAAE,WAAW;gBAApB,OAAO,EAAE,WAAW;IAEvC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,CAAC,EAAE,EAChG,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,CAAC,EAAE,EACT,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,GACnC,OAAO;IAEV;;;;;;OAMG;IACH,QAAQ,CAAC,oBAAoB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,CAAC,EAAE,EACzG,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,aAAa,EAC1B,IAAI,EAAE,CAAC,EAAE,EACT,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,GACnC,IAAI;IAEP;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,CAAC,EAAE,EAC5F,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC,GACxB,CAAC,EAAE;CACP"}

package/dist/api/page/strategies/base.js

@@ -0,0 +1,9 @@
+/**
+ * 分页策略
+ */
+export class BasePageStrategy {
+    constructor(options) {
+        this.options = options;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/api/page/strategies/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/api/page/strategies/base.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAgB,gBAAgB;IACpC,YAAmB,OAAoB;QAApB,YAAO,GAAP,OAAO,CAAa;IAAG,CAAC;CAkC5C"}

package/dist/api/page/strategies/has-more.d.ts

@@ -0,0 +1,15 @@
+import { BasePageStrategy } from './base.js';
+import type { RequestParams } from '../../../types/core/request.js';
+import type { ApiResponse, ApiResponseData } from '../../../types/core/response.js';
+import type { HasMorePageData, PageOptions } from '../../../types/core/page.js';
+/**
+ * 响应有has_more的分页策略
+ */
+export declare class HasMorePageStrategy extends BasePageStrategy {
+    protected listKey: string;
+    constructor(options: PageOptions, listKey?: string);
+    hasNextPage<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = HasMorePageData>(nextPageNum: number, list: D[], lastResponse: ApiResponse<RD> | null): boolean;
+    updateNextPageParams<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = HasMorePageData>(nextPageNum: number, queryParams: RequestParams, _list: D[], _lastResponse: ApiResponse<RD> | null): void;
+    getList<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = HasMorePageData>(response: ApiResponse<RD>): D[];
+}
+//# sourceMappingURL=has-more.d.ts.map

package/dist/api/page/strategies/has-more.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-more.d.ts","sourceRoot":"","sources":["../../../../src/api/page/strategies/has-more.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAE/E;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,gBAAgB;IAGrD,SAAS,CAAC,OAAO,EAAE,MAAM;gBADzB,OAAO,EAAE,WAAW,EACV,OAAO,GAAE,MAAe;IAKpC,WAAW,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,eAAe,EACnG,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,CAAC,EAAE,EACT,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI;IAUtC,oBAAoB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,eAAe,EAC5G,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,aAAa,EAC1B,KAAK,EAAE,CAAC,EAAE,EACV,aAAa,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,GACpC,IAAI;IAKP,OAAO,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,eAAe,EAC/F,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC,GACxB,CAAC,EAAE;CAIP"}

package/dist/api/page/strategies/has-more.js

@@ -0,0 +1,26 @@
+import { BasePageStrategy } from './base.js';
+/**
+ * 响应有has_more的分页策略
+ */
+export class HasMorePageStrategy extends BasePageStrategy {
+    constructor(options, listKey = 'list') {
+        super(options);
+        this.listKey = listKey;
+    }
+    hasNextPage(nextPageNum, list, lastResponse) {
+        if (lastResponse !== null && lastResponse.data) {
+            const rep = lastResponse.data;
+            return rep.has_more;
+        }
+        return true;
+    }
+    updateNextPageParams(nextPageNum, queryParams, _list, _lastResponse) {
+        queryParams['ps'] = this.options.pageSize;
+        queryParams['pn'] = nextPageNum;
+    }
+    getList(response) {
+        const rep = response.data;
+        return rep[this.listKey];
+    }
+}
+//# sourceMappingURL=has-more.js.map

package/dist/api/page/strategies/has-more.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"has-more.js","sourceRoot":"","sources":["../../../../src/api/page/strategies/has-more.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAK5C;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,gBAAgB;IACvD,YACE,OAAoB,EACV,UAAkB,MAAM;QAElC,KAAK,CAAC,OAAO,CAAC,CAAA;QAFJ,YAAO,GAAP,OAAO,CAAiB;IAGpC,CAAC;IAED,WAAW,CACT,WAAmB,EACnB,IAAS,EACT,YAAoC;QAEpC,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;YAC/C,MAAM,GAAG,GAAG,YAAY,CAAC,IAAkC,CAAA;YAC3D,OAAO,GAAG,CAAC,QAAQ,CAAA;QACrB,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED,oBAAoB,CAClB,WAAmB,EACnB,WAA0B,EAC1B,KAAU,EACV,aAAqC;QAErC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;QACzC,WAAW,CAAC,IAAI,CAAC,GAAG,WAAW,CAAA;IACjC,CAAC;IAED,OAAO,CACL,QAAyB;QAEzB,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAkC,CAAA;QACvD,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAQ,CAAA;IACjC,CAAC;CACF"}

package/dist/api/page/strategies/list.d.ts

@@ -0,0 +1,12 @@
+import { BasePageStrategy } from './base.js';
+import type { RequestParams } from '../../../types/core/request.js';
+import type { ApiResponse, ApiResponseData } from '../../../types/core/response.js';
+/**
+ * 简单的列表分页策略（rep.data为数组）
+ */
+export declare class ListPageStrategy extends BasePageStrategy {
+    hasNextPage<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = D[]>(nextPageNum: number, list: D[], lastResponse: ApiResponse<RD> | null): boolean;
+    updateNextPageParams<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = D[]>(nextPageNum: number, queryParams: RequestParams, _list: D[], _lastResponse: ApiResponse<RD> | null): void;
+    getList<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = D[]>(response: ApiResponse<RD>): D[];
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/api/page/strategies/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/api/page/strategies/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACnE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAGnF;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;IACpD,WAAW,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,CAAC,EAAE,EACvF,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,CAAC,EAAE,EACT,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI;IAuBtC,oBAAoB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,CAAC,EAAE,EAChG,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,aAAa,EAC1B,KAAK,EAAE,CAAC,EAAE,EACV,aAAa,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,GACpC,IAAI;IAKP,OAAO,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,CAAC,EAAE,EACnF,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC,GACxB,CAAC,EAAE;CAGP"}

package/dist/api/page/strategies/list.js

@@ -0,0 +1,31 @@
+import { BasePageStrategy } from './base.js';
+import { isEmptyArr } from '../../../utils/arr.js';
+/**
+ * 简单的列表分页策略（rep.data为数组）
+ */
+export class ListPageStrategy extends BasePageStrategy {
+    hasNextPage(nextPageNum, list, lastResponse) {
+        if (this.options.total !== undefined &&
+            (list.length >= this.options.total || (nextPageNum - 1) * this.options.pageSize >= this.options.total)) {
+            // 已获取的数据个数 >= 数据总数
+            return false;
+        }
+        if (lastResponse !== null) {
+            if (lastResponse.data === null ||
+                isEmptyArr(lastResponse.data) ||
+                this.getList(lastResponse).length < this.options.pageSize) {
+                // 前一次的请求数据为空/已结束（这里简单列表接口才判断length，其他接口可能实际收到的分页数量小于pageSize参数）
+                return false;
+            }
+        }
+        return true;
+    }
+    updateNextPageParams(nextPageNum, queryParams, _list, _lastResponse) {
+        queryParams['ps'] = this.options.pageSize;
+        queryParams['pn'] = nextPageNum;
+    }
+    getList(response) {
+        return response.data;
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/api/page/strategies/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../../src/api/page/strategies/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAG5C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IACpD,WAAW,CACT,WAAmB,EACnB,IAAS,EACT,YAAoC;QAEpC,IACE,IAAI,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS;YAChC,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,EACtG,CAAC;YACD,mBAAmB;YACnB,OAAO,KAAK,CAAA;QACd,CAAC;QAED,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,IACE,YAAY,CAAC,IAAI,KAAK,IAAI;gBAC1B,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC;gBAC7B,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EACzD,CAAC;gBACD,gEAAgE;gBAChE,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,oBAAoB,CAClB,WAAmB,EACnB,WAA0B,EAC1B,KAAU,EACV,aAAqC;QAErC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAA;QACzC,WAAW,CAAC,IAAI,CAAC,GAAG,WAAW,CAAA;IACjC,CAAC;IAED,OAAO,CACL,QAAyB;QAEzB,OAAO,QAAQ,CAAC,IAAsB,CAAA;IACxC,CAAC;CACF"}

package/dist/api/page/strategies/total.d.ts

@@ -0,0 +1,12 @@
+import type { ApiResponse, ApiResponseData } from '../../../types/core/response.js';
+import { ListPageStrategy } from './list.js';
+import type { PageDataWithTotal } from '../../../types/core/page.js';
+/**
+ * 响应包含total的分页策略
+ */
+export declare class ResponseWithTotalStrategy extends ListPageStrategy {
+    protected static isPageDataWithTotalResponse<D extends ApiResponseData = ApiResponseData>(resp: ApiResponse<unknown> | null): resp is ApiResponse<PageDataWithTotal<D>>;
+    hasNextPage<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = PageDataWithTotal<D>>(nextPageNum: number, list: D[], lastResponse: ApiResponse<RD> | null): boolean;
+    getList<D extends ApiResponseData = ApiResponseData, RD extends ApiResponseData = PageDataWithTotal<D>>(response: ApiResponse<RD>): D[];
+}
+//# sourceMappingURL=total.d.ts.map

package/dist/api/page/strategies/total.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"total.d.ts","sourceRoot":"","sources":["../../../../src/api/page/strategies/total.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAGpE;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;IAC7D,SAAS,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EACtF,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,IAAI,GAChC,IAAI,IAAI,WAAW,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAU5C,WAAW,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,iBAAiB,CAAC,CAAC,CAAC,EACxG,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,CAAC,EAAE,EACT,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI;IAiBtC,OAAO,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,EAAE,SAAS,eAAe,GAAG,iBAAiB,CAAC,CAAC,CAAC,EACpG,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC,GACxB,CAAC,EAAE;CAKP"}

package/dist/api/page/strategies/total.js

@@ -0,0 +1,33 @@
+import { ListPageStrategy } from './list.js';
+import { isEmptyArr } from '../../../utils/arr.js';
+/**
+ * 响应包含total的分页策略
+ */
+export class ResponseWithTotalStrategy extends ListPageStrategy {
+    static isPageDataWithTotalResponse(resp) {
+        return (resp !== null &&
+            typeof resp.data === 'object' &&
+            resp.data !== null &&
+            'total' in resp.data &&
+            'list' in resp.data);
+    }
+    hasNextPage(nextPageNum, list, lastResponse) {
+        if (!super.hasNextPage(nextPageNum, list, lastResponse)) {
+            return false;
+        }
+        if (lastResponse !== null) {
+            if (!ResponseWithTotalStrategy.isPageDataWithTotalResponse(lastResponse))
+                return false;
+            if (lastResponse.data.total <= list.length || isEmptyArr(lastResponse.data.list)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    getList(response) {
+        if (!ResponseWithTotalStrategy.isPageDataWithTotalResponse(response))
+            return [];
+        return response.data.list;
+    }
+}
+//# sourceMappingURL=total.js.map

package/dist/api/page/strategies/total.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"total.js","sourceRoot":"","sources":["../../../../src/api/page/strategies/total.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAE5C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElD;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IACnD,MAAM,CAAC,2BAA2B,CAC1C,IAAiC;QAEjC,OAAO,CACL,IAAI,KAAK,IAAI;YACb,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YAC7B,IAAI,CAAC,IAAI,KAAK,IAAI;YAClB,OAAO,IAAI,IAAI,CAAC,IAAI;YACpB,MAAM,IAAI,IAAI,CAAC,IAAI,CACpB,CAAA;IACH,CAAC;IAED,WAAW,CACT,WAAmB,EACnB,IAAS,EACT,YAAoC;QAEpC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAQ,WAAW,EAAE,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;YAC/D,OAAO,KAAK,CAAA;QACd,CAAC;QAED,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,yBAAyB,CAAC,2BAA2B,CAAI,YAAY,CAAC;gBAAE,OAAO,KAAK,CAAA;YAEzF,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,MAAM,IAAI,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjF,OAAO,KAAK,CAAA;YACd,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,CACL,QAAyB;QAEzB,IAAI,CAAC,yBAAyB,CAAC,2BAA2B,CAAI,QAAQ,CAAC;YAAE,OAAO,EAAE,CAAA;QAElF,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAA;IAC3B,CAAC;CACF"}

package/dist/api/with-api.d.ts

@@ -0,0 +1,18 @@
+import type { BaseApi } from './base.js';
+/**
+ * API 能力基类
+ *  为业务模块（如 Service、Pager）提供统一的底层 API 访问权限。
+ *  包含基础请求方法、全局配置以及日志工具的受保护接口。
+ */
+export declare abstract class WithApi {
+    protected readonly api: BaseApi;
+    constructor(api: BaseApi);
+    get clientConfig(): import("../index.js").BiliClientConfig;
+    get logging(): import("../index.js").ClientLogging;
+    protected get request(): <RData extends unknown = any, RRFormat extends import("../index.js").ReturnFormat | undefined = undefined>(url: string, options?: Partial<import("../index.js").RequestOptions<RRFormat>> | undefined) => Promise<import("../index.js").ReturnFormatMap<RData, RRFormat>>;
+    protected get get(): <RData extends unknown = any, RRFormat extends import("../index.js").ReturnFormat | undefined = undefined>(url: string, options?: Partial<import("../index.js").RequestOptions<RRFormat>> | undefined) => Promise<import("../index.js").ReturnFormatMap<RData, RRFormat>>;
+    protected get post(): <RData extends unknown = any, RRFormat extends import("../index.js").ReturnFormat | undefined = undefined>(url: string, options?: Partial<import("../index.js").RequestOptions<RRFormat>> | undefined) => Promise<import("../index.js").ReturnFormatMap<RData, RRFormat>>;
+    protected get save(): <RData extends unknown = any, RRFormat extends import("../index.js").ReturnFormat | undefined = undefined>(url: string, options?: Partial<import("../index.js").RequestOptions<RRFormat>> | undefined) => Promise<import("../index.js").ReturnFormatMap<RData, RRFormat>>;
+    get currUser(): import("../index.js").UserCard | undefined;
+}
+//# sourceMappingURL=with-api.d.ts.map

package/dist/api/with-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-api.d.ts","sourceRoot":"","sources":["../../src/api/with-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC;;;;GAIG;AACH,8BAAsB,OAAO;IACR,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO;gBAAZ,GAAG,EAAE,OAAO;IAElD,IAAW,YAAY,2CAEtB;IAED,IAAW,OAAO,wCAEjB;IAED,SAAS,KAAK,OAAO,8QAEpB;IAED,SAAS,KAAK,GAAG,8QAEhB;IAED,SAAS,KAAK,IAAI,8QAEjB;IAED,SAAS,KAAK,IAAI,8QAEjB;IAED,IAAW,QAAQ,+CAElB;CACF"}