@byted-apaas/server-sdk-node 0.0.2-beta.1

package/context/resources/IResources.ts

@@ -0,0 +1,73 @@
+import { Stream } from "stream";
+import { _KunlunOpenSDKFile } from "./impl/resources";
+import { UploadFileResp } from "../../request/interface";
+
+export interface _FileInfo {
+    id: string;
+}
+
+export interface _IKunlunFile {
+    /**
+     * 上传文件
+     * @param filePath 文件路径
+     * @param expire 文件过期时间，可选，单位：秒
+     */
+    upload(filePath: string, expire?: number): Promise<UploadFileResp>;
+    /**
+     * 上传文件
+     * @param stream 文件流
+     * @param expire 文件过期时间，可选，单位：秒
+     */
+    upload(stream: Stream, expire?: number): Promise<UploadFileResp>;
+    /**
+     * 下载文件
+     * @param fileToken 文件令牌
+     */
+    download(fileToken: string): Promise<Buffer>;
+
+    /**
+     * 下载文件
+     * @param fileToken 文件令牌
+     * @param filePath 文件保存的路径
+     */
+    download(fileToken: string, filePath: string): Promise<void>;
+
+    /**
+     * 下载文件
+     * @param fileInfo 文件信息
+     */
+    download(fileInfo: _FileInfo): Promise<Buffer>;
+
+    /**
+     * 下载文件
+     * @param fileInfo 文件信息
+     * @param filePath 文件保存的路径
+     */
+    download(fileInfo: _FileInfo, filePath: string): Promise<void>;
+}
+
+export type FileUploadResult = {
+    fileId: string;
+    type: string;
+    name: string;
+    size: number;
+};
+
+export type UploadAvatarResult = {
+    ImageId: string;
+    PreviewImageId: string;
+};
+export interface _IOpenSDKFile {
+    Upload(fileName: string, path: string): Promise<FileUploadResult>;
+    Upload(fileName: string, reader: Stream): Promise<FileUploadResult>;
+    Upload(fileName: string, buffer: Buffer): Promise<FileUploadResult>;
+    UploadAvatar(fileName: string, path: string): Promise<UploadAvatarResult>;
+    UploadAvatar(fileName: string, reader: Stream): Promise<UploadAvatarResult>;
+    UploadAvatar(fileName: string, buffer: Buffer): Promise<UploadAvatarResult>;
+    Download(fileID: string): Promise<Buffer>;
+    DownloadAvatar(imageID: string): Promise<Buffer>;
+}
+
+export interface _IOpenSDKResources {
+    file: _IOpenSDKFile;
+}

package/context/resources/impl/resources.d.ts

@@ -0,0 +1,42 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import { Stream } from "stream";
+import { _FileInfo, _IKunlunFile, _IOpenSDKFile, UploadAvatarResult, FileUploadResult } from "../IResources";
+import * as Request from "../../../request/interface";
+import { AppCtx } from "../../../application/application";
+export declare class _KunlunOpenSDKFile implements _IOpenSDKFile {
+    appCtx: AppCtx;
+    constructor(appCtx: AppCtx);
+    Upload(fileName: string, path: string): Promise<FileUploadResult>;
+    Upload(fileName: string, reader: Stream): Promise<FileUploadResult>;
+    Upload(fileName: string, buffer: Buffer): Promise<FileUploadResult>;
+    UploadAvatar(fileName: string, path: string): Promise<UploadAvatarResult>;
+    UploadAvatar(fileName: string, reader: Stream): Promise<UploadAvatarResult>;
+    UploadAvatar(fileName: string, buffer: Buffer): Promise<UploadAvatarResult>;
+    Download(fileID: string): Promise<Buffer>;
+    DownloadAvatar(imageID: string): Promise<Buffer>;
+}
+export declare class _KunlunFile implements _IKunlunFile {
+    download(fileToken: string): Promise<Buffer>;
+    download(fileToken: string, filePath?: string): Promise<void>;
+    download(fileToken: _FileInfo): Promise<Buffer>;
+    download(fileInfo: _FileInfo, filePath: string): Promise<void>;
+    upload(filePath: string): Promise<Request.UploadFileResp>;
+    upload(stream: Stream): Promise<Request.UploadFileResp>;
+    upload(filePath: string, expire: number): Promise<Request.UploadFileResp>;
+    upload(stream: Stream, expire: number): Promise<Request.UploadFileResp>;
+}
+/**
+ * OpenSDK 静态资源操作类
+ */
+export declare class _OpenSDKResources {
+    file: _IOpenSDKFile;
+    constructor(appCtx: AppCtx);
+}
+/**
+ * 静态资源操作类
+ */
+export declare class _Resources {
+    file: _IKunlunFile;
+    constructor();
+}

package/context/resources/impl/resources.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._Resources = exports._OpenSDKResources = exports._KunlunFile = exports._KunlunOpenSDKFile = void 0;
+const stream_1 = require("stream");
+const Request = require("../../../request/interface");
+const common_1 = require("../../../application/impl/common");
+const common = require("@byted-apaas/server-common-node");
+const stream_to_buffer_1 = require("@jorgeferrero/stream-to-buffer");
+const exceptions = common.exceptions;
+const fs = require('fs');
+class _KunlunOpenSDKFile {
+    constructor(appCtx) {
+        this.appCtx = appCtx;
+    }
+    async Upload(fileName, source) {
+        // 1. check parameters type
+        if (typeof fileName !== 'string') {
+            throw new exceptions.InvalidParamError('upload method parameter fileName must be string. ');
+        }
+        if (typeof source !== 'string' && !(source instanceof stream_1.Stream) && !(source instanceof Buffer)) {
+            throw new exceptions.InvalidParamError('upload method parameter source must be string or stream or buffer. ');
+        }
+        // 2. divide by source type
+        if (typeof source === 'string') {
+            // upload from path
+            if (!fs.existsSync(source)) {
+                throw new exceptions.InvalidParamError(`no such file '${source}'`);
+            }
+            source = fs.createReadStream(source);
+        }
+        if (source instanceof stream_1.Stream) {
+            // upload from stream
+            source = await (0, stream_to_buffer_1.streamToBuffer)(source);
+        }
+        if (source instanceof Buffer) {
+            return await (0, common_1.runCtxForOpenSDK)(this.appCtx, async () => {
+                return await Request.GetInstance().openSDKUploadFile(fileName, source);
+            });
+        }
+        return null;
+    }
+    ;
+    async UploadAvatar(fileName, source) {
+        // 1. check parameters type
+        if (typeof fileName !== 'string') {
+            throw new exceptions.InvalidParamError('upload method parameter fileName must be string. ');
+        }
+        if (typeof source !== 'string' && !(source instanceof stream_1.Stream) && !(source instanceof Buffer)) {
+            throw new exceptions.InvalidParamError('upload method parameter source must be string or stream or buffer. ');
+        }
+        // 2. divide by source type
+        if (typeof source === 'string') {
+            // upload from path
+            if (!fs.existsSync(source)) {
+                throw new exceptions.InvalidParamError(`no such file '${source}'`);
+            }
+            source = fs.createReadStream(source);
+        }
+        if (source instanceof stream_1.Stream) {
+            // upload from stream
+            source = await (0, stream_to_buffer_1.streamToBuffer)(source);
+        }
+        if (source instanceof Buffer) {
+            // upload from buffer
+            return await (0, common_1.runCtxForOpenSDK)(this.appCtx, async () => {
+                return await Request.GetInstance().openSDKUploadAvatar(fileName, source);
+            });
+        }
+        return null;
+    }
+    ;
+    async Download(fileID) {
+        // 1. check parameters type
+        if (typeof fileID !== 'string') {
+            throw new exceptions.InvalidParamError('download method parameter fileID must be string. ');
+        }
+        return await (0, common_1.runCtxForOpenSDK)(this.appCtx, async () => {
+            return await Request.GetInstance().downloadFileByID(fileID);
+        });
+    }
+    ;
+    async DownloadAvatar(imageID) {
+        // 1. check parameters type
+        if (typeof imageID !== 'string') {
+            throw new exceptions.InvalidParamError('download method parameter imageID must be string. ');
+        }
+        return await (0, common_1.runCtxForOpenSDK)(this.appCtx, async () => {
+            return await Request.GetInstance().openSDKDownloadAvatar(imageID);
+        });
+    }
+    ;
+}
+exports._KunlunOpenSDKFile = _KunlunOpenSDKFile;
+class _KunlunFile {
+    async download(fileTokenOrInfo, filePath) {
+        if (typeof (fileTokenOrInfo) === "string") {
+            return await Request.GetInstance().downloadFileByToken(fileTokenOrInfo, filePath);
+        }
+        else if (typeof (fileTokenOrInfo) === "object") {
+            if (!fileTokenOrInfo.id) {
+                throw new exceptions.InvalidParamError(`The value of fileInfo.id is empty`);
+            }
+            if (typeof (fileTokenOrInfo.id) !== "string") {
+                throw new exceptions.InvalidParamError(`The type of fileInfo.id should be string, but ${typeof (fileTokenOrInfo)}`);
+            }
+            return await Request.GetInstance().downloadFileByID(fileTokenOrInfo.id, filePath);
+        }
+        else {
+            throw new exceptions.InvalidParamError(`The type of first param should be string or object, but ${typeof (fileTokenOrInfo)}`);
+        }
+    }
+    async upload(data, expire, ...ret) {
+        if (ret.length > 0) {
+            throw new exceptions.InvalidParamError(`params is too many, as ${ret.length + 2}`);
+        }
+        if (!data) {
+            throw new exceptions.InvalidParamError(`params is null`);
+        }
+        // 1. data is filePath, read it from disk, convert it to Steam.
+        if (typeof (data) === 'string') {
+            if (!fs.existsSync(data)) {
+                throw new exceptions.InvalidParamError(`no such file '${data}'`);
+            }
+            data = fs.createReadStream(data);
+        }
+        // 2. data must be Stream at here.
+        return await Request.GetInstance().uploadFile(data, expire);
+    }
+}
+exports._KunlunFile = _KunlunFile;
+/**
+ * OpenSDK 静态资源操作类
+ */
+class _OpenSDKResources {
+    constructor(appCtx) {
+        this.file = new _KunlunOpenSDKFile(appCtx);
+    }
+}
+exports._OpenSDKResources = _OpenSDKResources;
+/**
+ * 静态资源操作类
+ */
+class _Resources {
+    constructor() {
+        this.file = new _KunlunFile();
+    }
+}
+exports._Resources = _Resources;
+//# sourceMappingURL=resources.js.map

package/context/resources/impl/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["resources.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAEhC,sDAAsD;AACtD,6DAAoE;AACpE,0DAAyD;AAEzD,qEAAgE;AAEhE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;AAErC,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEzB,MAAa,kBAAkB;IAG3B,YAAY,MAAc;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAKD,KAAK,CAAC,MAAM,CAAC,QAAgB,EAAE,MAAgC;QAC3D,2BAA2B;QAC3B,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;YAC9B,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,mDAAmD,CAAC,CAAC;SAC/F;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,YAAY,eAAM,CAAC,IAAI,CAAC,CAAC,MAAM,YAAY,MAAM,CAAC,EAAE;YAC1F,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,qEAAqE,CAAC,CAAC;SACjH;QACD,2BAA2B;QAC3B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;YAC5B,mBAAmB;YACnB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;gBACxB,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,iBAAiB,MAAM,GAAG,CAAC,CAAA;aACrE;YACD,MAAM,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;SACxC;QACD,IAAI,MAAM,YAAY,eAAM,EAAE;YAC1B,qBAAqB;YACrB,MAAM,GAAG,MAAM,IAAA,iCAAc,EAAC,MAAa,CAAC,CAAC;SAChD;QACD,IAAI,MAAM,YAAY,MAAM,EAAE;YAC1B,OAAO,MAAM,IAAA,yBAAgB,EAAC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;gBAClD,OAAO,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,iBAAiB,CAAC,QAAQ,EAAE,MAAgB,CAAC,CAAC;YACrF,CAAC,CAAC,CAAC;SACN;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAAA,CAAC;IAIF,KAAK,CAAC,YAAY,CAAC,QAAgB,EAAE,MAAgC;QACjE,2BAA2B;QAC3B,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE;YAC9B,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,mDAAmD,CAAC,CAAC;SAC/F;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,YAAY,eAAM,CAAC,IAAI,CAAC,CAAC,MAAM,YAAY,MAAM,CAAC,EAAE;YAC1F,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,qEAAqE,CAAC,CAAC;SACjH;QACD,2BAA2B;QAC3B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;YAC5B,mBAAmB;YACnB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE;gBACxB,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,iBAAiB,MAAM,GAAG,CAAC,CAAA;aACrE;YACD,MAAM,GAAG,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;SACxC;QACD,IAAI,MAAM,YAAY,eAAM,EAAE;YAC1B,qBAAqB;YACrB,MAAM,GAAG,MAAM,IAAA,iCAAc,EAAC,MAAa,CAAC,CAAC;SAChD;QACD,IAAI,MAAM,YAAY,MAAM,EAAE;YAC1B,qBAAqB;YACrB,OAAO,MAAM,IAAA,yBAAgB,EAAC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;gBAClD,OAAO,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAgB,CAAC,CAAC;YACvF,CAAC,CAAC,CAAA;SACL;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAAA,CAAC;IACF,KAAK,CAAC,QAAQ,CAAC,MAAc;QACzB,2BAA2B;QAC3B,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;YAC5B,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,mDAAmD,CAAC,CAAC;SAC/F;QACD,OAAO,MAAM,IAAA,yBAAgB,EAAC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;YAClD,OAAO,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAW,CAAC;QAC1E,CAAC,CAAC,CAAA;IACN,CAAC;IAAA,CAAC;IACF,KAAK,CAAC,cAAc,CAAC,OAAe;QAChC,2BAA2B;QAC3B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE;YAC7B,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,oDAAoD,CAAC,CAAC;SAChG;QACD,OAAO,MAAM,IAAA,yBAAgB,EAAC,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;YAClD,OAAO,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,OAAO,CAAW,CAAC;QAChF,CAAC,CAAC,CAAA;IACN,CAAC;IAAA,CAAC;CACL;AAtFD,gDAsFC;AAED,MAAa,WAAW;IAKpB,KAAK,CAAC,QAAQ,CAAC,eAAmC,EAAE,QAAiB;QACjE,IAAI,OAAO,CAAC,eAAe,CAAC,KAAK,QAAQ,EAAE;YACvC,OAAO,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,mBAAmB,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC;SACrF;aAAM,IAAI,OAAO,CAAC,eAAe,CAAC,KAAK,QAAQ,EAAE;YAC9C,IAAI,CAAC,eAAe,CAAC,EAAE,EAAE;gBACrB,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,mCAAmC,CAAC,CAAC;aAC/E;YAED,IAAI,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,KAAK,QAAQ,EAAE;gBAC1C,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,iDAAiD,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;aACvH;YACD,OAAO,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,gBAAgB,CAAC,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;SACrF;aAAM;YACH,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,2DAA2D,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;SACjI;IACL,CAAC;IAMD,KAAK,CAAC,MAAM,CAAC,IAAqB,EAAE,MAAe,EAAE,GAAG,GAAa;QACjE,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE;YAChB,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,0BAA0B,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,CAAA;SACrF;QACD,IAAI,CAAC,IAAI,EAAE;YACP,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAA;SAC3D;QAED,+DAA+D;QAC/D,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ,EAAE;YAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;gBACtB,MAAM,IAAI,UAAU,CAAC,iBAAiB,CAAC,iBAAiB,IAAI,GAAG,CAAC,CAAA;aACnE;YACD,IAAI,GAAG,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;SACpC;QAED,kCAAkC;QAClC,OAAO,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,IAAc,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC;CACJ;AA7CD,kCA6CC;AAED;;GAEG;AACH,MAAa,iBAAiB;IAG1B,YAAY,MAAc;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;CACJ;AAND,8CAMC;AAED;;GAEG;AACH,MAAa,UAAU;IAInB;QACI,IAAI,CAAC,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,CAAC;CAEJ;AARD,gCAQC"}

package/context/resources/impl/resources.ts

@@ -0,0 +1,170 @@
+import { Stream } from "stream";
+import { _FileInfo, _IKunlunFile, _IOpenSDKFile, UploadAvatarResult, FileUploadResult } from "../IResources";
+import * as Request from "../../../request/interface";
+import { runCtxForOpenSDK } from "../../../application/impl/common";
+import * as common from "@byted-apaas/server-common-node"
+import { AppCtx } from "../../../application/application";
+import { streamToBuffer } from "@jorgeferrero/stream-to-buffer";
+
+const exceptions = common.exceptions;
+
+const fs = require('fs');
+
+export class _KunlunOpenSDKFile implements _IOpenSDKFile {
+    appCtx: AppCtx
+
+    constructor(appCtx: AppCtx) {
+        this.appCtx = appCtx;
+    }
+
+    async Upload(fileName: string, path: string): Promise<FileUploadResult>;
+    async Upload(fileName: string, reader: Stream): Promise<FileUploadResult>;
+    async Upload(fileName: string, buffer: Buffer): Promise<FileUploadResult>;
+    async Upload(fileName: string, source: string | Stream | Buffer): Promise<FileUploadResult> {
+        // 1. check parameters type
+        if (typeof fileName !== 'string') {
+            throw new exceptions.InvalidParamError('upload method parameter fileName must be string. ');
+        }
+        if (typeof source !== 'string' && !(source instanceof Stream) && !(source instanceof Buffer)) {
+            throw new exceptions.InvalidParamError('upload method parameter source must be string or stream or buffer. ');
+        }
+        // 2. divide by source type
+        if (typeof source === 'string') {
+            // upload from path
+            if (!fs.existsSync(source)) {
+                throw new exceptions.InvalidParamError(`no such file '${source}'`)
+            }
+            source = fs.createReadStream(source);
+        }
+        if (source instanceof Stream) {
+            // upload from stream
+            source = await streamToBuffer(source as any);
+        }
+        if (source instanceof Buffer) {
+            return await runCtxForOpenSDK(this.appCtx, async () => {
+                return await Request.GetInstance().openSDKUploadFile(fileName, source as Buffer);
+            });
+        }
+        return null;
+    };
+    async UploadAvatar(fileName: string, path: string): Promise<UploadAvatarResult>;
+    async UploadAvatar(fileName: string, reader: Stream): Promise<UploadAvatarResult>;
+    async UploadAvatar(fileName: string, buffer: Buffer): Promise<UploadAvatarResult>;
+    async UploadAvatar(fileName: string, source: string | Stream | Buffer): Promise<UploadAvatarResult> {
+        // 1. check parameters type
+        if (typeof fileName !== 'string') {
+            throw new exceptions.InvalidParamError('upload method parameter fileName must be string. ');
+        }
+        if (typeof source !== 'string' && !(source instanceof Stream) && !(source instanceof Buffer)) {
+            throw new exceptions.InvalidParamError('upload method parameter source must be string or stream or buffer. ');
+        }
+        // 2. divide by source type
+        if (typeof source === 'string') {
+            // upload from path
+            if (!fs.existsSync(source)) {
+                throw new exceptions.InvalidParamError(`no such file '${source}'`)
+            }
+            source = fs.createReadStream(source);
+        }
+        if (source instanceof Stream) {
+            // upload from stream
+            source = await streamToBuffer(source as any);
+        }
+        if (source instanceof Buffer) {
+            // upload from buffer
+            return await runCtxForOpenSDK(this.appCtx, async () => {
+                return await Request.GetInstance().openSDKUploadAvatar(fileName, source as Buffer);
+            })
+        }
+        return null;
+    };
+    async Download(fileID: string): Promise<Buffer> {
+        // 1. check parameters type
+        if (typeof fileID !== 'string') {
+            throw new exceptions.InvalidParamError('download method parameter fileID must be string. ');
+        }
+        return await runCtxForOpenSDK(this.appCtx, async () => {
+            return await Request.GetInstance().downloadFileByID(fileID) as Buffer;
+        })
+    };
+    async DownloadAvatar(imageID: string): Promise<Buffer> {
+        // 1. check parameters type
+        if (typeof imageID !== 'string') {
+            throw new exceptions.InvalidParamError('download method parameter imageID must be string. ');
+        }
+        return await runCtxForOpenSDK(this.appCtx, async () => {
+            return await Request.GetInstance().openSDKDownloadAvatar(imageID) as Buffer;
+        })
+    };
+}
+
+export class _KunlunFile implements _IKunlunFile {
+    async download(fileToken: string): Promise<Buffer>;
+    async download(fileToken: string, filePath?: string): Promise<void>;
+    async download(fileToken: _FileInfo): Promise<Buffer>;
+    async download(fileInfo: _FileInfo, filePath: string): Promise<void>;
+    async download(fileTokenOrInfo: string | _FileInfo, filePath?: string): Promise<Buffer | void> {
+        if (typeof (fileTokenOrInfo) === "string") {
+            return await Request.GetInstance().downloadFileByToken(fileTokenOrInfo, filePath);
+        } else if (typeof (fileTokenOrInfo) === "object") {
+            if (!fileTokenOrInfo.id) {
+                throw new exceptions.InvalidParamError(`The value of fileInfo.id is empty`);
+            }
+
+            if (typeof (fileTokenOrInfo.id) !== "string") {
+                throw new exceptions.InvalidParamError(`The type of fileInfo.id should be string, but ${typeof (fileTokenOrInfo)}`);
+            }
+            return await Request.GetInstance().downloadFileByID(fileTokenOrInfo.id, filePath);
+        } else {
+            throw new exceptions.InvalidParamError(`The type of first param should be string or object, but ${typeof (fileTokenOrInfo)}`);
+        }
+    }
+
+    async upload(filePath: string): Promise<Request.UploadFileResp>;
+    async upload(stream: Stream): Promise<Request.UploadFileResp>;
+    async upload(filePath: string, expire: number): Promise<Request.UploadFileResp>;
+    async upload(stream: Stream, expire: number): Promise<Request.UploadFileResp>;
+    async upload(data: string | Stream, expire?: number, ...ret: string[]): Promise<Request.UploadFileResp> {
+        if (ret.length > 0) {
+            throw new exceptions.InvalidParamError(`params is too many, as ${ret.length + 2}`)
+        }
+        if (!data) {
+            throw new exceptions.InvalidParamError(`params is null`)
+        }
+
+        // 1. data is filePath, read it from disk, convert it to Steam.
+        if (typeof (data) === 'string') {
+            if (!fs.existsSync(data)) {
+                throw new exceptions.InvalidParamError(`no such file '${data}'`)
+            }
+            data = fs.createReadStream(data);
+        }
+
+        // 2. data must be Stream at here.
+        return await Request.GetInstance().uploadFile(data as Stream, expire);
+    }
+}
+
+/**
+ * OpenSDK 静态资源操作类
+ */
+export class _OpenSDKResources {
+    file: _IOpenSDKFile;
+
+    constructor(appCtx: AppCtx) {
+        this.file = new _KunlunOpenSDKFile(appCtx);
+    }
+}
+
+/**
+ * 静态资源操作类
+ */
+export class _Resources {
+
+    file: _IKunlunFile;
+
+    constructor() {
+        this.file = new _KunlunFile();
+    }
+
+}

package/context/tasks/tasks.d.ts

@@ -0,0 +1,33 @@
+export declare class _Options {
+    /**
+     * 并发数量，默认值为 5，最大可设置值为 10
+     */
+    concurrency?: number;
+    /**
+     * 单个子任务的最大数据量，默认值为 5，最大可设置值为 100
+     */
+    maxSliceNumber?: number;
+    /**
+     * 触发进度回调函数的步长，以百分比为单位，每当发生大于等于步长的进度变化时，便触发进度回调函数。默认为每当有进度变化时，便触发进度回调函数（进度变化精度为 1%）
+     */
+    progressCallbackStep?: number;
+}
+export declare class Tasks<cf> {
+    private f;
+    constructor(_f?: Function);
+    /**
+     * 创建异步任务
+     * @param apiName 函数的 apiName
+     * @param params 参数
+     */
+    createAsyncTask(apiName: cf, params: object): Promise<void>;
+    /**
+     * 创建分布式任务
+     * @param dataset 待处理数据组成的数组
+     * @param handlerFunc 用于处理数据集的全局函数的 API name
+     * @param progressCallbackFunc 任务进度发生变化时回调的全局函数的 API name，可通过传入 "" / null / undefined 跳过此步骤
+     * @param completedCallbackFunc 任务完成时回调的全局函数的 API name，可通过传入 "" / null / undefined 跳过此步骤
+     * @param options 高级配置参数，可选
+     */
+    createDistributedTask(dataset: any[], handlerFunc: cf, progressCallbackFunc: cf | "" | null | undefined, completedCallbackFunc: cf | "" | null | undefined, options?: _Options): Promise<number>;
+}

package/context/tasks/tasks.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tasks = exports._Options = void 0;
+const common = require("@byted-apaas/server-common-node");
+const Request = require("../../request/interface");
+const utils = common.utils;
+const exceptions = common.exceptions;
+class _Options {
+}
+exports._Options = _Options;
+// export async function asyncTaskV1(apiName: string, params: any, oldFuncName: string, isSync: boolean) {
+//     return await invokeFuncSync(apiName, params, oldFuncName, false);
+// }
+class Tasks {
+    constructor(_f) {
+        this.f = _f;
+    }
+    /**
+     * 创建异步任务
+     * @param apiName 函数的 apiName
+     * @param params 参数
+     */
+    async createAsyncTask(apiName, params) {
+        if (apiName && params) {
+            // low_code 1.0
+            if (utils.isOnlineDev()) { // TODO 区分 4.0 vs 5.0
+                // 1.debug模式
+                if (utils.isDebug()) {
+                    return await this.f(apiName).invoke(params);
+                }
+                // 2.运行时
+                let newApiName = utils.handleFuncName(null, apiName);
+                if (!newApiName) {
+                    throw new exceptions.InvalidParamError(`The function (${apiName}) does not exist, please confirm ${apiName} exists and has been deployed.`);
+                }
+                let idOrName = {};
+                if (newApiName === apiName) {
+                    idOrName = {
+                        APIName: newApiName,
+                        isInvokeByAPIName: true,
+                    };
+                }
+                else if (utils.isMicroservice()) {
+                    idOrName = {
+                        APIName: apiName,
+                        isInvokeByAPIName: true,
+                    };
+                }
+                else {
+                    idOrName = {
+                        APIId: newApiName,
+                        isInvokeByAPIName: false,
+                    };
+                }
+                return {
+                    task_id: await Request.GetInstance().createAsyncTaskV1(idOrName, params),
+                };
+            }
+            // low_code 2.0
+            // 如果是本地调试模式，则直接异步执行
+            if (utils.isLocalDebug()) {
+                this.f(apiName).invoke(params);
+                return { task_id: 1234567890123456 };
+            }
+            return {
+                task_id: await Request.GetInstance().createAsyncTaskV2(apiName, params),
+            };
+        }
+        else {
+            throw new exceptions.InvalidParamError(`context.tasks.createAsyncTask params is error`);
+        }
+    }
+    ;
+    /**
+     * 创建分布式任务
+     * @param dataset 待处理数据组成的数组
+     * @param handlerFunc 用于处理数据集的全局函数的 API name
+     * @param progressCallbackFunc 任务进度发生变化时回调的全局函数的 API name，可通过传入 "" / null / undefined 跳过此步骤
+     * @param completedCallbackFunc 任务完成时回调的全局函数的 API name，可通过传入 "" / null / undefined 跳过此步骤
+     * @param options 高级配置参数，可选
+     */
+    async createDistributedTask(dataset, handlerFunc, progressCallbackFunc, completedCallbackFunc, options) {
+        if (utils.isLocalDebug()) {
+            throw new exceptions.InvalidParamError("Local debugging isn't supported for distributed tasks. You can only deploy them to the cloud");
+        }
+        if (utils.getDistributedHandleMask()) {
+            throw new exceptions.InvalidParamError("Does not support creating distributed tasks in handler function and progress callback function");
+        }
+        // dataset
+        if (!(dataset instanceof Array)) {
+            throw new exceptions.InvalidParamError(`parameter dataset is not list`);
+        }
+        // handlerFunc
+        if (!handlerFunc || typeof handlerFunc !== 'string') {
+            throw new exceptions.InvalidParamError(`parameter handlerFunc is not string or handlerFunc is empty`);
+        }
+        // progressCallbackFunc
+        if (progressCallbackFunc === null || progressCallbackFunc === undefined) {
+            progressCallbackFunc = "";
+        }
+        if (typeof progressCallbackFunc !== 'string') {
+            throw new exceptions.InvalidParamError(`parameter progressCallbackFunc is not string`);
+        }
+        // completedCallbackFunc
+        if (completedCallbackFunc === null || completedCallbackFunc === undefined) {
+            completedCallbackFunc = "";
+        }
+        if (typeof completedCallbackFunc !== 'string') {
+            throw new exceptions.InvalidParamError(`parameter completedCallbackFunc is not string`);
+        }
+        // option.concurrency
+        if (options.concurrency === null || options.concurrency === undefined) {
+            options.concurrency = 5;
+        }
+        if ((typeof options.concurrency !== 'number') || options.concurrency <= 0) {
+            throw new exceptions.InvalidParamError(`parameter option.concurrency is not Number or not graterThan 0`);
+        }
+        // option.maxSliceNumber
+        if (options.maxSliceNumber === null || options.maxSliceNumber === undefined) {
+            options.maxSliceNumber = 5;
+        }
+        if ((typeof options.maxSliceNumber !== 'number') || options.maxSliceNumber <= 0) {
+            throw new exceptions.InvalidParamError(`parameter option.maxSliceNumber is not Number or not graterThan 0`);
+        }
+        // option.notifyStep
+        if (options.progressCallbackStep === null || options.progressCallbackStep === undefined) {
+            options.progressCallbackStep = 1;
+        }
+        if ((typeof options.progressCallbackStep !== 'number') || options.progressCallbackStep <= 0 || options.progressCallbackStep > 100) {
+            throw new exceptions.InvalidParamError(`parameter option.progressCallbackStep is not Number or not between 0 and 100`);
+        }
+        if (utils.isOnlineDev()) {
+            return Request.GetFaaSInfraInstance().createDistributeTaskV1([dataset], handlerFunc, progressCallbackFunc, completedCallbackFunc, options);
+        }
+        return Request.GetFaaSInfraInstance().createDistributeTaskV2([dataset], handlerFunc, progressCallbackFunc, completedCallbackFunc, options);
+    }
+    ;
+}
+exports.Tasks = Tasks;
+//# sourceMappingURL=tasks.js.map

package/context/tasks/tasks.js.map

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