@nger/fk-upload 1.0.202 → 1.0.203

package/dist/services/download.service.js

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DownloadService = void 0;
+const tslib_1 = require("tslib");
+const download_task_1 = require("./../entities/download-task");
+const core_1 = require("@nger/core");
+const typeorm_1 = require("@nger/typeorm");
+const rabbitmq_1 = require("@nger/rabbitmq");
+const actions_1 = require("../tasks/actions");
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const uuid_1 = require("uuid");
+let DownloadService = class DownloadService {
+    injector;
+    db;
+    constructor(injector, db) {
+        this.injector = injector;
+        this.db = db;
+    }
+    async startDownload(id) {
+        const download = await this.db.manager.findOneOrFail(download_task_1.FkDownloadTask, { where: { id } });
+        if (download.status === '1') {
+            // no start
+            await this.db.manager.update(download_task_1.FkDownloadTask, id, { status: `2` });
+            await this.start(id);
+        }
+        else if (download.status === '2') {
+            // wait
+            await this.start(id);
+        }
+        else if (download.status === '3') {
+            // downloading
+            await this.db.manager.update(download_task_1.FkDownloadTask, id, { status: `5` });
+            await this.continue(id);
+        }
+        else if (download.status === '4') {
+            // stop
+            await this.db.manager.update(download_task_1.FkDownloadTask, id, { status: `5` });
+            await this.continue(id);
+        }
+        else if (download.status === '5') {
+            // wait continue
+            await this.continue(id);
+        }
+        else if (download.status === '6') {
+            // error
+            await this.db.manager.update(download_task_1.FkDownloadTask, id, { status: `5` });
+            await this.continue(id);
+        }
+        else if (download.status === '7') {
+            console.log(`has finish`);
+        }
+        else {
+            console.log(`unknow status`);
+            await this.continue(id);
+        }
+    }
+    async start(id) {
+        const db = this.injector.get(typeorm_1.Db);
+        const download = await db.manager.findOneOrFail(download_task_1.FkDownloadTask, {
+            where: { id }
+        });
+        const taskManager = this.injector.get(rabbitmq_1.TaskManager);
+        const t = new rabbitmq_1.TaskEntity();
+        t.topic = actions_1.DOWNLOAD_ACTION;
+        t.data = { id: download.id };
+        await taskManager.send(t);
+    }
+    async starts(ids) {
+        return Promise.all(ids.map(id => this.startDownload(id)));
+    }
+    async continue(id) {
+        const db = this.injector.get(typeorm_1.Db);
+        const download = await db.manager.findOneOrFail(download_task_1.FkDownloadTask, {
+            where: { id }
+        });
+        const taskManager = this.injector.get(rabbitmq_1.TaskManager);
+        const t = new rabbitmq_1.TaskEntity();
+        t.topic = actions_1.DOWNLOAD_CONTINUE_ACTION;
+        t.data = { id: download.id };
+        await taskManager.send(t);
+    }
+    async stop(id) {
+        const db = this.injector.get(typeorm_1.Db);
+        const upload = await db.manager.findOneOrFail(download_task_1.FkDownloadTask, {
+            where: { id }
+        });
+        if (upload.status === '7') { }
+        else if (upload.status === '1') {
+        }
+        else if (upload.status === '2') {
+        }
+        else {
+            await db.manager.update(download_task_1.FkDownloadTask, id, { status: '4' });
+        }
+    }
+    async stops(ids) {
+        return Promise.all(ids.map(id => this.stop(id)));
+    }
+    createDir() {
+        const root = this.injector.get(core_1.APP_ROOT);
+        const date = new Date();
+        const year = date.getFullYear();
+        const month = date.getMonth() + 1;
+        const day = date.getDate();
+        const path = (0, path_1.join)(root, 'attachments', `${year}/${month}/${day}`);
+        (0, fs_extra_1.ensureDirSync)(path);
+        return path;
+    }
+    createFilename(url) {
+        const _url = new URL(url);
+        const filePath = _url.pathname;
+        let ext = (0, path_1.extname)(filePath);
+        let filename = (0, uuid_1.v4)();
+        if (ext.length < 5) {
+            ext = ext === '.' ? '.mp4' : ext;
+        }
+        if (ext.length === 0) {
+            if ((url.toLowerCase()).includes('gif')) {
+                ext = '.gif';
+            }
+            if ((url.toLowerCase()).includes('jpg')) {
+                ext = '.jpg';
+            }
+            if ((url.toLowerCase()).includes('png')) {
+                ext = '.png';
+            }
+            if ((url.toLowerCase()).includes('mp4')) {
+                ext = '.mp4';
+            }
+        }
+        return filename + ext;
+    }
+};
+DownloadService = tslib_1.__decorate([
+    (0, core_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [core_1.Injector, typeorm_1.Db])
+], DownloadService);
+exports.DownloadService = DownloadService;

package/dist/services/effect.service.d.ts

@@ -0,0 +1,7 @@
+import { Injector } from "@nger/core";
+export declare class EffectService {
+    private injector;
+    constructor(injector: Injector);
+    starts(ids: number[]): Promise<void[]>;
+    start(id: number): Promise<void>;
+}

package/dist/services/effect.service.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EffectService = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@nger/core");
+const rabbitmq_1 = require("@nger/rabbitmq");
+const typeorm_1 = require("@nger/typeorm");
+const effect_task_1 = require("../entities/effect-task");
+const actions_1 = require("../tasks/actions");
+let EffectService = class EffectService {
+    injector;
+    constructor(injector) {
+        this.injector = injector;
+    }
+    async starts(ids) {
+        return Promise.all(ids.map(id => this.start(id)));
+    }
+    async start(id) {
+        const db = this.injector.get(typeorm_1.Db);
+        const upload = await db.manager.findOneOrFail(effect_task_1.FkEffectTask, {
+            where: { id }
+        });
+        const taskManager = this.injector.get(rabbitmq_1.TaskManager);
+        const t = new rabbitmq_1.TaskEntity();
+        t.topic = actions_1.EFFECT_ACTION;
+        t.data = { id: upload.id };
+        await taskManager.send(t);
+    }
+};
+EffectService = tslib_1.__decorate([
+    (0, core_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [core_1.Injector])
+], EffectService);
+exports.EffectService = EffectService;

package/dist/services/fk.service.d.ts

@@ -0,0 +1,24 @@
+import { FkAccount } from './../entities/fk-account';
+import { Axios } from "@nger/axios";
+import { Db } from '@nger/typeorm';
+import { FkDownloadTask } from '../entities/download-task';
+import { Subject } from '.pnpm/rxjs@7.5.5/node_modules/rxjs';
+export declare class FkService {
+    private axios;
+    private db;
+    constructor(axios: Axios, db: Db);
+    getToken(cookie: string): Promise<string>;
+    getAccessToken(cookie: string, token: string, pre: string): Promise<any>;
+    private encodeURIComponent;
+    getUploadUrl(token: any, forceDirect?: boolean): string;
+    getUploadInfo(fkAccount: FkAccount, download: FkDownloadTask): Promise<any>;
+    uploadFile(fkAccount: FkAccount, download: FkDownloadTask): Promise<Subject<unknown>>;
+    getBssInfo(): {
+        fromSite: boolean;
+        siteId: number;
+        groupId: number;
+        fileSizeLimit: number;
+    };
+    getUploadInfourl(accessToken: any): string;
+    private decode;
+}

package/dist/services/fk.service.js

@@ -0,0 +1,323 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FkService = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@nger/core");
+const axios_1 = require("@nger/axios");
+const typeorm_1 = require("@nger/typeorm");
+const fs_1 = require("fs");
+const form_data_1 = tslib_1.__importDefault(require("form-data"));
+const rxjs_1 = require(".pnpm/rxjs@7.5.5/node_modules/rxjs");
+let FkService = class FkService {
+    axios;
+    db;
+    constructor(axios, db) {
+        this.axios = axios;
+        this.db = db;
+    }
+    async getToken(cookie) {
+        const url = `https://i.vip.webportal.top/`;
+        const iVipWebPortal = await this.axios.request({
+            url,
+            headers: {
+                'Content-type': 'text/html',
+                'Cookie': cookie
+            }
+        }).then(res => {
+            const { data } = res;
+            return data;
+        });
+        const items = iVipWebPortal.match(/<meta id='_TOKEN' value='(.*?)'\/>/);
+        let token = ``;
+        if (items && items.length === 2) {
+            token = items[1];
+        }
+        return token;
+    }
+    async getAccessToken(cookie, token, pre) {
+        // https://jhy0002.vip.webportal.top/cn/api/manage/advanceUpload/genAccessKey?_v=1653909389147&_TOKEN=afb8c4ac23544b83a34449dfaa76029a
+        const url = `https://${pre}.vip.webportal.top/cn/api/manage/advanceUpload/genAccessKey?_v=${new Date().getTime()}&_TOKEN=${token}`;
+        const accessKey = await this.axios.request({
+            url,
+            responseType: 'json',
+            headers: {
+                'Cookie': cookie
+            }
+        }).then(res => {
+            const { data, request, headers } = res;
+            return data;
+        });
+        if (accessKey.success) {
+            const accessTokenString = this.decode(accessKey.accessKey);
+            if (accessTokenString) {
+                const accessToken = JSON.parse(accessTokenString);
+                return accessToken;
+            }
+        }
+    }
+    encodeURIComponent(data) {
+        if ((0, core_1.isPrimitive)(data)) {
+            return encodeURIComponent(data);
+        }
+        return Object.keys(data).map(key => {
+            const value = Reflect.get(data, key);
+            return `${key}=${value}`;
+        }).join('&');
+    }
+    getUploadUrl(token, forceDirect = true) {
+        if (forceDirect) {
+            return `https://${token.url}/${token.visitType}/${token.app}/upload?cmd=${token.cmd}&token=${token.token}`;
+        }
+        else {
+            return `https://${token.url}/${token.visitType}/${token.app}/advance?cmd=${token.cmd}&token=${token.token}`;
+        }
+    }
+    async getUploadInfo(fkAccount, download) {
+        // TODO: from redis cache
+        const bssInfo = this.getBssInfo();
+        const token = await this.getToken(fkAccount.cookies);
+        if (token.length <= 0) {
+            return;
+        }
+        const accessToken = await this.getAccessToken(fkAccount.cookies, token, fkAccount.mainUsername);
+        const uploadInfoUrl = this.getUploadInfourl(accessToken);
+        const data = this.encodeURIComponent({
+            fileMd5: download.md5,
+            fileSize: download.size,
+            isFreeVer: false,
+            aid: fkAccount.aid,
+            folderId: fkAccount.uploadGroupId,
+            bssInfo: encodeURIComponent(JSON.stringify(bssInfo)),
+            fileName: download.filename
+        });
+        const info = await this.axios.request({
+            url: uploadInfoUrl,
+            data,
+            method: 'post',
+            headers: {
+                [`Content-Type`]: `application/x-www-form-urlencoded`,
+                [`Cookie`]: fkAccount.cookies
+            }
+        }).then(res => res.data);
+        if (info.code === 200) {
+            let forceDirect = true;
+            if (download.size > 2097152) {
+                forceDirect = false;
+            }
+            let uploadUrl = this.getUploadUrl(accessToken, forceDirect);
+            return { ...info.data, uploadUrl: uploadUrl, token, forceDirect };
+        }
+    }
+    async uploadFile(fkAccount, download) {
+        const sub = new rxjs_1.Subject();
+        const upload = async () => {
+            const info = await this.getUploadInfo(fkAccount, download).catch(e => {
+                sub.error(new Error(`获取上传信息失败`));
+            });
+            if (!info) {
+                sub.error(new Error(`获取上传信息失败`));
+            }
+            const cookies = fkAccount.cookies;
+            let uploadUrl = info.uploadUrl;
+            if (info.forceDirect) {
+                const formData = new form_data_1.default();
+                const fileStream = (0, fs_1.createReadStream)(download.path);
+                formData.append('ctrl', fileStream);
+                formData.append('isFreeVer', this.encodeURIComponent(false));
+                formData.append('aid', this.encodeURIComponent(fkAccount.aid));
+                formData.append('folderId', this.encodeURIComponent(fkAccount.uploadGroupId));
+                formData.append('bssInfo', JSON.stringify(this.getBssInfo()));
+                formData.append('fileName', this.encodeURIComponent(download.filename));
+                const headers = formData.getHeaders();
+                const uploadResult = await this.axios.post(uploadUrl, formData, {
+                    headers: {
+                        ...headers,
+                        Cookie: cookies
+                    },
+                    timeout: 18000
+                }).then(res => {
+                    return res.data;
+                }).catch((e) => {
+                    sub.error(e);
+                });
+                if (!uploadResult) {
+                    sub.error(new Error(`未知错误`));
+                    return;
+                }
+                if (uploadResult.code !== 200) {
+                    sub.error(new Error(uploadResult.msg));
+                    return;
+                }
+                if (uploadResult.code === 200) {
+                    const data = uploadResult.data;
+                    const fullDownUrl = data.fullDownUrl;
+                    if (fullDownUrl) {
+                        if (fullDownUrl.startsWith('https://site-upload')) {
+                            sub.error(new Error(`登录过期，请重新绑定`));
+                        }
+                        const fullUrl = fullDownUrl.startsWith('http') ? fullDownUrl : `https:` + fullDownUrl;
+                        sub.next({
+                            url: fullUrl,
+                            size: download.size,
+                            start: 0,
+                            end: download.size
+                        });
+                        sub.complete();
+                    }
+                }
+                return;
+            }
+            const splitSize = info.splitSize;
+            const uploadedSize = info.uploadedSize;
+            let index = Math.ceil(uploadedSize / splitSize);
+            let complete = false;
+            const max = download.size - 1;
+            const totalChunks = Math.ceil(download.size / splitSize);
+            let uploadResult;
+            if (!(0, fs_1.existsSync)(download.path)) {
+                sub.error(new Error(`文件不存在或已删除`));
+                return;
+            }
+            const stats = (0, fs_1.statSync)(download.path);
+            if (stats.size !== download.size) {
+                sub.error(new Error(`文件与预计大小不一致`));
+                return;
+            }
+            do {
+                let start = index * splitSize;
+                let _end = start + splitSize - 1;
+                let end = _end > max ? max : _end;
+                if (end >= max) {
+                    complete = true;
+                }
+                const fileStream = (0, fs_1.createReadStream)(download.path, { start: start, end: end });
+                const formdata = new form_data_1.default();
+                formdata.append('ctrl', fileStream);
+                formdata.append('isFreeVer', this.encodeURIComponent(false));
+                formdata.append('aid', this.encodeURIComponent(fkAccount.aid));
+                formdata.append('folderId', this.encodeURIComponent(fkAccount.uploadGroupId));
+                formdata.append('fileName', download.filename);
+                formdata.append(`totalSize`, this.encodeURIComponent(download.size));
+                formdata.append(`fileMd5`, download.md5);
+                formdata.append('index', this.encodeURIComponent(index));
+                formdata.append('chunkSize', this.encodeURIComponent(splitSize));
+                formdata.append('totalChunks', this.encodeURIComponent(totalChunks));
+                formdata.append(`complete`, this.encodeURIComponent(complete));
+                const bssInfo = {
+                    fromSite: true, siteId: 0, groupId: 0, fileSizeLimit: 1024
+                };
+                formdata.append('bssInfo', JSON.stringify(bssInfo));
+                const headers = formdata.getHeaders();
+                uploadResult = await this.axios.post(uploadUrl, formdata, {
+                    headers: {
+                        ...headers,
+                        Cookie: cookies
+                    },
+                    timeout: 18000
+                }).then(res => {
+                    return res.data;
+                }).catch((e) => {
+                    sub.error(e);
+                });
+                if (uploadResult.code !== 200) {
+                    if (uploadResult.data) {
+                        const data = uploadResult.data;
+                        if (data.limit) {
+                            // to big
+                            sub.error(`文件太大上传失败`);
+                            break;
+                        }
+                    }
+                    sub.error(new Error(uploadResult.msg));
+                    break;
+                }
+                if (uploadResult) {
+                    const data = uploadResult.data;
+                    const fullDownUrl = data.fullDownUrl;
+                    if (fullDownUrl) {
+                        if (fullDownUrl.startsWith('https://site-upload')) {
+                            sub.error(new Error(`need re bind`));
+                            break;
+                        }
+                        const fullUrl = fullDownUrl.startsWith('http') ? fullDownUrl : `https:` + fullDownUrl;
+                        sub.next({
+                            url: fullUrl,
+                            index,
+                            totalChunks,
+                            filename: download.filename,
+                            start,
+                            splitSize,
+                            end,
+                            size: download.size
+                        });
+                        complete = true;
+                        break;
+                    }
+                }
+                sub.next({
+                    url: undefined,
+                    index,
+                    totalChunks,
+                    filename: download.filename,
+                    start,
+                    splitSize,
+                    end,
+                    size: download.size
+                });
+                index = index + 1;
+            } while (!complete);
+            // upload complete
+            this.axios.post(`https://${fkAccount.mainUsername}.vip.webportal.top/ajax/advanceUpload.jsp?cmd=_report&_TOKEN=${info.token}`, this.encodeURIComponent({
+                type: 1,
+                size: download.size,
+                time: NaN,
+                flag: true,
+                name: download.filename
+            }), {
+                headers: {
+                    [`Content-Type`]: `application/x-www-form-urlencoded; charset=UTF-8`,
+                    Cookie: fkAccount.cookies
+                }
+            });
+            sub.complete();
+            return uploadResult;
+        };
+        upload();
+        return sub;
+    }
+    getBssInfo() {
+        return {
+            fromSite: true, siteId: 0, groupId: 0, fileSizeLimit: 1024
+        };
+    }
+    getUploadInfourl(accessToken) {
+        return `https://${accessToken.url}/${accessToken.visitType}/${accessToken.app}/advance/info?cmd=${accessToken.cmd}&token=${accessToken.token}`;
+    }
+    decode(base64Str) {
+        if (!base64Str)
+            return;
+        const t = base64Str.replace(/_/g, "/").replace(/-/g, "+");
+        const f = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/=";
+        let l = 0;
+        let p = 0;
+        let h = [];
+        do {
+            const o = f.indexOf(t.charAt(l++));
+            const u = f.indexOf(t.charAt(l++));
+            const a = f.indexOf(t.charAt(l++));
+            const c = f.indexOf(t.charAt(l++));
+            const s = o << 18 | u << 12 | a << 6 | c;
+            const e = s >> 16 & 255;
+            const r = s >> 8 & 255;
+            const n = 255 & s;
+            h[p++] = 64 === a ? String.fromCharCode(e) : 64 === c ? String.fromCharCode(e, r) : String.fromCharCode(e, r, n);
+        } while (l < t.length);
+        return h.join('');
+    }
+};
+FkService = tslib_1.__decorate([
+    (0, core_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [axios_1.Axios, typeorm_1.Db])
+], FkService);
+exports.FkService = FkService;
+// MIGfMA0GCSqGSxx3DQEBAQUAA4GNADCBiQKBgQCBWNoG5LJ3u44Gs8PWs1MaNUQQ+mOmh+9zWdzSt3ORbmfCDvU+ssW/6QTTgXvWWx7+Wzq/a4fCCQp72zSqXeVhWkTVct9Hyp/iMo5K6qOEK76z9z+tP/u99X6qazeXGVMWKkPiyZT4mKAGd/U8Mph9Z1Z5kOluA7g7heq8PPlE9wIDAQAB

package/dist/services/login.service.d.ts

@@ -0,0 +1,17 @@
+import { Injector } from "@nger/core";
+import { Db } from "@nger/typeorm";
+import { Axios } from '@nger/axios';
+import { CryptoService } from '@nger/utils';
+import { CookieJar } from 'tough-cookie';
+export declare class FkLoginService {
+    private db;
+    private axios;
+    private jar;
+    private crypto;
+    private injector;
+    constructor(db: Db, axios: Axios, jar: CookieJar, crypto: CryptoService, injector: Injector);
+    preLogin(): Promise<any>;
+    tryLogin(uid: number, token?: string): Promise<any>;
+    private loginSuccess;
+    private toUrl;
+}

package/dist/services/login.service.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FkLoginService = void 0;
+const tslib_1 = require("tslib");
+const core_1 = require("@nger/core");
+const typeorm_1 = require("@nger/typeorm");
+const fk_account_1 = require("../entities/fk-account");
+const axios_1 = require("@nger/axios");
+const utils_1 = require("@nger/utils");
+const tough_cookie_1 = require("tough-cookie");
+let FkLoginService = class FkLoginService {
+    db;
+    axios;
+    jar;
+    crypto;
+    injector;
+    constructor(db, axios, jar, crypto, injector) {
+        this.db = db;
+        this.axios = axios;
+        this.jar = jar;
+        this.crypto = crypto;
+        this.injector = injector;
+    }
+    async preLogin() {
+        const url = `https://adm.webportal.top/ajax/login_h.jsp?cmd=initLoginConf`;
+        return this.axios.request({
+            url,
+            method: 'post',
+            responseType: 'json',
+            headers: {
+                [`Content-Type`]: `application/x-www-form-urlencoded; charset=UTF-8`
+            }
+        });
+    }
+    async tryLogin(uid, token) {
+        const url = `https://adm.webportal.top/ajax/login_h.jsp?cmd=loginCorp`;
+        const account = await this.db.manager.findOneOrFail(fk_account_1.FkAccount, { where: { id: uid } });
+        const data = {
+            cacct: account.mainUsername,
+            pwd: this.crypto.md5(account.password),
+            sacct: account.childUsername,
+            autoLogin: true,
+            staffLogin: true,
+            checkSign: token
+        };
+        const res = await this.axios.request({
+            url,
+            data: this.toUrl(data),
+            responseType: 'json',
+            method: 'post',
+            headers: {
+                [`Content-Type`]: `application/x-www-form-urlencoded; charset=UTF-8`
+            }
+        });
+        await this.loginSuccess(uid, data.pwd);
+        return res;
+    }
+    async loginSuccess(uid, pass) {
+        const url = `https://adm.webportal.top`;
+        // const url = `https://i.vip.webportal.top/?siteId=0`
+        const e = pass;
+        let t = 0;
+        /\d/.test(e) && t++;
+        (/[a-z]/.test(e) || /[A-Z]/.test(e)) && t++;
+        (/\W/.test(e) || /[_]/.test(e)) && t++;
+        e.length < 8 && (t = 0);
+        let faiIng;
+        if (t < 2) {
+            faiIng = `1`;
+        }
+        else {
+            faiIng = `0`;
+        }
+        const currentUrl = `https://adm.webportal.top`;
+        await this.axios.request({
+            url,
+            headers: {
+                [`Content-Type`]: `text/plain`,
+            }
+        }).then(res => res.data);
+        const cookie = await this.jar.getCookieString(url);
+        await this.db.manager.update(fk_account_1.FkAccount, uid, { cookies: cookie + ';hasShowDomainBeianWindow=;hasShowBeianSmsTips=;faiIng=0' });
+    }
+    toUrl(data) {
+        return Object.keys(data).map(key => {
+            const value = Reflect.get(data, key);
+            return `${key}=${value}`;
+        }).join('&');
+    }
+};
+FkLoginService = tslib_1.__decorate([
+    (0, core_1.Injectable)(),
+    tslib_1.__metadata("design:paramtypes", [typeorm_1.Db, axios_1.Axios, tough_cookie_1.CookieJar, utils_1.CryptoService, core_1.Injector])
+], FkLoginService);
+exports.FkLoginService = FkLoginService;

package/dist/services/upload.service.d.ts

@@ -0,0 +1,13 @@
+import { Injector } from "@nger/core";
+import { Db } from "@nger/typeorm";
+export declare class UploadService {
+    private injector;
+    private db;
+    constructor(injector: Injector, db: Db);
+    startUpload(id: number): Promise<void>;
+    start(id: number): Promise<void>;
+    starts(ids: number[]): Promise<void[]>;
+    continue(id: number): Promise<void>;
+    stop(id: number): Promise<void>;
+    stops(ids: number[]): Promise<void[]>;
+}