mpaas-jsapi-proxy 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,134 @@
+# mPaaS JSAPI Proxy Server
+
+mPaaS 小程序 JSAPI 代理服务器，提供 WebSocket 连接和设备管理功能。
+
+## 安装
+
+```bash
+npm install mpaas-jsapi-proxy
+# 或
+pnpm add mpaas-jsapi-proxy
+```
+
+## 功能特性
+
+- WebSocket 服务器，支持 JSAPI 消息代理
+- 设备连接管理
+- 消息路由和分发
+- 心跳检测机制
+- 二维码终端显示
+
+## 快速开始
+
+### 直接运行
+
+```bash
+# 全局安装
+npm install -g mpaas-jsapi-proxy
+
+# 启动服务器
+mpaas-jsapi-proxy
+```
+
+### 作为模块使用
+
+```javascript
+const { ProxyServer } = require('mpaas-jsapi-proxy');
+
+// 创建服务器实例
+const server = new ProxyServer({
+  port: 7521,
+  wsPath: '/ws',
+  heartbeatInterval: 30000
+});
+
+// 启动服务器
+server.start();
+
+// 优雅退出
+process.on('SIGINT', () => {
+  server.stop();
+  process.exit(0);
+});
+```
+
+### 自定义配置
+
+```javascript
+const { ProxyServer } = require('mpaas-jsapi-proxy');
+
+const server = new ProxyServer({
+  port: 7521,              // WebSocket 服务端口
+  wsPath: '/websocket',    // WebSocket 路径
+  heartbeatInterval: 60000 // 心跳间隔（毫秒）
+});
+
+server.start();
+```
+
+## API
+
+### ProxyServer
+
+#### 构造函数
+
+```javascript
+new ProxyServer(config)
+```
+
+**参数:**
+- `config.port` (number): WebSocket 服务端口，默认 3000
+- `config.wsPath` (string): WebSocket 路径，默认 '/ws'
+- `config.heartbeatInterval` (number): 心跳间隔（毫秒），默认 30000
+
+#### 方法
+
+- `start()`: 启动 WebSocket 服务器
+- `stop()`: 停止服务器并断开所有连接
+
+## 开发
+
+```bash
+# 克隆项目
+git clone <repository-url>
+
+# 安装依赖
+pnpm install
+
+# 开发模式（热重载）
+pnpm run dev
+
+# 构建
+pnpm run build
+
+# 类型检查
+pnpm run type-check
+```
+
+## 发布到 npm
+
+```bash
+# 构建
+pnpm run build
+
+# 预览包内容
+npm pack --dry-run
+
+# 发布
+npm publish
+```
+
+## 技术栈
+
+- **TypeScript** - 类型安全的开发体验
+- **Vite** - 快速的构建工具
+- **WebSocket** - 实时双向通信
+- **qrcode-terminal** - 终端二维码显示
+
+## 许可证
+
+MIT
+
+## 贡献
+
+欢迎提交 Issue 和 Pull Request！

package/dist/index.js

@@ -0,0 +1,12 @@
+var u=Object.create,f=Object.defineProperty,I=Object.getOwnPropertyDescriptor,b=Object.getOwnPropertyNames,w=Object.getPrototypeOf,m=Object.prototype.hasOwnProperty,S=(e,t,r,s)=>{if(t&&typeof t=="object"||typeof t=="function")for(var n=b(t),l=0,o=n.length,i;l<o;l++)i=n[l],!m.call(e,i)&&i!==r&&f(e,i,{get:(p=>t[p]).bind(null,i),enumerable:!(s=I(t,i))||s.enumerable});return e},g=(e,t,r)=>(r=e!=null?u(w(e)):{},S(t||!e||!e.__esModule?f(r,"default",{value:e,enumerable:!0}):r,e));let c=require("ws");c=g(c);let h=require("qrcode-terminal");h=g(h);let d=require("os");d=g(d);var a=class{static getLocalIP(){const e=d.default.networkInterfaces();for(const t of Object.keys(e))for(const r of e[t])if(r.family==="IPv4"&&!r.internal)return r.address;return"localhost"}static formatServerUrl(e,t,r){return`ws://${e}:${t}${r}`}static log(e,t="info"){const r=new Date().toLocaleTimeString("zh-CN");console.log(`[${r}] ${{info:"ℹ️",success:"✅",error:"❌",warn:"⚠️"}[t]||"ℹ️"} ${e}`)}},D=class{constructor(){this.devices=new Map}registerDevice(e,t,r){if(this.devices.has(e)){const s=this.devices.get(e);s.ws=t,s.deviceInfo=r,s.lastHeartbeat=Date.now(),a.log(`设备更新连接: ${e}`,"info")}else this.devices.set(e,{ws:t,simulatorWS:null,deviceInfo:r,lastHeartbeat:Date.now()}),a.log(`设备注册成功: ${e}`,"success")}disconnect(e){for(const[t,r]of this.devices)if(r.ws===e)return this.devices.delete(t),a.log(`设备断开连接: ${t}`,"warn"),!0;return!1}getDevice(e){return this.devices.get(e)}isDeviceReady(e){const t=this.devices.get(e);return!!t&&!!t.ws}updateHeartbeat(e){const t=this.devices.get(e);t&&(t.lastHeartbeat=Date.now())}getAllDevices(){return Array.from(this.devices.entries()).map(([e,t])=>({deviceId:e,hasMiniapp:!!t.ws,lastHeartbeat:t.lastHeartbeat}))}get devicesMap(){return this.devices}},_=class{constructor(e){this.httpServer=null,this.deviceManager=e,this.pendingCalls=new Map}setHttpServer(e){this.httpServer=e}handleMessage(e,t){const{type:r,msgId:s,deviceId:n}=e;if(!r||!s){this.sendError(t,s,"INVALID_MESSAGE","消息格式错误");return}switch(r){case"client_call":this.handleClientCall(e,t);break;case"register":this.handleRegister(e,t);break;case"response":this.handleResponse(e,t);break;case"heartbeat":this.handleHeartbeat(e);break;default:this.sendError(t,s,"UNKNOWN_MESSAGE_TYPE",`未知消息类型: ${r}`)}}handleRegister(e,t){const{msgId:r,deviceId:s,deviceInfo:n}=e;if(!s){this.sendError(t,r,"INVALID_DEVICE_ID","设备ID不能为空");return}this.deviceManager.registerDevice(s,t,n||{}),t.send(JSON.stringify({type:"register",msgId:r,deviceId:s,success:!0,timestamp:Date.now()}))}handleClientCall(e,t){const{msgId:r,deviceId:s,api:n,params:l}=e;if(!s){this.sendError(t,r,"INVALID_DEVICE_ID","设备ID不能为空");return}this.pendingCalls.set(r,{ws:t,deviceId:s,timestamp:Date.now()});const o=this.deviceManager.getDevice(s);if(!o||!o.ws){this.pendingCalls.delete(r),this.sendError(t,r,"DEVICE_OFFLINE","代理小程序未连接");return}try{o.ws.send(JSON.stringify(e)),a.log(`转发调用: ${n} → ${s} -> ${r}`,"info")}catch(i){this.pendingCalls.delete(r),this.sendError(t,r,"SEND_FAILED",`发送失败: ${i.message}`)}}handleResponse(e,t){const{msgId:r}=e,s=this.pendingCalls.get(r);if(!s){a.log(`未找到对应的请求: ${r}`,"warn");return}a.log(`转发响应 → msgId: ${r}`,"info");try{s.ws.send(JSON.stringify(e))}catch(n){a.log(`转发响应失败: ${n.message}`,"error")}finally{this.pendingCalls.delete(r)}}handleHeartbeat(e){const{deviceId:t}=e;t&&this.deviceManager.updateHeartbeat(t)}sendError(e,t,r,s){e&&e.readyState===1&&e.send(JSON.stringify({type:"error",msgId:t,timestamp:Date.now(),error:{code:r,message:s}}))}clearPendingCallsForWS(e){for(const[t,r]of this.pendingCalls)r.ws===e&&this.pendingCalls.delete(t)}},C=class{constructor(e){const t={port:3e3,wsPath:"/ws",heartbeatInterval:3e4};this.config={...t,...e},this.deviceManager=new D,this.messageRouter=new _(this.deviceManager),this.wss=null,this.heartbeatTimer=null}start(){this.wss=new c.default.Server({port:this.config.port,path:this.config.wsPath}),this.wss.on("connection",(e,t)=>{this.handleConnection(e,t)}),this.wss.on("error",e=>{a.log(`服务器错误: ${e.message}`,"error")}),this.startHeartbeatCheck(),a.log("代理服务器启动成功","success"),a.log(`监听端口: ${this.config.port}`,"info"),this.displayConnectionInfo()}handleConnection(e,t){const r=new URL(t.url,`http://${t.headers.host}`).searchParams.get("type");a.log(`新连接: ${r||"unknown"}`,"info"),e.on("message",s=>{try{const n=JSON.parse(s.toString());this.messageRouter.handleMessage(n,e)}catch(n){a.log(`消息解析失败: ${n.message}`,"error")}}),e.on("close",()=>{this.deviceManager.disconnect(e),this.messageRouter.clearPendingCallsForWS(e)}),e.on("error",s=>{a.log(`WebSocket错误: ${s.message}`,"error")})}displayConnectionInfo(){const e=a.getLocalIP(),t=a.formatServerUrl(e,this.config.port,"");console.log(`
+╔════════════════════════════════════════════════════════════╗
+║            mPaaS JSAPI 代理服务器                          ║
+╠════════════════════════════════════════════════════════════╣
+║  请在代理小程序中输入以下地址进行注册                      ║
+║                                                            ║
+║  ${t.padEnd(58)}║
+║                                                            ║
+║  或扫描下方二维码快速配置：                                  ║
+╚════════════════════════════════════════════════════════════╝
+    `),console.log("");const r=`url=${encodeURIComponent(t)}`;h.default.generate(r,{small:!0})}startHeartbeatCheck(){this.heartbeatTimer=setInterval(()=>{const e=Date.now(),t=this.config.heartbeatInterval*2;for(const[r,s]of this.deviceManager.devicesMap)e-s.lastHeartbeat>t&&(a.log(`设备心跳超时: ${r}`,"warn"),s.ws&&s.ws.close(),s.simulatorWS&&s.simulatorWS.close(),this.deviceManager.devicesMap.delete(r))},this.config.heartbeatInterval)}stop(){this.heartbeatTimer&&(clearInterval(this.heartbeatTimer),this.heartbeatTimer=null),this.wss&&(this.wss.close(),a.log("服务器已关闭","info"))}},y={port:7521,wsPath:"/ws",heartbeatInterval:3e4},v=new C(y);v.start();process.on("SIGINT",()=>{console.log(`
+正在关闭服务器...`),v.stop(),process.exit(0)});

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "mpaas-jsapi-proxy",
+  "version": "1.0.0",
+  "description": "mPaaS JSAPI 代理服务器",
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx watch src/index.ts",
+    "build": "vite build",
+    "prepublishOnly": "npm run build",
+    "type-check": "tsc --noEmit"
+  },
+  "keywords": [
+    "mpaas",
+    "proxy",
+    "websocket",
+    "jsapi"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/your-username/mpaas-jsapi-proxy.git"
+  },
+  "bugs": {
+    "url": "https://github.com/your-username/mpaas-jsapi-proxy/issues"
+  },
+  "homepage": "https://github.com/your-username/mpaas-jsapi-proxy#readme",
+  "dependencies": {
+    "qrcode-terminal": "^0.12.0",
+    "ws": "^8.14.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@types/ws": "^8.18.1",
+    "esbuild": "^0.28.0",
+    "nodemon": "^3.0.0",
+    "tsx": "^4.22.3",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.14"
+  },
+  "volta": {
+    "node": "18.20.8"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}