@sansenjian/qq-music-api 2.1.1 → 2.2.1

package/.babelrc

@@ -1,3 +1,7 @@
 {
+  "presets": [
+    ["@babel/preset-env", { "targets": { "node": "current" } }],
+    "@babel/preset-typescript"
+  ],
   "plugins": ["@babel/plugin-transform-async-to-generator"]
 }

package/.eslintrc.json

@@ -1,21 +1,22 @@
 {
-  "env": {
-    "browser": true,
-    "commonjs": true,
-    "es2021": true,
-    "node": true
-  },
-  "extends": ["eslint:recommended", "standard"],
-  "parserOptions": {
-    "ecmaVersion": "latest"
-  },
-  "plugins": ["n"],
-  "rules": {
-    "indent": ["error", "tab"],
-    "no-tabs": "off",
-    "linebreak-style": ["error", "unix"],
-    "quotes": ["error", "single"],
-    "semi": ["error", "always"],
-    "camelcase": "off"
-  }
+	"env": {
+		"browser": true,
+		"commonjs": true,
+		"es2021": true,
+		"node": true
+	},
+	"extends": ["eslint:recommended", "standard"],
+	"parserOptions": {
+		"ecmaVersion": "latest"
+	},
+	"plugins": ["n"],
+	"rules": {
+		"indent": ["error", "tab"],
+		"no-tabs": "off",
+		"linebreak-style": ["error", "unix"],
+		"quotes": ["error", "single"],
+		"semi": ["error", "always"],
+		"camelcase": "off"
+	},
+	"ignorePatterns": ["jest.config.js"]
 }

package/AGENTS.md

@@ -0,0 +1,153 @@
+# AGENTS.md
+
+## 项目概览
+
+这是一个基于 Koa 的 QQ 音乐 API 服务项目，当前代码库已完成从 JavaScript 到 TypeScript 的迁移。
+
+- 运行时：Node.js 20+
+- 开发语言：TypeScript
+- Web 框架：Koa 2
+- 路由系统：@koa/router
+- 文档系统：VitePress
+- 测试框架：Jest
+
+## 启动与构建
+
+### 安装依赖
+
+```bash
+npm install
+```
+
+### 开发模式
+
+```bash
+npm run dev
+```
+
+默认启动入口为 `app.ts`，默认端口为 `3200`。
+
+### 生产构建
+
+```bash
+npm run build
+```
+
+### 生产运行
+
+```bash
+npm run start
+```
+
+## 常用命令
+
+```bash
+npm run dev            # 本地开发
+npm run build          # TypeScript 编译
+npm run start          # 运行 dist/app.js
+npm run test           # 运行测试
+npm run test:watch     # 测试监听模式
+npm run test:coverage  # 测试覆盖率
+npm run docs:dev       # 启动文档站点
+npm run docs:build     # 构建文档
+npm run eslint         # 执行 ESLint 自动修复
+npm run prettier       # 执行 Prettier 格式化
+```
+
+## 目录结构
+
+```text
+app.ts                 应用启动入口
+index.ts               包导出入口
+module/                API 请求封装层
+routers/               HTTP 控制器与路由注册
+middlewares/           Koa 中间件
+util/                  通用工具函数
+config/                运行时配置
+types/                 全局类型与公共类型定义
+docs/                  VitePress 文档站点
+tests/                 单元测试与集成测试
+public/                静态资源
+scripts/               辅助脚本
+```
+
+## 分层说明
+
+### module/
+
+负责直接请求 QQ 音乐相关接口，通常只处理：
+
+- 请求参数拼装
+- 调用上游接口
+- 基础数据格式转换
+- 返回统一响应结构
+
+### routers/context/
+
+负责 HTTP 层控制器逻辑，通常只处理：
+
+- 读取 `ctx.query` 或 `ctx.request.body`
+- 参数校验
+- 调用 `module/` 中对应能力
+- 设置 `ctx.body` 与 `ctx.status`
+
+### routers/router.ts
+
+负责统一注册所有路由。
+
+### util/
+
+放置跨模块复用的通用逻辑，例如响应包装、颜色输出等。
+
+## 编码约定
+
+1. 新增功能时，优先保持现有目录分层，不要把路由逻辑和接口请求逻辑混写。
+2. 新增接口时，通常需要同时补充：
+   - `module/apis/...` 中的接口实现
+   - `routers/context/...` 中的控制器
+   - `routers/context/index.ts` 或相关导出
+   - `routers/router.ts` 中的路由注册
+   - 必要时补充文档与测试
+3. 统一使用 TypeScript，避免继续引入新的 `.js` 业务文件。
+4. 尽量复用已有类型定义，公共类型优先放到 `types/`。
+5. 保持返回结构一致，优先复用已有响应工具。
+6. 修改全局配置或 Cookie 相关逻辑时，注意兼容扫码登录相关接口。
+
+## 测试与验证
+
+提交前建议至少执行：
+
+```bash
+npm run build
+npm run test
+```
+
+如果修改了文档，再执行：
+
+```bash
+npm run docs:build
+```
+
+如果修改了格式或风格敏感文件，再执行：
+
+```bash
+npm run eslint
+npm run prettier
+```
+
+## 关键注意事项
+
+1. 项目默认端口为 `3200`。
+2. 生产启动依赖 `dist/` 目录，因此发布前必须先执行构建。
+3. 当前仓库包含扫码登录相关接口实现，不要在未理解流程前随意调整登录状态字段。
+4. 文档内容位于 `docs/`，接口能力变更时要同步更新文档。
+5. 现有测试以 Jest 为主，新增行为建议补充对应测试。
+
+## 建议的开发流程
+
+1. 阅读相关模块现有实现。
+2. 在 `module/` 增加或调整接口能力。
+3. 在 `routers/context/` 接入 HTTP 控制器。
+4. 在路由层完成注册。
+5. 补充类型、测试与文档。
+6. 执行构建和测试，确认无误后再提交。

package/README.md

@@ -6,196 +6,222 @@
 
 ![GitHub watchers](https://img.shields.io/github/watchers/sansenjian/qq-music-api?style=social) ![GitHub stars](https://img.shields.io/github/stars/sansenjian/qq-music-api?style=social) ![GitHub forks](https://img.shields.io/github/forks/sansenjian/qq-music-api?style=social)
 <br />
-![node](https://img.shields.io/badge/node-%3E%3D18.0.0-green?style=flat-square)
+![node](https://img.shields.io/badge/node-%3E%3D20.0.0-green?style=flat-square)
 <br />
 ![GitHub repo size](https://img.shields.io/github/repo-size/sansenjian/qq-music-api?style=flat-square) ![GitHub package.json version](https://img.shields.io/github/package-json/v/sansenjian/qq-music-api?style=flat-square) ![GitHub](https://img.shields.io/github/license/sansenjian/qq-music-api?style=flat-square) ![GitHub open issues](https://img.shields.io/github/issues/sansenjian/qq-music-api?style=flat-square) ![GitHub closed issues](https://img.shields.io/github/issues-closed/sansenjian/qq-music-api) ![GitHub last commit](https://img.shields.io/github/last-commit/sansenjian/qq-music-api?style=flat-square) ![GitHub top language](https://img.shields.io/github/languages/top/sansenjian/qq-music-api?style=flat-square)
 
 </div>
 
-> 🍴 本项目 Fork 自 [Rain120/qq-music-api](https://github.com/Rain120/qq-music-api)，原项目已停止维护，此版本持续更新中
-> QQ 音乐 API koa2 版本，通过 Web 网页版请求 QQ 音乐接口数据，有问题请提 [issue](https://github.com/sansenjian/qq-music-api/issues)
-> 当前代码仅供学习，不可做商业用途
+> 🍴 本项目 Fork 自 [Rain120/qq-music-api](https://github.com/Rain120/qq-music-api)，原项目已停止维护，此版本持续更新中  
+> 基于 Koa 2 与 TypeScript 的 QQ 音乐 API 服务，包含扫码登录、用户头像、MV 播放地址、批量接口等能力。  
+> 当前代码仅供学习与研究使用，不可做商业用途。
 
-### API 结构图
+## 项目概览
 
-> 目前暂时没有时间做登录模块的接口，欢迎各位大佬给我 `PR`, 阿里嘎多
+- 运行时：Node.js 20+
+- 服务框架：Koa 2
+- 开发语言：TypeScript
+- 路由系统：[@koa/router](package.json:53)
+- 文档系统：[`VitePress`](package.json:100)
+- 测试框架：[`Jest`](package.json:89)
+- 默认端口：`3200`
+
+## API 结构图
+
+> 当前版本已包含扫码登录相关接口，并已完成 TypeScript 迁移。
 
 ![qq-music](./screenshot/qq-music.png)
 
-📖 **详细 API 文档**: [查看完整 API 文档](https://sansenjian.github.io/qq-music-api/)
+📖 **详细 API 文档**： [查看完整 API 文档](https://sansenjian.github.io/qq-music-api/)
 
-### 环境要求
+## 环境要求
 
-> 本项目采用 `koa2`，需要 Node.js 18.0.0+
+本项目基于 `Koa 2 + TypeScript`，需要 Node.js 20.0.0+。
 
-```
+```bash
 node -v
 ```
 
-### 📦 安装
+## 安装
 
-**方式一：克隆仓库**
-```
+### 方式一：克隆仓库
+
+```bash
 git clone git@github.com:sansenjian/qq-music-api.git
 cd qq-music-api
 npm install
 ```
 
-**方式二：NPM 安装**
-```
+### 方式二：NPM 安装
+
+```bash
 npm install @sansenjian/qq-music-api
 ```
 
 在项目中使用：
+
 ```javascript
-// 启动 API 服务
 const { spawn } = require('child_process');
 const path = require('path');
 
 const qqMusicPath = path.join(__dirname, 'node_modules', '@sansenjian/qq-music-api', 'app.js');
-spawn('node', [qqMusicPath], { 
-  env: { ...process.env, PORT: '3200' },
-  stdio: 'inherit'
+
+spawn('node', [qqMusicPath], {
+	env: { ...process.env, PORT: '3200' },
+	stdio: 'inherit',
 });
 ```
 
-### 🔨 项目启动
-```
-// npm i -g nodemon
-npm run start
+## 项目启动
 
-// or don't install nodemon
-node app.js
-```
-项目监听端口是 `3200`
-
-### 📋 依赖更新 (2026-03)
-
-本项目已完成依赖现代化升级，主要变更如下：
-
-**生产依赖**
-| 依赖 | 版本 | 说明 |
-|-----|------|-----|
-| axios | ^1.6.0 | 修复安全漏洞 CVE-2021-3749 |
-| koa | ^2.15.0 | 框架更新 |
-| koa-bodyparser | ^4.4.0 | 解析器更新 |
-| @koa/router | ^15.3.1 | 替代 koa-router |
-| koa-static | ^5.0.0 | 静态文件服务 |
-| date-fns | ^4.1.0 | 日期处理库 (轻量级) |
-
-**开发依赖**
-| 依赖 | 版本 | 说明 |
-|-----|------|-----|
-| eslint | ^8.56.0 | 代码检查 |
-| eslint-config-standard | ^17.0.0 | 标准配置 |
-| prettier | ^3.0.0 | 代码格式化 |
-| husky | ^9.0.0 | Git 钩子 |
-| lint-staged | ^15.0.0 | 暂存区检查 |
-| @commitlint/* | ^18.0.0 | 提交信息规范 |
-| @babel/* | ^7.23.0 | 编译工具 |
-| nodemon | ^3.0.0 | 开发热重载 |
-| vitepress | ^1.6.4 | 文档工具 (基于 Vite) |
-| vue | ^3.5.29 | 渐进式 JS 框架 |
-
-**已移除的依赖**
-- `colors` - 存在安全问题，已用 chalk 替代
-- `moment` - 已用 date-fns 替代
-- `dayjs` - 已用 date-fns 替代 (更小的打包体积)
-- `docsify-cli` - 已用 vitepress 替代 (更好的性能和功能)
-- `lodash.get` - 已用原生可选链 `?.` 替代
-- `eslint-plugin-node` - 已用 eslint-plugin-n 替代
-- `eslint-plugin-standard` - 已集成到 eslint-config-standard
-
-### 功能特性
-
-#### 🎵 音乐播放
-- ✅ **歌曲播放链接** - 获取 QQ 音乐歌曲的播放地址
-- ✅ **歌曲与专辑图片** - 获取歌曲封面和专辑 artwork 图片
-- ✅ **歌曲歌词** - 获取歌曲的歌词信息（含翻译）
-- ✅ **MV 播放信息** - 获取 MV 的播放地址和相关信息
-
-#### 🎤 歌手相关
-- ✅ **歌手热门歌曲** - 获取歌手的热门歌曲列表
-- ✅ **歌手信息** - 获取歌手的基本资料信息
-- ✅ **相似歌手** - 获取与指定歌手风格相似的其他歌手
-- ✅ **歌手关注数** - 获取歌手的被关注数量信息
-- ✅ **歌手 MV** - 获取歌手的 MV 作品列表
-- ✅ **歌手专辑** - 获取歌手的专辑作品列表
-
-#### 📋 歌单相关
-- ✅ **歌单分类** - 获取 QQ 音乐的歌单分类标签
-- ✅ **歌单列表** - 获取指定分类下的歌单列表
-- ✅ **歌单详情** - 获取歌单的详细信息和歌曲列表
-
-#### 🔍 搜索功能
-- ✅ **搜索热词** - 获取当前热门搜索关键词
-- ✅ **搜索提示** - 根据关键字获取搜索建议
-- ✅ **搜索结果** - 获取歌曲、歌手、专辑等搜索结果
-
-#### 📊 排行榜
-- ✅ **排行榜单** - 获取所有音乐排行榜列表
-- ✅ **榜单详情** - 获取指定排行榜的歌曲列表
-
-#### 💿 专辑相关
-- ✅ **专辑信息** - 获取专辑的详细信息
-- ✅ **数字专辑** - 获取数字专辑的售卖信息
-- ✅ **新碟上架** - 获取最新发布的专辑信息
-
-#### 🎬 MV 视频
-- ✅ **MV 标签** - 获取 MV 的分类标签
-- ✅ **MV 列表** - 获取 MV 视频列表
-
-#### 🔧 其他功能
-- ✅ **自定义 Cookie** - 支持配置自定义 Cookie 信息
-- ✅ **产品下载** - 获取 QQ 音乐数字产品的下载地址
-- ✅ **电台列表** - 获取网络电台节目列表
-- ✅ **票务信息** - 获取音乐演出票务信息
-- ✅ **评论信息** - 获取歌曲、专辑等评论数据
-- ✅ **首页推荐** - 获取 APP 首页推荐内容
-
-### 使用文档
-
-使用 `apis` 详见 [文档](https://sansenjian.github.io/qq-music-api/)
-
-### 关于项目
-
-**灵感来自**
-
-[Binaryify/NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi)
-
-[Vue2.0 开发企业级移动端音乐 Web App](https://coding.imooc.com/class/107.html)
+```bash
+# 开发模式
+npm run dev
 
-**参考内容**
+# 生产构建
+npm run build
 
-[Koa 2](https://koa.bootcss.com/)
+# 生产运行
+npm run start
 
-[Axios](https://github.com/axios/axios)
+# 运行测试
+npm run test
 
-[阮一峰老师 - HTTP Referer 教程](http://www.ruanyifeng.com/blog/2019/06/http-referer.html)
+# 启动文档站点
+npm run docs:dev
+```
+
+项目默认监听端口为 `3200`。
+
+## 依赖版本说明（同步 [`package.json`](package.json:1)）
+
+### 生产依赖
+
+| 依赖                    | 当前版本  |
+| ----------------------- | --------- |
+| `@koa/router`           | `^15.3.1` |
+| `axios`                 | `^1.13.6` |
+| `date-fns`              | `^4.1.0`  |
+| `is-generator-function` | `1.0.10`  |
+| `koa`                   | `^2.16.1` |
+| `koa-bodyparser`        | `^4.4.1`  |
+| `koa-static`            | `^5.0.0`  |
+| `reflect-metadata`      | `^0.2.2`  |
+
+### 开发依赖
+
+| 依赖                                         | 当前版本  |
+| -------------------------------------------- | --------- |
+| `@babel/core`                                | `^7.23.0` |
+| `@babel/plugin-transform-async-to-generator` | `^7.23.0` |
+| `@babel/preset-env`                          | `^7.29.0` |
+| `@babel/preset-typescript`                   | `^7.28.5` |
+| `@babel/register`                            | `^7.23.0` |
+| `@commitlint/cli`                            | `^18.0.0` |
+| `@commitlint/config-conventional`            | `^18.0.0` |
+| `@types/jest`                                | `^30.0.0` |
+| `@types/koa`                                 | `^3.0.1`  |
+| `@types/koa__router`                         | `^12.0.5` |
+| `@types/koa-bodyparser`                      | `^4.3.13` |
+| `@types/node`                                | `^25.3.3` |
+| `@types/supertest`                           | `^7.2.0`  |
+| `chalk`                                      | `^4.1.0`  |
+| `conventional-changelog-cli`                 | `^4.0.0`  |
+| `eslint`                                     | `^8.57.0` |
+| `eslint-config-standard`                     | `^17.0.0` |
+| `eslint-plugin-import`                       | `^2.29.0` |
+| `eslint-plugin-n`                            | `^16.0.0` |
+| `eslint-plugin-promise`                      | `^6.0.0`  |
+| `husky`                                      | `^9.0.0`  |
+| `jest`                                       | `^30.2.0` |
+| `lint-staged`                                | `^15.0.0` |
+| `nodemon`                                    | `^3.1.14` |
+| `prettier`                                   | `^3.8.1`  |
+| `rimraf`                                     | `^6.1.3`  |
+| `sinon`                                      | `^21.0.1` |
+| `supertest`                                  | `^7.2.2`  |
+| `ts-jest`                                    | `^29.4.6` |
+| `ts-node`                                    | `^10.9.2` |
+| `tsx`                                        | `^4.21.0` |
+| `typescript`                                 | `5.7.3`   |
+| `vitepress`                                  | `^1.6.4`  |
+| `vue`                                        | `^3.5.29` |
+
+## 当前主要能力
+
+### 音乐与播放
+
+- 歌曲播放链接
+- 歌曲与专辑图片
+- 歌词与翻译歌词
+- MV 播放信息
+
+### 歌手与歌单
+
+- 歌手热门歌曲、资料、相似歌手、关注数
+- 歌手 MV 与歌手专辑
+- 歌单分类、歌单列表、歌单详情
+- 排行榜列表与详情
+
+### 用户与登录
+
+- 用户头像
+- 用户歌单
+- QQ 扫码登录
+- Cookie / 登录态相关接口
+
+### 其他能力
+
+- 评论信息
+- 数字专辑
+- 电台列表
+- 首页推荐
+- 下载地址
+- 票务信息
+
+## 文档入口
+
+- 用户接口说明：[`docs/api/user.md`](docs/api/user.md)
+- 其他接口说明：[`docs/api/other.md`](docs/api/other.md)
+- 用户歌单测试说明：[`docs/TEST_USER_PLAYLISTS.md`](docs/TEST_USER_PLAYLISTS.md)
+- 在线文档主页： [https://sansenjian.github.io/qq-music-api/](https://sansenjian.github.io/qq-music-api/)
+
+## 关于项目
+
+**灵感来源**
+
+- [Binaryify/NeteaseCloudMusicApi](https://github.com/Binaryify/NeteaseCloudMusicApi)
+- [Vue2.0 开发企业级移动端音乐 Web App](https://coding.imooc.com/class/107.html)
+
+**参考内容**
 
-### 项目不足
+- [Koa 2](https://koa.bootcss.com/)
+- [Axios](https://github.com/axios/axios)
+- [阮一峰老师 - HTTP Referer 教程](http://www.ruanyifeng.com/blog/2019/06/http-referer.html)
 
-1. 因为本人没写过 `unit test`, 所以本项目尚未添加 `unit test`, 等有时间再添加;
+## 当前限制
 
-2. 登录获取个人信息等接口都没做
+1. 部分用户能力仍依赖有效 Cookie。
+2. 上游 QQ 音乐接口字段可能变更，个别接口需要持续跟踪。
+3. 用户歌单接口仍在持续验证与调整中，详见 [`docs/TEST_USER_PLAYLISTS.md`](docs/TEST_USER_PLAYLISTS.md)。
 
-#### 🤝 贡献 ![PR](https://img.shields.io/badge/PRs-Welcome-orange?style=flat-square&logo=appveyor)
+## 贡献
 
-We welcome all contributions. You can submit any ideas as [pull requests](https://github.com/sansenjian/qq-music-api/pulls) or as a GitHub [issue](https://github.com/sansenjian/qq-music-api/issues). 
+We welcome all contributions. You can submit any ideas as [pull requests](https://github.com/sansenjian/qq-music-api/pulls) or as GitHub [issues](https://github.com/sansenjian/qq-music-api/issues).
 
-#### 👨‍🏭 维护者
+## 维护者
 
 - [GitHub](https://github.com/sansenjian)
 
-#### 🙏 原作者
+## 原作者
 
-本项目基于 [Rain120](https://github.com/Rain120) 的开源项目，感谢原作者的贡献！
+本项目基于 [Rain120](https://github.com/Rain120) 的开源项目，感谢原作者的贡献。
 
 - [GitHub](https://github.com/Rain120)
 - [知乎](https://www.zhihu.com/people/yan-yang-nian-hua-120/activities)
 - [掘金](https://juejin.im/user/57c616496be3ff00584f54db)
 
-#### 📝 License
+## License
 
 [MIT](https://github.com/sansenjian/qq-music-api/blob/master/LICENSE)
 

package/{app.js → app.ts}

@@ -1,42 +1,35 @@
-require('@babel/register');
-const Koa = require('koa');
+import 'reflect-metadata';
+import Koa from 'koa';
+import bodyParser from 'koa-bodyparser';
+import path from 'path';
+import koaStatic from 'koa-static';
+import chalk from 'chalk';
+import cors from './middlewares/koa-cors';
+import router from './routers/router';
+import cookieMiddleware from './util/cookie';
+import colors from './util/colors';
+import userInfoImport from './config/user-info';
+import pkg from './package.json';
+import type { UserInfo } from './types/global';
+
 const app = new Koa();
-const bodyParser = require('koa-bodyparser');
-const path = require('path');
-const static = require('koa-static');
-const exec = require('child_process').exec;
-const chalk = require('chalk');
 
-const cors = require('./middlewares/koa-cors');
-const router = require('./routers/router');
-const cookie = require('./util/cookie');
-const colors = require('./util/colors');
-const userInfo = require('./config/user-info');
-const package = require('./package.json');
-global.userInfo = Object.assign({}, userInfo);
+global.userInfo = userInfoImport as UserInfo;
 
 console.log(chalk.green('\n🥳🎉 We had supported config the user cookies. \n'));
+console.log(colors.info(`Current Version: ${pkg.version}`));
 
-if (!(global.userInfo.loginUin || global.userInfo.uin)) {
+if(!((global.userInfo as any).loginUin || (global.userInfo as any).uin)){
   console.log(chalk.yellow(`😔 The configuration ${chalk.red('loginUin')} or your ${chalk.red('cookie')} in file ${chalk.green('config/user-info')} has not configured. \n`));
 }
 
-if (!global.userInfo.cookie) {
+if (!(global.userInfo as any).cookie) {
   console.log(chalk.yellow(`😔 The configuration ${chalk.red('cookie')} in file ${chalk.green('config/user-info')} has not configured. \n`));
 }
 
-exec('npm info QQ-Music-API version', (err, stdout, stderr) => {
-  if(!err){
-    let version = stdout.trim();
-    if(package.version < version){
-      console.log(colors.prompt(`Current Version: ${version}, Current Version: ${package.version}, Please update it.`));
-    }
-  }
-});
-
 app.use(bodyParser());
-app.use(cookie());
-app.use(static(
+app.use(cookieMiddleware() as any);
+app.use(koaStatic(
   path.join(__dirname,  'public')
 ));
 
@@ -49,13 +42,13 @@ app.use(async (ctx, next) => {
 
 // cors
 app.use(cors({
-  origin: (ctx) => ctx.request.header.origin,
+  origin: ctx => (ctx.request as any).header?.origin || '*',
   exposeHeaders: ['WWW-Authenticate', 'Server-Authorization'],
   maxAge: 5,
   credentials: true,
   allowMethods: ['GET', 'POST', 'DELETE'],
   allowHeaders: ['Content-Type', 'Authorization', 'Accept'],
-}));
+}) as any);
 
 // x-response-time
 app.use(async (ctx, next) => {
@@ -68,8 +61,8 @@ app.use(async (ctx, next) => {
 app.use(router.routes())
   .use(router.allowedMethods());
 
-const PORT = process.env.PORT || 3200;
+const PORT: number = typeof process.env.PORT === 'string' ? parseInt(process.env.PORT, 10) : (process.env.PORT || 3200);
 
-app.listen(PORT, () => {
+(app.listen as any)(PORT, () => {
   console.log(colors.prompt(`server running @ http://localhost:${PORT}`));
 });