import Setting from './models/Setting'; import Logger from '@joplin/utils/Logger'; import Api, { RequestFile } from './services/rest/Api'; import ApiResponse from './services/rest/ApiResponse'; const urlParser = require('url'); const { randomClipperPort, startPort } = require('./randomClipperPort'); const enableServerDestroy = require('server-destroy'); const multiparty = require('multiparty'); export enum StartState { Idle = 'idle', Starting = 'starting', Started = 'started', } export default class ClipperServer { private logger_: Logger; private startState_: StartState = StartState.Idle; // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied private server_: any = null; private port_: number = null; private api_: Api = null; // eslint-disable-next-line @typescript-eslint/ban-types -- Old code before rule was applied private dispatch_: Function; private static instance_: ClipperServer = null; public constructor() { this.logger_ = new Logger(); } public static instance() { if (this.instance_) return this.instance_; this.instance_ = new ClipperServer(); return this.instance_; } public get api(): Api { return this.api_; } // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied public initialize(actionApi: any = null) { this.api_ = new Api(() => { return Setting.value('api.token'); // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied }, (action: any) => { this.dispatch(action); }, actionApi); } public setLogger(l: Logger) { this.logger_ = l; } public logger() { return this.logger_; } // eslint-disable-next-line @typescript-eslint/ban-types -- Old code before rule was applied public setDispatch(d: Function) { this.dispatch_ = d; } // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied public dispatch(action: any) { if (!this.dispatch_) throw new Error('dispatch not set!'); this.dispatch_(action); } public setStartState(v: StartState) { if (this.startState_ === v) return; this.startState_ = v; this.dispatch({ type: 'CLIPPER_SERVER_SET', startState: v, }); } public setPort(v: number) { if (this.port_ === v) return; this.port_ = v; this.dispatch({ type: 'CLIPPER_SERVER_SET', port: v, }); } public async findAvailablePort() { const tcpPortUsed = require('tcp-port-used'); let state = null; for (let i = 0; i < 10000; i++) { state = randomClipperPort(state, Setting.value('env')); const inUse = await tcpPortUsed.check(state.port); if (!inUse) return state.port; } throw new Error('All potential ports are in use or not available.'); } public async isRunning() { const tcpPortUsed = require('tcp-port-used'); const port = Setting.value('api.port') ? Setting.value('api.port') : startPort(Setting.value('env')); const inUse = await tcpPortUsed.check(port); return inUse ? port : 0; } public async start() { this.setPort(null); this.setStartState(StartState.Starting); const settingPort = Setting.value('api.port'); try { const p = settingPort ? settingPort : await this.findAvailablePort(); this.setPort(p); } catch (error) { this.setStartState(StartState.Idle); this.logger().error(error); return null; } this.server_ = require('http').createServer(); // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied this.server_.on('request', async (request: any, response: any) => { // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied const writeCorsHeaders = (code: any, contentType = 'application/json', additionalHeaders: any = null) => { const headers = { 'Content-Type': contentType, 'Access-Control-Allow-Origin': '*', 'Access-Control-Allow-Methods': 'GET, POST, OPTIONS, PUT, PATCH, DELETE', 'Access-Control-Allow-Headers': 'X-Requested-With,content-type', ...(additionalHeaders ? additionalHeaders : {}), }; response.writeHead(code, headers); }; // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied const writeResponseJson = (code: any, object: any) => { writeCorsHeaders(code); response.write(JSON.stringify(object)); response.end(); }; // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied const writeResponseText = (code: any, text: any) => { writeCorsHeaders(code, 'text/plain'); response.write(text); response.end(); }; // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied const writeResponseInstance = (code: any, instance: any) => { if (instance.type === 'attachment') { const filename = instance.attachmentFilename ? instance.attachmentFilename : 'file'; writeCorsHeaders(code, instance.contentType ? instance.contentType : 'application/octet-stream', { 'Content-disposition': `attachment; filename=${filename}`, 'Content-Length': instance.body.length, }); response.end(instance.body); } else { throw new Error('Not implemented'); } }; // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied const writeResponse = (code: any, response: any) => { if (response instanceof ApiResponse) { writeResponseInstance(code, response); } else if (typeof response === 'string') { writeResponseText(code, response); } else if (response === null || response === undefined) { writeResponseText(code, ''); } else { writeResponseJson(code, response); } }; this.logger().info(`Request: ${request.method} ${request.url}`); const url = urlParser.parse(request.url, true); // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied const execRequest = async (request: any, body = '', files: RequestFile[] = []) => { try { const response = await this.api_.route(request.method, url.pathname, url.query, body, files); writeResponse(200, response); } catch (error) { this.logger().error(error); const httpCode = error.httpCode ? error.httpCode : 500; const msg = []; if (httpCode >= 500) msg.push('Internal Server Error'); if (error.message) msg.push(error.message); if (error.stack) msg.push(`\n\n${error.stack}`); writeResponse(httpCode, { error: msg.join(': ') }); } }; const contentType = request.headers['content-type'] ? request.headers['content-type'] : ''; if (request.method === 'OPTIONS') { writeCorsHeaders(200); response.end(); } else { if (contentType.indexOf('multipart/form-data') === 0) { const form = new multiparty.Form(); // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied form.parse(request, (error: any, fields: any, files: any) => { if (error) { writeResponse(error.httpCode ? error.httpCode : 500, error.message); return; } else { void execRequest(request, fields && fields.props && fields.props.length ? fields.props[0] : '', files && files.data ? files.data : []); } }); } else { if (request.method === 'POST' || request.method === 'PUT') { let body = ''; // eslint-disable-next-line @typescript-eslint/no-explicit-any -- Old code before rule was applied request.on('data', (data: any) => { body += data; }); request.on('end', async () => { void execRequest(request, body); }); } else { void execRequest(request); } } } }); enableServerDestroy(this.server_); this.logger().info(`Starting Clipper server on port ${this.port_}`); this.server_.listen(this.port_, '127.0.0.1'); this.setStartState(StartState.Started); // We return an empty promise that never resolves so that it's possible to `await` the server indefinitely. // This is used only in command-server.js return new Promise(() => {}); } public async stop() { this.server_.destroy(); this.server_ = null; this.setStartState(StartState.Idle); this.setPort(null); } }