@lytical/app 1.0.0

package/README.md

@@ -0,0 +1,233 @@
+# @lytical/app
+
+a typescript api server library built for your express project, with dependency injection support and auto router registration
+
+## Features
+
+- router handler dependency injection
+- auto `app.use()` router registration
+- use middleware, only for routes that require it
+
+## Getting Started
+
+after installing `@lytical/app` to your express project, configure your `tsconfig.json` file to enable decorators.
+
+```json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+if this is a new project, we recommended installing `express@5.2..`, and the following project structure:
+
+```
+project
+|- dist
+|- src
+|  |- middleware
+|  |  |- my-middleware.ts
+|  |  |- ...
+|  |- routes
+|  |  |- my-route.ts
+|  |  |- ...
+|  |- services
+|  |  |- my-service.ts
+|  |  |- ...
+|  |- index.ts
+|- .gitignore
+|- package.json
+|- tsconfig.json
+```
+
+for the above project structure:
+
+- configure your `tsconfig.json` file.
+
+```json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist"
+  }
+}
+```
+
+- configure your `package.json` file to indicate where your routes are located.
+
+```json
+// package.json
+{
+  "main": "./{index.js,routes/**/*.js}"
+}
+```
+
+a simple project template can be found in github (https://....)
+
+## Usage
+
+create your injectable service class(es) to implement the business logic.
+
+```typescript
+import { ioc_injectable } from '@lytical/ioc';
+
+@ioc_injectable()
+// src/services/example-svc.ts
+export class example_svc {
+  async get_message() {
+    return 'Hello from example_svc!';
+  }
+
+  async get_data() {
+    return { message: await this.get_message() };
+  }
+}
+```
+
+create your middleware classes
+
+```typescript
+// src/middleware/example-mw.ts
+import type { Request, Response, NextFunction } from 'express';
+
+import { ioc_inject } from '@lytical/ioc';
+import { example_svc } from '../services/example-svc';
+
+/**
+ * Example middleware class
+ * Use for middleware that requires dependency injection
+ */
+export class example_middleware_class {
+  // inject your service(es) into the middleware class constructor
+  constructor(
+    @ioc_inject(example_svc) private readonly _example_svc: example_svc,
+  ) {}
+
+  // all middleware classes must implement a default() route handler
+  async default(rqs: Request, rsp: Response, nxt: NextFunction) {
+    console.debug('example middleware invoked');
+    rsp.locals.example_middleware_data = await this._example_svc.get_data();
+    // make sure to call nxt() to continue the request processing pipeline
+    nxt();
+  }
+}
+```
+
+create your route handler(s)
+
+```typescript
+// src/routes/example.ts
+import express, {
+  type Request,
+  type Response,
+  type NextFunction,
+} from 'express';
+
+import {
+  app_middleware_dependency,
+  app_route,
+  app_route_handler,
+} from '@lytical/app';
+
+import { ioc_inject } from '@lytical/ioc';
+import { example_svc } from '../services/example-svc';
+import { example_middleware_class } from '../middleware/example-mw';
+
+/**
+ * Example route class
+ * Use for router class(es) for auto app.use() registration for routes; dependent middleware; and dependency injection
+ */
+@app_route({ route: '/example' })
+export class example_route_class {
+  // inject your service(es) into the router class constructor
+  constructor(
+    @ioc_inject(example_svc) private readonly _example_svc: example_svc,
+  ) {}
+
+  // implement your handler methods
+  @app_route_handler({
+    route: '/', // /example/
+    http_method: ['GET'],
+  })
+  async get_handler(rqs: Request, rsp: Response, nxt: NextFunction) {
+    rsp.json({ message: await this._example_svc.get_message() }).end();
+  }
+
+  @app_route_handler({
+    http_method: ['POST'],
+    route: '/', // /example/
+    dependency: [
+      // use only the middleware needed
+      express.json(),
+      app_middleware_dependency(example_middleware_class),
+    ],
+  })
+  post_handler(rqs: Request, rsp: Response, nxt: NextFunction) {
+    rsp.json({ body: rqs.body, locals: rsp.locals }).end();
+  }
+}
+```
+
+now just import app and invoke `start()`
+
+```typescript
+// src/index.ts
+import app from '@lytical/app';
+
+app.start();
+```
+
+`app` emits a few life cycle events
+
+```typescript
+// src/index.ts
+import app, { app_evt } from './lib/app';
+
+// app events occur in the following order:
+// 1. create_server
+// 2. server_starting
+// 3. server_listening
+// 4. server_started
+
+app.once(app_evt.create_server, (cfg) => {
+  // modify (cfg) as needed, or remove this listener if not needed.
+  // for example, create a https server instead of http,
+  // and push async operations to fetch keys, to (cfg.wait_for).
+  // add middleware to (cfg.express), that applies to all routes, etc.
+  console.log(`the root route is (${cfg.root_route})`);
+});
+
+app.once(app_evt.server_starting, (cfg) => {
+  // modify (cfg) as needed, or remove this listener if not needed.
+  // add middleware to this application after auto registered routes are added.
+  // for example error handling middleware, etc.
+  // push async operations to fetch settings from a database, to (cfg.wait_for).
+  // this is the last to register dependencies in the ioc collection before the server starts.
+  console.log(`the hostname is (${cfg.hostname})`);
+});
+
+app.once(app_evt.server_listening, () => {
+  // remove this listener if not needed.
+  // use it to perform operations after the server starts listening.
+  // the ioc container is ready at this point.
+});
+
+app.once(app_evt.server_started, () => {
+  // remove this listener if not needed.
+  // use it to perform operations after the server has started.
+});
+
+app.start();
+```
+
+## Documentation
+
+todo: working on this right now...
+
+Stay tuned! I have more packages to come.`
+
+_lytical(r) is a registered trademark of lytical, inc. all rights are reserved._

package/app.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=app.test.d.ts.map

package/app.test.js

@@ -0,0 +1,6 @@
+"use strict";
+/* @preserve
+  (c) 2025 lytical, inc. all rights are reserved.
+  lytical(r) is a registered trademark of lytical, inc.
+  please refer to your license agreement on the use of this file.
+*/var __awaiter=this&&this.__awaiter||function(e,t,i,n){return new(i||(i=Promise))(function(a,r){function fulfilled(e){try{step(n.next(e))}catch(e){r(e)}}function rejected(e){try{step(n.throw(e))}catch(e){r(e)}}function step(e){var t;e.done?a(e.value):(t=e.value,t instanceof i?t:new i(function(e){e(t)})).then(fulfilled,rejected)}step((n=n.apply(e,t||[])).next())})},__importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0});const chai_1=require("chai"),mocha_1=require("mocha"),index_1=__importDefault(require("./index"));(0,mocha_1.describe)("an app",()=>{it("can be started",()=>__awaiter(void 0,void 0,void 0,function*(){(0,chai_1.expect)(index_1.default).exist}))});

package/index.d.ts

@@ -0,0 +1,134 @@
+import { EventEmitter } from 'node:stream';
+import { type Request, type RequestHandler, type Response, type NextFunction } from 'express';
+import type { app_listening_cfg_t, app_server_cfg_t } from './types';
+/** events emitted by the app */
+export declare enum app_evt {
+    /**
+     * use to create or modify the server before it is started
+     *
+     * for example, create a https server instead of http,
+     * and push async operations to fetch keys, to (cfg.wait_for).
+     * add middleware to (cfg.express), that applies to all routes, etc.
+     */
+    create_server = "lyt-create-server",
+    /**
+     * use to modify the server listening configuration before it is started
+     *
+     * add middleware to this (cfg.express) after auto registered routes are added.
+     * for example error handling middleware, etc.
+     * push async operations to fetch settings from a database, to (cfg.wait_for).
+     * this is the last to register dependencies in the ioc collection before the server starts.
+     */
+    server_starting = "lyt-server-starting",
+    /**
+     * emitted when the server is listening
+     *
+     * use it to perform operations after the server starts listening.
+     * the ioc container is ready at this point.
+     */
+    server_listening = "lyt-server-listening",
+    /**
+     * emitted when the server has started
+     *
+     * use it to perform operations after the server has started.
+     */
+    server_started = "lyt-server-started"
+}
+/**
+ * app class
+ * @description
+ * the main app class
+ * @emits app_evt.create_server use to create or modify the server before it is started
+ * @emits app_evt.server_starting use to modify the server listening configuration before it is started
+ * @emits app_evt.server_listening emitted when the server is listening
+ * @emits app_evt.server_started emitted when the server has started
+ */
+export declare class app extends EventEmitter {
+    once(event: app_evt.create_server, listener: (cfg: app_server_cfg_t) => void): this;
+    once(event: app_evt.server_listening, listener: () => void): this;
+    once(event: app_evt.server_starting, listener: (cfg: app_listening_cfg_t) => void): this;
+    once(event: app_evt.server_started, listener: () => void): this;
+    /**
+     * start the app
+     * @description
+     * starts the express app server
+     * app events occur in the following order:
+     *   1. create_server
+     *   2. server_starting
+     *   3. server_listening
+     *   4. server_started
+     */
+    start(): Promise<void>;
+}
+type cstor_t<_t_ = any> = new (...args: any[]) => _t_;
+/**
+ * helper to create a route handler dependency from a middleware class constructor
+ * @param {app_route_middleware_t} cstor middleware class constructor
+ * @param {unknown[]} arg optional arguments to append to the middleware constructor
+ * @returns {app_route_handler_dependency_t} route handler dependency
+ */
+export declare function app_middleware_dependency(cstor: cstor_t<app_route_middleware_t>, ...arg: unknown[]): app_route_handler_dependency_t;
+/**
+ * app_route class decorator
+ * @description
+ * decorator to define a route class
+ * support for dependency injection in the constructor
+ * @param {app_route_info_t} route information
+ */
+export declare function app_route({ route, arg }: app_route_info_t): (cstr: cstor_t) => cstor_t<any>;
+/**
+ * app_route_handler method decorator
+ * @param {app_route_handler_info_t} arg route handler information
+ */
+export declare function app_route_handler(arg: app_route_handler_info_t): (cstr: any, method_nm: string, pd: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * app_route_info_t
+ * @description
+ * route information for the app_route class decorator
+ */
+export type app_route_info_t = {
+    /** the route path or pattern */
+    route: string | RegExp;
+    /** optional arguments to append to the route class constructor */
+    arg?: unknown[];
+};
+/**
+ * app_route_handler_dependency_t
+ * @description
+ * route handler dependency type
+ * can be a RequestHandler or a middleware class constructor with optional arguments
+ */
+export type app_route_handler_dependency_t = RequestHandler | {
+    /** middleware class constructor */
+    middleware: cstor_t<app_route_middleware_t>;
+    /** optional arguments to append to the middleware constructor */
+    arg?: unknown[];
+};
+/**
+ * app_route_handler_info_t
+ * @description
+ * route handler information for the app_route_handler method decorator
+ */
+export type app_route_handler_info_t = {
+    /** route handler dependencies */
+    dependency?: app_route_handler_dependency_t | app_route_handler_dependency_t[];
+    /** http method or methods */
+    http_method?: string | string[];
+    /** the route path or pattern */
+    route: string | RegExp;
+};
+/**
+ * app_route_middleware_t
+ * @description
+ * route middleware class type
+ * the class must have a default method that is a RequestHandler
+ * this method can be used as a middleware in the app_route_handler_info_t dependency property
+ * this method can also have dependencies injected
+ */
+export interface app_route_middleware_t {
+    /** the default method of the middleware class */
+    default(rqs: Request, rsp: Response, nxt: NextFunction): void | Promise<void>;
+}
+declare const _default: app;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/* @preserve
+  (c) 2025 lytical, inc. all rights are reserved.
+  lytical(r) is a registered trademark of lytical, inc.
+  please refer to your license agreement on the use of this file.
+*/var __createBinding=this&&this.__createBinding||(Object.create?function(e,t,r,o){void 0===o&&(o=r);var n=Object.getOwnPropertyDescriptor(t,r);n&&!("get"in n?!t.__esModule:n.writable||n.configurable)||(n={enumerable:!0,get:function(){return t[r]}}),Object.defineProperty(e,o,n)}:function(e,t,r,o){void 0===o&&(o=r),e[o]=t[r]}),__setModuleDefault=this&&this.__setModuleDefault||(Object.create?function(e,t){Object.defineProperty(e,"default",{enumerable:!0,value:t})}:function(e,t){e.default=t}),__importStar=this&&this.__importStar||function(){var ownKeys=function(e){return ownKeys=Object.getOwnPropertyNames||function(e){var t=[];for(var r in e)Object.prototype.hasOwnProperty.call(e,r)&&(t[t.length]=r);return t},ownKeys(e)};return function(e){if(e&&e.__esModule)return e;var t={};if(null!=e)for(var r=ownKeys(e),o=0;o<r.length;o++)"default"!==r[o]&&__createBinding(t,e,r[o]);return __setModuleDefault(t,e),t}}(),__awaiter=this&&this.__awaiter||function(e,t,r,o){return new(r||(r=Promise))(function(n,s){function fulfilled(e){try{step(o.next(e))}catch(e){s(e)}}function rejected(e){try{step(o.throw(e))}catch(e){s(e)}}function step(e){var t;e.done?n(e.value):(t=e.value,t instanceof r?t:new r(function(e){e(t)})).then(fulfilled,rejected)}step((o=o.apply(e,t||[])).next())})},__asyncValues=this&&this.__asyncValues||function(e){if(!Symbol.asyncIterator)throw new TypeError("Symbol.asyncIterator is not defined.");var t,r=e[Symbol.asyncIterator];return r?r.call(e):(e="function"==typeof __values?__values(e):e[Symbol.iterator](),t={},verb("next"),verb("throw"),verb("return"),t[Symbol.asyncIterator]=function(){return this},t);function verb(r){t[r]=e[r]&&function(t){return new Promise(function(o,n){(function(e,t,r,o){Promise.resolve(o).then(function(t){e({value:t,done:r})},t)})(o,n,(t=e[r](t)).done,t.value)})}}},__importDefault=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(exports,"__esModule",{value:!0}),exports.app=exports.app_evt=void 0,exports.app_middleware_dependency=app_middleware_dependency,exports.app_route=app_route,exports.app_route_handler=app_route_handler;const node_http_1=require("node:http"),node_stream_1=require("node:stream"),promises_1=require("node:fs/promises"),node_path_1=require("node:path"),express_1=__importDefault(require("express")),find_root_1=__importDefault(require("find-root")),ioc_1=require("@lytical/ioc"),collection_1=__importDefault(require("@lytical/ioc/collection"));var app_evt;!function(e){e.create_server="lyt-create-server",e.server_starting="lyt-server-starting",e.server_listening="lyt-server-listening",e.server_started="lyt-server-started"}(app_evt||(exports.app_evt=app_evt={}));const _app=(0,express_1.default)(),_root_route=express_1.default.Router({mergeParams:!0});class app extends node_stream_1.EventEmitter{once(e,t){return super.once(e,t)}start(){return __awaiter(this,void 0,void 0,function*(){var e,t;const r={express:_app,root_route:"/api",wait_for:[]};r.express.use((e,t,r)=>{t.set("X-Powered-By","powered by lytical(r) enterprise solutions, and express"),t.set("X-Lyt-Version","1.0.0"),r()}),console.log("[@lytical/ts-express] creating http server..."),this.emit(app_evt.create_server,r),r.wait_for.length&&(yield Promise.all(r.wait_for)),_app.use(null!==(e=r.root_route)&&void 0!==e?e:"/api",_root_route);const o=null!==(t=r.server)&&void 0!==t?t:(0,node_http_1.createServer)(r.express);yield _register_routes();const n={express:r.express,hostname:process.env.HOSTNAME||"localhost",port:process.env.PORT?parseInt(process.env.PORT,10):3e3,server:o,wait_for:[]};this.emit(app_evt.server_starting,n),n.wait_for.length&&(yield Promise.all(n.wait_for)),yield collection_1.default.create_container(),o.listen(n.port,n.hostname,n.backlog,()=>{this.emit(app_evt.server_listening),console.log(`[@lytical/ts-express] server started on port ${n.port}; hostname ${n.hostname}`)}),this.emit(app_evt.server_started)})}}function _register_routes(){return __awaiter(this,void 0,void 0,function*(){var e,t,r,o,n;const{main:s}=null!==(n=yield Promise.resolve(`${(0,node_path_1.join)((0,find_root_1.default)(__dirname),"package.json")}`).then(e=>__importStar(require(e))))&&void 0!==n?n:{};if(s){const n=yield(0,promises_1.glob)(s),c=process.cwd();try{for(var i,a=!0,_=__asyncValues(n);!(e=(i=yield _.next()).done);a=!0){o=i.value,a=!1;const e=o;console.log(`[@lytical/ts-express] registering routes in module (${e})...`),yield Promise.resolve(`${(0,node_path_1.join)(c,e)}`).then(e=>__importStar(require(e)))}}catch(e){t={error:e}}finally{try{a||e||!(r=_.return)||(yield r.call(_))}finally{if(t)throw t.error}}}})}exports.app=app;const route_handler_method=Symbol("lyt-app-api-route-handler-method");function app_middleware_dependency(e,...t){return{middleware:e,arg:t}}function app_route({route:e,arg:t}){const r=e;return o=>{var n;const s=express_1.default.Router({mergeParams:!0}),i=null!==(n=o.prototype[route_handler_method])&&void 0!==n?n:{};for(const e of Object.keys(i)){const{route:n,dependency:a,http_method:_}=i[e];if(a.length||_.length>1){const i=express_1.default.Router({mergeParams:!0}),c=[];for(let e of a){if("function"==typeof e){i.use(e),c.push(e.name||"anonymous-middleware");continue}const{middleware:t,arg:r}=e;i.use((e,o,n)=>(0,ioc_1.ioc_create_instance)(t,...null!=r?r:[]).default(e,o,n)),c.push(t.name||"anonymous-middleware")}for(const r of _)i[r.toLowerCase()]?i[r.toLowerCase()](n,(r,n,s)=>{const i=(0,ioc_1.ioc_create_instance)(o,...null!=t?t:[]);(0,ioc_1.ioc_invoke_method)(i[e],i,r,n,s)}):i.use(n,(n,s,i)=>{if(r.toUpperCase()!==n.method)return i();const a=(0,ioc_1.ioc_create_instance)(o,...null!=t?t:[]);(0,ioc_1.ioc_invoke_method)(a[e],a,n,s,i)});console.debug(`[@lytical/ts-express] registered (${_}:${r}${n}) route handler (${o.name}.${e}) with dependencies (${c})`),s.use(i);continue}const[c]=_;c?(s[c.toLowerCase()]?s[c.toLowerCase()](n,(r,n,s)=>{const i=(0,ioc_1.ioc_create_instance)(o,...null!=t?t:[]);(0,ioc_1.ioc_invoke_method)(i[e],i,r,n,s)}):s.use(n,(r,n,s)=>{if(c.toUpperCase()!==r.method)return s();const i=(0,ioc_1.ioc_create_instance)(o,...null!=t?t:[]);(0,ioc_1.ioc_invoke_method)(i[e],i,r,n,s)}),console.debug(`[@lytical/ts-express] registered (${c}:${r}${n}) route handler (${o.name}.${e})`)):(s.use(n,(r,n,s)=>{const i=(0,ioc_1.ioc_create_instance)(o,...null!=t?t:[]);(0,ioc_1.ioc_invoke_method)(i[e],i,r,n,s)}),console.debug(`[@lytical/ts-express] registered (ALL-METHODS:${r}${n}) route handler (${o.name}.${e})`))}return _root_route.use(e,s),o}}function app_route_handler(e){return(t,r,o)=>{var n;switch(e.dependency?Array.isArray(e.dependency)||(e.dependency=[e.dependency]):e.dependency=[],typeof e.http_method){case"undefined":e.http_method=[];break;case"string":e.http_method=[e.http_method]}const s=null!==(n=t[route_handler_method])&&void 0!==n?n:{};return s[r]=e,t[route_handler_method]=s,o}}exports.default=new app;

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@lytical/app",
+  "version": "1.0.0",
+  "description": "a typescript api server library built for your express project, with dependency injection support and auto router registration",
+  "main": "index.js",
+  "private": false,
+  "scripts": {
+    "build": "tsc --build",
+    "publish": "npm run clean&&npm run build&&gulp post_build&&cd ./dist&&npm publish --access public",
+    "clean": "rimraf ./dist",
+    "rebuild": "npm run clean&&npm install&&npm run build",
+    "test": "npm run clean&&npm run build&&mocha --recursive ./dist/**/*.test.js"
+  },
+  "keywords": [
+    "ioc",
+    "express",
+    "app",
+    "server",
+    "dependency-injection",
+    "auto-routing",
+    "lytical",
+    "node",
+    "typescript"
+  ],
+  "author": {
+    "email": "barry.hayles@lytical.com",
+    "name": "Barry Hayles",
+    "url": "https://www.lytical.com"
+  },
+  "repository": {
+    "type": "github",
+    "url": "git+https://github.com/lytical/app.git"
+  },
+  "license": "ISC",
+  "peerDependencies": {
+    "@lytical/ioc": "^1.0.0",
+    "express": "^5.2.1"
+  },
+  "devDependencies": {
+    "@types/chai": "^5.2.3",
+    "@types/express": "^5.0.6",
+    "@types/find-root": "^1.1.4",
+    "@types/mocha": "^10.0.10",
+    "@types/node": "^25.0.9",
+    "chai": "^6.2.2",
+    "gulp": "^5.0.1",
+    "gulp-clean": "^0.4.0",
+    "gulp-uglify-es": "^3.0.0",
+    "mocha": "^11.7.5",
+    "pump": "^3.0.3",
+    "rimraf": "^6.1.2",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "find-root": "^1.1.0"
+  }
+}

package/types.d.ts

@@ -0,0 +1,94 @@
+/* @preserve
+  (c) 2025 lytical, inc. all rights are reserved.
+  lytical(r) is a registered trademark of lytical, inc.
+  please refer to your license agreement on the use of this file.
+*/
+
+import type { Server } from 'node:net';
+import type { Application } from 'express';
+
+/**
+ * server configuration type
+ * @description
+ * the configuration used when creating or modifying the server before it is started.
+ */
+export type app_server_cfg_t = {
+  /**
+   * the express application instance
+   * @description
+   * the express application instance that will be used to create the server
+   * add any middleware to this application before auto registered routes are added.
+   */
+  express: Application;
+
+  /**
+   * the root route
+   * @description
+   * override and provide the root route to be used. if not provided, the default '/api' route will be used.
+   */
+  root_route: string;
+
+  /**
+   * the server instance
+   * @description
+   * provide the server instance to be used. if not provided, a default http server will be created. 
+   */
+  server?: Server;
+
+  /**
+   * wait_for
+   * @description
+   * can be used to delay until some asynchronous operation is complete.
+   */
+  wait_for: Promise<any>[];
+};
+
+/**
+ * listening configuration type
+ * @description
+ * the configuration used when starting the server listening.
+ */
+export type app_listening_cfg_t = {
+  /**
+   * the maximum length of the queue of pending connections
+   * @description
+   * provide the maximum length of the queue of pending connections. the default is 511 (node.js default).
+   */
+  backlog?: number;
+
+  /**
+   * the express application instance
+   * @description
+   * add any middleware to this application after auto registered routes are added.
+   */
+  express: Application;
+
+  /**
+   * the hostname to listen on
+   * @description
+   * provide the hostname to listen on. if not provided, the server will listen on all available interfaces.
+   */
+  hostname?: string;
+
+  /**
+   * the port to listen on
+   * @description
+   * provide the port to listen on. if not provided, the server will listen on port process.env.PORT or 3000.
+   */
+  port?: number;
+
+  /**
+   * the server instance
+   * @description
+   * the server instance that will be used.
+   * use to add listeners before the server is started.
+   */
+  server: Server;
+
+  /**
+   * wait_for
+   * @description
+   * can be used to delay until some asynchronous operation is complete.
+   * */
+  wait_for: Promise<any>[];
+};