cloud189-sdk 1.0.8 → 1.0.9

package/dist/CloudAuthClient.d.ts

@@ -1,5 +1,5 @@
 import { Got } from 'got';
-import { RefreshTokenSession, TokenSession, CacheQuery } from './types';
+import { RefreshTokenSession, TokenSession, CacheQuery, QRCodeData, QRCodeStatusResponse, QRLoginOptions } from './types';
 /**
  * @public
  */
@@ -38,4 +38,22 @@ export declare class CloudAuthClient {
      * 刷新token
      */
     refreshToken(refreshToken: string): Promise<RefreshTokenSession>;
+    /**
+     * Get QR code data for scanning login
+     * @returns QR code data including uuid for display
+     */
+    getQRCode(): Promise<QRCodeData>;
+    /**
+     * Check QR code scan status
+     * @param qrData - QR code data from getQRCode
+     * @returns status and redirectUrl on success
+     */
+    checkQRCodeStatus(qrData: QRCodeData): Promise<QRCodeStatusResponse>;
+    /**
+     * QR code login with polling
+     * @param onQRReady - callback invoked with QR code URL for display
+     * @param options - polling interval and timeout
+     * @returns token session
+     */
+    loginByQRCode(onQRReady: (qrUrl: string) => void, options?: QRLoginOptions): Promise<TokenSession>;
 }

package/dist/CloudAuthClient.js

@@ -13,6 +13,7 @@ exports.CloudAuthClient = void 0;
 const got_1 = __importDefault(require("got"));
 const log_1 = require("./log");
 const const_1 = require("./const");
+const types_1 = require("./types");
 const util_1 = require("./util");
 const hook_1 = require("./hook");
 /**
@@ -160,6 +161,89 @@ class CloudAuthClient {
         })
             .json();
     }
+    /**
+     * Get QR code data for scanning login
+     * @returns QR code data including uuid for display
+     */
+    async getQRCode() {
+        log_1.logger.debug('getQRCode...');
+        const loginForm = await this.getLoginForm();
+        const uuidRes = await this.authRequest
+            .post(`${const_1.AUTH_URL}/api/logbox/oauth2/getUUID.do`, {
+            headers: {
+                Referer: const_1.AUTH_URL
+            },
+            form: { appId: const_1.AppID }
+        })
+            .json();
+        if (!uuidRes.uuid || !uuidRes.encryuuid) {
+            throw new Error('Failed to get QR code UUID');
+        }
+        return {
+            uuid: uuidRes.uuid,
+            encryuuid: uuidRes.encryuuid,
+            reqId: loginForm.reqId,
+            lt: loginForm.lt,
+            paramId: loginForm.paramId
+        };
+    }
+    /**
+     * Check QR code scan status
+     * @param qrData - QR code data from getQRCode
+     * @returns status and redirectUrl on success
+     */
+    async checkQRCodeStatus(qrData) {
+        const now = new Date();
+        const pad = (n, len = 2) => String(n).padStart(len, '0');
+        const date = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}` +
+            `${pad(now.getHours())}:${pad(now.getMinutes())}:${pad(now.getSeconds())}.${pad(now.getMilliseconds(), 3)}`;
+        return this.authRequest
+            .post(`${const_1.AUTH_URL}/api/logbox/oauth2/qrcodeLoginState.do`, {
+            headers: {
+                Referer: const_1.AUTH_URL,
+                Reqid: qrData.reqId,
+                lt: qrData.lt
+            },
+            form: {
+                appId: const_1.AppID,
+                clientType: const_1.ClientType,
+                returnUrl: const_1.ReturnURL,
+                paramId: qrData.paramId,
+                uuid: qrData.uuid,
+                encryuuid: qrData.encryuuid,
+                date,
+                timeStamp: Date.now()
+            }
+        })
+            .json();
+    }
+    /**
+     * QR code login with polling
+     * @param onQRReady - callback invoked with QR code URL for display
+     * @param options - polling interval and timeout
+     * @returns token session
+     */
+    async loginByQRCode(onQRReady, options) {
+        var _a, _b;
+        log_1.logger.debug('loginByQRCode...');
+        const pollInterval = (_a = options === null || options === void 0 ? void 0 : options.pollInterval) !== null && _a !== void 0 ? _a : 3000;
+        const timeout = (_b = options === null || options === void 0 ? void 0 : options.timeout) !== null && _b !== void 0 ? _b : 120000;
+        const qrData = await this.getQRCode();
+        onQRReady(qrData.uuid);
+        const deadline = Date.now() + timeout;
+        while (Date.now() < deadline) {
+            const res = await this.checkQRCodeStatus(qrData);
+            if (res.status === types_1.QRCodeStatus.SUCCESS) {
+                log_1.logger.debug('QR code login success, getting session...');
+                return await this.getSessionForPC({ redirectURL: res.redirectUrl });
+            }
+            if (res.status === types_1.QRCodeStatus.EXPIRED) {
+                throw new Error('QR code expired');
+            }
+            await new Promise((resolve) => setTimeout(resolve, pollInterval));
+        }
+        throw new Error('QR code login timeout');
+    }
 }
 exports.CloudAuthClient = CloudAuthClient;
 _CloudAuthClient_builLoginForm = new WeakMap();

package/dist/CloudClient.d.ts

@@ -19,6 +19,8 @@ export declare class CloudClient {
     private sessionKeyPromise;
     private accessTokenPromise;
     private generateRsaKeyPromise;
+    private onQRCodeReady?;
+    private qrLoginOptions?;
     constructor(_options: ConfigurationOptions);
     getSession(): Promise<import("./types").TokenSession>;
     /**
@@ -79,7 +81,7 @@ export declare class CloudClient {
      * @param renameFolderRequest - 重名文件夹请求
      * @returns
      */
-    renameFolder(renameFolderRequest: RenameFolderRequest | RenameFamilyFolderRequest): import("got").CancelableRequest<unknown>;
+    renameFolder(renameFolderRequest: RenameFolderRequest | RenameFamilyFolderRequest): import("got/dist/source").CancelableRequest<unknown>;
     /**
      * 初始化上传
      * @param initMultiUploadRequest - 初始化请求
@@ -91,7 +93,7 @@ export declare class CloudClient {
      * @param commitMultiUploadRequest - 提交请求
      * @returns
      */
-    commitMultiUpload(commitMultiUploadRequest: CommitMultiUploadRequest | CommitMultiFamilyUploadRequest): import("got").CancelableRequest<UploadCommitResponse>;
+    commitMultiUpload(commitMultiUploadRequest: CommitMultiUploadRequest | CommitMultiFamilyUploadRequest): import("got/dist/source").CancelableRequest<UploadCommitResponse>;
     /**
      * 检测秒传
      * @param params - 检查参数
@@ -102,7 +104,7 @@ export declare class CloudClient {
         sliceMd5: string;
         uploadFileId: string;
         familyId?: number;
-    }): import("got").CancelableRequest<UploadInitResponse>;
+    }): import("got/dist/source").CancelableRequest<UploadInitResponse>;
     /**
      * 文件上传
      * @param param - 上传参数
@@ -157,7 +159,7 @@ export declare class CloudClient {
     getFileDownloadUrl(params: {
         fileId: string;
         familyId?: string;
-    }): import("got").CancelableRequest<{
+    }): import("got/dist/source").CancelableRequest<{
         fileDownloadUrl: string;
     }>;
 }

package/dist/CloudClient.js

@@ -43,13 +43,18 @@ class CloudClient {
             if (options.username && options.password) {
                 return;
             }
+            if (options.onQRCodeReady) {
+                return;
+            }
             log_1.logger.error('valid');
-            throw new Error('Please provide username and password or token or ssonCooike !');
+            throw new Error('Please provide username and password or token or ssonCooike or onQRCodeReady !');
         });
         __classPrivateFieldGet(this, _CloudClient_valid, "f").call(this, _options);
         this.username = _options.username;
         this.password = _options.password;
         this.ssonCookie = _options.ssonCookie;
+        this.onQRCodeReady = _options.onQRCodeReady;
+        this.qrLoginOptions = _options.qrLoginOptions;
         this.tokenStore = _options.token || new store_1.MemoryStore();
         this.authClient = new CloudAuthClient_1.CloudAuthClient();
         this.session = {
@@ -171,6 +176,20 @@ class CloudClient {
                 log_1.logger.error(e);
             }
         }
+        if (this.onQRCodeReady) {
+            try {
+                const loginToken = await this.authClient.loginByQRCode(this.onQRCodeReady, this.qrLoginOptions);
+                await this.tokenStore.update({
+                    accessToken: loginToken.accessToken,
+                    refreshToken: loginToken.refreshToken,
+                    expiresIn: new Date(Date.now() + 6 * 24 * 60 * 60 * 1000).getTime()
+                });
+                return loginToken;
+            }
+            catch (e) {
+                log_1.logger.error(e);
+            }
+        }
         throw new Error('Can not get session.');
     }
     /**

package/dist/cloud189-sdk.d.ts

@@ -0,0 +1,889 @@
+import { CancelableRequest } from 'got/dist/source';
+import { Got } from 'got';
+import { Logger } from '@netdrive-sdk/log';
+
+/**
+ * accessToken 结果
+ * @public
+ */
+export declare interface AccessTokenResponse {
+    /**
+     * accessToken
+     */
+    accessToken: string;
+    /**
+     * accessToken 的有效期 单位秒
+     */
+    expiresIn: number;
+}
+
+/**
+ * @public
+ */
+export declare interface CacheQuery {
+    captchaToken: string;
+    reqId: string;
+    lt: string;
+    paramId: string;
+}
+
+/**
+ * 容量信息
+ * @public
+ */
+export declare interface CapacityInfo {
+    /**
+     * 总空间 单位KB
+     */
+    totalSize: number;
+    /**
+     * 已使用空间 单位KB
+     */
+    usedSize: number;
+    /**
+     * 剩余空间 单位KB
+     */
+    freeSize: number;
+}
+
+/**
+ * @public
+ */
+export declare interface ClientSession {
+    accessToken: string;
+    sessionKey: string;
+}
+
+/**
+ * @public
+ */
+export declare class CloudAuthClient {
+    #private;
+    readonly authRequest: Got;
+    constructor();
+    /**
+     * 获取加密参数
+     * @returns
+     */
+    getEncrypt(): Promise<{
+        data: {
+            pubKey: string;
+            pre: string;
+        };
+    }>;
+    getLoginForm(): Promise<CacheQuery>;
+    getSessionForPC(param: {
+        redirectURL?: string;
+        accessToken?: string;
+    }): Promise<TokenSession>;
+    /**
+     * 用户名密码登录
+     * */
+    loginByPassword(username: string, password: string): Promise<TokenSession>;
+    /**
+     * token登录
+     */
+    loginByAccessToken(accessToken: string): Promise<TokenSession>;
+    /**
+     * sso登录
+     */
+    loginBySsoCooike(cookie: string): Promise<TokenSession>;
+    /**
+     * 刷新token
+     */
+    refreshToken(refreshToken: string): Promise<RefreshTokenSession>;
+    /**
+     * Get QR code data for scanning login
+     * @returns QR code data including uuid for display
+     */
+    getQRCode(): Promise<QRCodeData>;
+    /**
+     * Check QR code scan status
+     * @param qrData - QR code data from getQRCode
+     * @returns status and redirectUrl on success
+     */
+    checkQRCodeStatus(qrData: QRCodeData): Promise<QRCodeStatusResponse>;
+    /**
+     * QR code login with polling
+     * @param onQRReady - callback invoked with QR code URL for display
+     * @param options - polling interval and timeout
+     * @returns token session
+     */
+    loginByQRCode(onQRReady: (qrUrl: string) => void, options?: QRLoginOptions): Promise<TokenSession>;
+}
+
+/**
+ * 天翼网盘客户端
+ * @public
+ */
+export declare class CloudClient {
+    #private;
+    username: string;
+    password: string;
+    ssonCookie: string;
+    tokenStore: Store;
+    readonly request: Got;
+    readonly authClient: CloudAuthClient;
+    readonly session: ClientSession;
+    private rsaKey;
+    private sessionKeyPromise;
+    private accessTokenPromise;
+    private generateRsaKeyPromise;
+    private onQRCodeReady?;
+    private qrLoginOptions?;
+    constructor(_options: ConfigurationOptions);
+    getSession(): Promise<TokenSession>;
+    /**
+     * 获取 sessionKey
+     * @returns sessionKey
+     */
+    getSessionKey(): Promise<string>;
+    /**
+     * 获取 accessToken
+     * @returns accessToken
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * 获取 RSA key
+     * @returns RSAKey
+     */
+    generateRsaKey(): Promise<RsaKey>;
+    /**
+     * 获取用户网盘存储容量信息
+     * @returns 账号容量结果
+     */
+    getUserSizeInfo(): Promise<UserSizeInfoResponse>;
+    /**
+     * 个人签到任务
+     * @returns 签到结果
+     */
+    userSign(): Promise<UserSignResponse>;
+    /**
+     * 获取家庭信息
+     * @returns 家庭列表信息
+     */
+    getFamilyList(): Promise<FamilyListResponse>;
+    /**
+     * 家庭签到任务
+     * @param familyId - 家庭id
+     * @returns 签到结果
+     * @deprecated 已无效
+     */
+    familyUserSign(familyId: string): Promise<FamilyUserSignResponse>;
+    /**
+     * 获取文件列表
+     * @param pageQuery - 查询参数
+     * @returns
+     */
+    getListFiles(pageQuery?: PageQuery, familyId?: string): Promise<FileListResponse>;
+    /**
+     * 创建文件夹
+     * @param createFolderRequest - 创建文件夹请求
+     * @returns
+     */
+    createFolder(createFolderRequest: CreateFolderRequest | CreateFamilyFolderRequest): Promise<{
+        id: string;
+        name: string;
+        parentId: string;
+    }>;
+    /**
+     * 重命名文件夹
+     * @param renameFolderRequest - 重名文件夹请求
+     * @returns
+     */
+    renameFolder(renameFolderRequest: RenameFolderRequest | RenameFamilyFolderRequest): CancelableRequest<unknown>;
+    /**
+     * 初始化上传
+     * @param initMultiUploadRequest - 初始化请求
+     * @returns
+     */
+    initMultiUpload(initMultiUploadRequest: initMultiUploadRequest | initMultiFamilyUploadRequest): Promise<UploadInitResponse>;
+    /**
+     * 提交上传
+     * @param commitMultiUploadRequest - 提交请求
+     * @returns
+     */
+    commitMultiUpload(commitMultiUploadRequest: CommitMultiUploadRequest | CommitMultiFamilyUploadRequest): CancelableRequest<UploadCommitResponse>;
+    /**
+     * 检测秒传
+     * @param params - 检查参数
+     * @returns
+     */
+    checkTransSecond(params: {
+        fileMd5: string;
+        sliceMd5: string;
+        uploadFileId: string;
+        familyId?: number;
+    }): CancelableRequest<UploadInitResponse>;
+    /**
+     * 文件上传
+     * @param param - 上传参数
+     * @param callbacks - 上传回调
+     * @returns
+     */
+    upload(param: {
+        parentFolderId: string;
+        filePath: string;
+        familyId?: string;
+    }, callbacks?: UploadCallbacks): Promise<{
+        fileDataExists: number;
+        file: {
+            userFileId: string;
+            fileName: string;
+            fileSize: number;
+            fileMd5: string;
+            createDate: string;
+            rev: number;
+            userId: number;
+        };
+        code: string;
+    }>;
+    /**
+     * 检测任务状态
+     * @param type - 任务类型
+     * @param taskId - 任务Id
+     * @param maxAttempts - 重试次数
+     * @param interval - 重试间隔
+     * @returns
+     */
+    checkTaskStatus(type: string, taskId: string, maxAttempts?: number, interval?: number): Promise<{
+        successedFileIdList?: number[];
+        taskId: string;
+        taskStatus: number;
+    }>;
+    /**
+     * 创建任务
+     * @param createBatchTaskRequest - 创建任务参数
+     * @returns
+     */
+    createBatchTask(createBatchTaskRequest: CreateBatchTaskRequest | CreateFamilyBatchTaskRequest): Promise<{
+        successedFileIdList?: number[];
+        taskId: string;
+        taskStatus: number;
+    }>;
+    /**
+     * 获取文件下载路径
+     * @param params - 文件参数
+     * @returns
+     */
+    getFileDownloadUrl(params: {
+        fileId: string;
+        familyId?: string;
+    }): CancelableRequest<    {
+    fileDownloadUrl: string;
+    }>;
+}
+
+/**
+ * 提交家庭上传请求
+ * @public
+ */
+export declare interface CommitMultiFamilyUploadRequest extends FamilyRequest, CommitMultiUploadRequest {
+}
+
+/**
+ * 提交个人上传请求
+ * @public
+ */
+export declare interface CommitMultiUploadRequest {
+    fileMd5: string;
+    sliceMd5: string;
+    uploadFileId: string;
+    lazyCheck?: number;
+}
+
+/**
+ * 客户端初始化参数
+ * @public
+ */
+export declare interface ConfigurationOptions {
+    /** Login username */
+    username?: string;
+    /** Login password */
+    password?: string;
+    /** Token store */
+    token?: Store;
+    ssonCookie?: string;
+    /** Callback invoked with QR code URL when ready for scanning */
+    onQRCodeReady?: (qrUrl: string) => void;
+    /** QR code login options */
+    qrLoginOptions?: QRLoginOptions;
+}
+
+/**
+ * @public
+ */
+export declare interface CreateBatchTaskRequest {
+    type: TaskType;
+    taskInfos: [
+        {
+        fileId: string;
+        fileName?: string;
+        isFolder: number;
+        srcParentId?: string;
+    }
+    ];
+    targetFolderId?: string;
+}
+
+/**
+ * @public
+ */
+export declare interface CreateFamilyBatchTaskRequest extends FamilyRequest, CreateBatchTaskRequest {
+}
+
+/**
+ * 创建家庭文件夹
+ * @public
+ */
+export declare interface CreateFamilyFolderRequest extends FamilyRequest, CreateFolderRequest {
+}
+
+/**
+ * 创建个人文件夹
+ * @public
+ */
+export declare interface CreateFolderRequest {
+    parentFolderId: string;
+    folderName: string;
+}
+
+/**
+ * 账户家庭信息
+ * @public
+ */
+export declare interface FamilyListResponse {
+    familyInfoResp: [
+        {
+        /**
+         * 家庭id
+         */
+        familyId: string;
+        /**
+         * 家庭名称
+         */
+        remarkName: string;
+        /**
+         * 类型
+         */
+        type: number;
+        /**
+         * 用户角色 如果是1 表明当前账户是该账户的主家庭 否则当前账户是其他家庭的成员账户
+         */
+        userRole: number;
+    }
+    ];
+}
+
+/**
+ * 家庭请求
+ * @public
+ */
+export declare interface FamilyRequest {
+    familyId: string;
+}
+
+/**
+ * 家庭签到任务结果
+ * @public
+ */
+export declare interface FamilyUserSignResponse {
+    /**
+     * 签到的奖励容量 单位MB
+     */
+    bonusSpace: number;
+    /**
+     * 签到的家庭id
+     */
+    signFamilyId: number;
+    /**
+     * 签到的状态
+     */
+    signStatus: number;
+    /**
+     * 签到的时间
+     */
+    signTime: string;
+    /**
+     * 签到的用户
+     */
+    userId: string;
+}
+
+/**
+ * 文件项详细信息
+ * @public
+ */
+export declare interface FileItem {
+    /** 文件创建时间，格式：YYYY-MM-DD HH:mm:ss */
+    createDate: string;
+    /**
+     * 收藏标签
+     * 0-未收藏 | 1-已收藏
+     */
+    favoriteLabel: number;
+    /** 文件图标信息 */
+    icon: {
+        /** 大尺寸图标URL */
+        largeUrl: string;
+        /** 小尺寸图标URL */
+        smallUrl: string;
+    };
+    /** 文件唯一标识ID */
+    id: string;
+    /** 最后操作时间，格式：YYYY-MM-DD HH:mm:ss */
+    lastOpTime: string;
+    /** 文件MD5哈希值，用于文件校验 */
+    md5: string;
+    /**
+     * 媒体类型
+     * 1-图片 | 2-视频 | 3-音频 | 4-文档
+     */
+    mediaType: number;
+    /** 文件名 */
+    name: string;
+    /**
+     * 图片方向
+     * 0-正常 | 1-90° | 2-180° | 3-270°
+     */
+    orientation: number;
+    /** 父目录ID */
+    parentId: string;
+    /** 文件版本标识，格式：YYYYMMDDHHmmss */
+    rev: string;
+    /** 文件大小（字节） */
+    size: number;
+    /**
+     * 星标标签
+     * 1-普通 | 2-标星
+     */
+    starLabel: number;
+}
+
+/**
+ * 文件列表数据对象
+ * @public
+ */
+export declare interface FileListAO {
+    /** 文件总数 */
+    count: number;
+    /** 文件项列表 */
+    fileList: FileItem[];
+    /** 文件夹项列表 */
+    folderList: FolderItem[];
+}
+
+/**
+ * 文件列表API响应数据结构
+ * @public
+ */
+export declare interface FileListResponse {
+    /** 文件列表数据对象 */
+    fileListAO: FileListAO;
+    /**
+     * 最后修订版本号
+     * 用于增量同步的时间戳或版本标识
+     */
+    lastRev: number;
+}
+
+/**
+ * @public
+ */
+export declare class FileTokenStore extends MemoryStore {
+    #private;
+    filePath: string;
+    constructor(filePath: string);
+    private ensureTokenDirectory;
+    update(token: {
+        accessToken: string;
+        refreshToken?: string;
+        expiresIn?: number;
+    }): Promise<void>;
+}
+
+/**
+ * 文件夹项详细信息
+ * @public
+ */
+export declare interface FolderItem {
+    /** 文件夹创建时间，格式：YYYY-MM-DD HH:mm:ss */
+    createDate: string;
+    /** 文件夹内文件数量 */
+    fileCount: number;
+    /** 文件夹唯一标识ID */
+    id: string;
+    /** 最后操作时间，格式：YYYY-MM-DD HH:mm:ss */
+    lastOpTime: string;
+    /** 文件夹名称 */
+    name: string;
+    /** 父目录ID */
+    parentId: string;
+    /** 文件夹版本标识，格式：YYYYMMDDHHmmss */
+    rev: string;
+    /**
+     * 星标标签
+     * 1-普通 | 2-标星
+     */
+    starLabel: number;
+}
+
+/**
+ * 初始化家庭上传请求
+ * @public
+ */
+export declare interface initMultiFamilyUploadRequest extends FamilyRequest, initMultiUploadRequest {
+}
+
+/**
+ * 初始化个人上传请求
+ * @public
+ */
+export declare interface initMultiUploadRequest {
+    parentFolderId: string;
+    fileName: string;
+    fileSize: number;
+    sliceSize: number;
+    fileMd5?: string;
+    sliceMd5?: string;
+}
+
+/**
+ * 日志记录
+ * @public
+ */
+export declare const logger: Logger;
+
+/**
+ * 文件类型
+ * @public
+ */
+export declare enum MediaType {
+    ALL = 0,
+    IMAGE = 1,
+    MUSIC = 2,
+    VIDEO = 3,
+    TXT = 4
+}
+
+/**
+ * @public
+ */
+export declare class MemoryStore extends Store {
+    store: {
+        accessToken: string;
+        refreshToken: string;
+        expiresIn: number;
+    };
+    constructor();
+    get(): {
+        accessToken: string;
+        refreshToken: string;
+        expiresIn: number;
+    };
+    update(token: {
+        accessToken: string;
+        refreshToken?: string;
+        expiresIn?: number;
+    }): void;
+}
+
+/**
+ * @public
+ */
+export declare interface MultiUploadUrlsResponse extends UploadResponse {
+    uploadUrls: {
+        [key: PartNumberKey]: {
+            requestURL: string;
+            requestHeader: string;
+        };
+    };
+}
+
+/**
+ * 排序类型
+ * @public
+ */
+export declare enum OrderByType {
+    NAME = 1,
+    SIZE = 2,
+    LAST_OP_TIME = 3
+}
+
+/**
+ * 分页参数
+ * @public
+ */
+export declare interface PageQuery {
+    /**
+     * 分页大小 默认60
+     */
+    pageSize?: number;
+    /**
+     * 页码 默认1
+     */
+    pageNum?: number;
+    /**
+     * 文件类型
+     * 0 全部 1 图片 2 视频 3 文档
+     */
+    mediaType?: MediaType;
+    /**
+     * 文件夹Id
+     */
+    folderId?: string;
+    /**
+     * 未知参数 5
+     */
+    iconOption?: number;
+    /**
+     * 排序类型
+     * 1 文件名称 2 文件大小 3 文件修改时间
+     */
+    orderBy?: OrderByType;
+    /**
+     * 是否倒序
+     */
+    descending?: boolean;
+}
+
+/**
+ * @public
+ */
+export declare type PartNumberKey = `partNumber_${number}`;
+
+/**
+ * QR code data returned by getQRCode, used for polling status
+ * @public
+ */
+export declare interface QRCodeData {
+    uuid: string;
+    encryuuid: string;
+    reqId: string;
+    lt: string;
+    paramId: string;
+}
+
+/**
+ * QR code scan status enum
+ * @public
+ */
+export declare enum QRCodeStatus {
+    /** Login success */
+    SUCCESS = 0,
+    /** Waiting for user to scan */
+    WAITING = -106,
+    /** User scanned, waiting for confirmation on device */
+    SCANNED = -11002,
+    /** QR code expired */
+    EXPIRED = -11001
+}
+
+/**
+ * QR code status check response
+ * @public
+ */
+export declare interface QRCodeStatusResponse {
+    status: QRCodeStatus | number;
+    redirectUrl?: string;
+}
+
+/**
+ * QR code login options
+ * @public
+ */
+export declare interface QRLoginOptions {
+    /** Polling interval in ms, default 3000 */
+    pollInterval?: number;
+    /** Timeout in ms, default 120000 */
+    timeout?: number;
+}
+
+/**
+ * @public
+ */
+export declare interface RefreshTokenSession {
+    expiresIn: number;
+    accessToken: string;
+    refreshToken: string;
+}
+
+/**
+ * 创建家庭文件夹
+ * @public
+ */
+export declare interface RenameFamilyFolderRequest extends FamilyRequest, RenameFolderRequest {
+}
+
+/**
+ * 创建个人文件夹
+ * @public
+ */
+export declare interface RenameFolderRequest {
+    folderId: string;
+    folderName: string;
+}
+
+/**
+ * @public
+ */
+export declare interface RsaKey {
+    expire: number;
+    pkId: string;
+    pubKey: string;
+    ver: string;
+}
+
+/**
+ * RsaKey响应
+ * @public
+ */
+export declare interface RsaKeyResponse extends RsaKey {
+    res_code: number;
+    res_message: string;
+}
+
+/**
+ * @public
+ */
+export declare abstract class Store {
+    constructor();
+    abstract get(): {
+        accessToken: string;
+        refreshToken: string;
+        expiresIn: number;
+    } | Promise<{
+        accessToken: string;
+        refreshToken: string;
+        expiresIn: number;
+    }>;
+    abstract update(token: {
+        accessToken: string;
+        refreshToken?: string;
+        expiresIn?: number;
+    }): void | Promise<void>;
+}
+
+/**
+ * @public
+ */
+export declare type TaskType = 'DELETE' | 'MOVE' | 'COPY';
+
+/**
+ * @public
+ * accessToken 有效期7天，可以通过refreshToken取新的accessToken
+ */
+export declare interface TokenSession {
+    res_code: number;
+    res_message: string;
+    accessToken: string;
+    familySessionKey: string;
+    familySessionSecret: string;
+    refreshToken: string;
+    loginName: string;
+    sessionKey: string;
+}
+
+/**
+ * @public
+ */
+export declare interface UploadCallbacks {
+    onProgress?: (progress: number) => void;
+    onComplete?: (response: any) => void;
+    onError?: (error: Error) => void;
+}
+
+/**
+ * @public
+ */
+export declare interface UploadCommitResponse extends UploadResponse {
+    file: {
+        userFileId: string;
+        fileName: string;
+        fileSize: number;
+        fileMd5: string;
+        createDate: string;
+        rev: number;
+        userId: number;
+    };
+    /**
+     * 是否快传
+     */
+    fileDataExists: number;
+}
+
+/**
+ * @public
+ */
+export declare interface UploadInitResponse extends UploadResponse {
+    data: {
+        uploadType: number;
+        uploadHost: string;
+        uploadFileId: string;
+        fileDataExists: number;
+    };
+}
+
+/**
+ * @public
+ */
+export declare interface UploadPartsInfoResponse extends UploadResponse {
+    data: {
+        uploadFileId: string;
+        uploadedPartList: string;
+    };
+}
+
+/**
+ * @public
+ */
+export declare interface UploadResponse {
+    code: string;
+}
+
+/**
+ * 个人签到结果
+ * @public
+ */
+export declare interface UserSignResponse {
+    /**
+     * 是否已经签到过
+     */
+    isSign: boolean;
+    /**
+     * 签到获取的容量奖励 单位MB
+     */
+    netdiskBonus: number;
+}
+
+/**
+ * 账户容量信息
+ * @public
+ */
+export declare interface UserSizeInfoResponse {
+    /**
+     * 个人容量信息
+     */
+    cloudCapacityInfo: CapacityInfo;
+    /**
+     * 家庭容量信息
+     */
+    familyCapacityInfo: CapacityInfo;
+}
+
+/**
+ * 个人任务执行结果
+ * @public
+ */
+export declare interface UserTaskResponse {
+    /**
+     * 错误码
+     */
+    errorCode: string;
+    /**
+     * 奖励容量 单位MB
+     */
+    prizeName: string;
+}
+
+export { }

package/dist/types.d.ts

@@ -366,18 +366,65 @@ export interface CacheQuery {
     lt: string;
     paramId: string;
 }
+/**
+ * QR code data returned by getQRCode, used for polling status
+ * @public
+ */
+export interface QRCodeData {
+    uuid: string;
+    encryuuid: string;
+    reqId: string;
+    lt: string;
+    paramId: string;
+}
+/**
+ * QR code scan status enum
+ * @public
+ */
+export declare enum QRCodeStatus {
+    /** Login success */
+    SUCCESS = 0,
+    /** Waiting for user to scan */
+    WAITING = -106,
+    /** User scanned, waiting for confirmation on device */
+    SCANNED = -11002,
+    /** QR code expired */
+    EXPIRED = -11001
+}
+/**
+ * QR code status check response
+ * @public
+ */
+export interface QRCodeStatusResponse {
+    status: QRCodeStatus | number;
+    redirectUrl?: string;
+}
+/**
+ * QR code login options
+ * @public
+ */
+export interface QRLoginOptions {
+    /** Polling interval in ms, default 3000 */
+    pollInterval?: number;
+    /** Timeout in ms, default 120000 */
+    timeout?: number;
+}
 /**
  * 客户端初始化参数
  * @public
  */
 export interface ConfigurationOptions {
-    /** 登录名 */
+    /** Login username */
     username?: string;
-    /** 密码 */
+    /** Login password */
     password?: string;
-    /** token */
+    /** Token store */
     token?: Store;
     ssonCookie?: string;
+    /** Callback invoked with QR code URL when ready for scanning */
+    onQRCodeReady?: (qrUrl: string) => void;
+    /** QR code login options */
+    qrLoginOptions?: QRLoginOptions;
 }
 /**
  * @public

package/dist/types.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrderByType = exports.MediaType = void 0;
+exports.QRCodeStatus = exports.OrderByType = exports.MediaType = void 0;
 /**
  * 文件类型
  * @public
@@ -23,3 +23,18 @@ var OrderByType;
     OrderByType[OrderByType["SIZE"] = 2] = "SIZE";
     OrderByType[OrderByType["LAST_OP_TIME"] = 3] = "LAST_OP_TIME";
 })(OrderByType = exports.OrderByType || (exports.OrderByType = {}));
+/**
+ * QR code scan status enum
+ * @public
+ */
+var QRCodeStatus;
+(function (QRCodeStatus) {
+    /** Login success */
+    QRCodeStatus[QRCodeStatus["SUCCESS"] = 0] = "SUCCESS";
+    /** Waiting for user to scan */
+    QRCodeStatus[QRCodeStatus["WAITING"] = -106] = "WAITING";
+    /** User scanned, waiting for confirmation on device */
+    QRCodeStatus[QRCodeStatus["SCANNED"] = -11002] = "SCANNED";
+    /** QR code expired */
+    QRCodeStatus[QRCodeStatus["EXPIRED"] = -11001] = "EXPIRED";
+})(QRCodeStatus = exports.QRCodeStatus || (exports.QRCodeStatus = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloud189-sdk",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "基于node.js的第三方天翼云盘SDK",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",