speed 1.2.2 → 1.3.0

package/README.md

@@ -1,2 +1,32 @@
 # speed
-Framework for TypeScript
+
+一个 TypeScript **微服务编排框架**（对标 Spring Cloud），构建于 [typespeed](https://github.com/speedphp/typespeed) 之上。
+
+> 关系：`typespeed`（单体框架 = SpringBoot）造应用，`speed`（微服务编排 = SpringCloud）管应用群。
+
+## 快速开始（1.3.0）
+
+```bash
+npm install speed -g
+speed new demo
+cd demo
+npm install
+npm run start        # 访问 http://127.0.0.1:8080/health
+```
+
+`speed new` 生成的项目使用 **标准装饰器**（TC39，`experimentalDecorators: false`），入口骨架见 `src/main.ts`。
+
+## 模块（单包 `speed` + 子路径导出）
+
+| 子路径 | 模块 | 版本 |
+|---|---|---|
+| `speed/registry` | ① 注册中心 | 1.3.x |
+| `speed/gateway` | ③ API 网关 | 1.4.x |
+| `speed/config` | ② 配置中心 | 1.5.x |
+| `speed/loadbalancer` | ⑤ 负载均衡 | 1.6.x |
+| `speed/circuit-breaker` | ④ 熔断限流 | 1.7.x |
+| `speed/rpc` | ⑥ RPC 客户端 | 1.8.x |
+| `speed/messaging` | ⑧ 消息驱动 | 1.9.x |
+| `speed/observability` | ⑦+⑨ 追踪可观测 | 1.10.x |
+
+> 骨架阶段，开发中。开发计划见 speedphp 项目内的 `speed-微服务化开发计划.md` 及各模块计划文件。

package/dist/circuit-breaker/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/circuit-breaker/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/config/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/config/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/core/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/gateway/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/gateway/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/loadbalancer/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/loadbalancer/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/messaging/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/messaging/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/observability/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/observability/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/registry/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/registry/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/rpc/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/rpc/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/scaffold/command.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/scaffold/command.js

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const program = new commander_1.Command();
+program
+    .name("speed")
+    .description("A microservices orchestration framework for TypeScript (the Spring Cloud equivalent, built on typespeed).")
+    .version("1.3.0");
+program.command('new <projectName>')
+    .description('Create a new speed project.')
+    .action((projectName) => {
+    const currentDir = process.cwd();
+    const appPath = path.join(currentDir, projectName);
+    if (fs.existsSync(appPath)) {
+        console.error('');
+        console.error(`  Error: directory "${projectName}" already exists.`);
+        console.error('');
+        process.exit(1);
+    }
+    fs.mkdirSync(appPath);
+    mkFile("package.json", appPath, projectName);
+    mkFile("tsconfig.json", appPath, projectName);
+    mkFile(".gitignore", appPath, projectName);
+    fs.mkdirSync(path.join(appPath, "src"));
+    mkFile("main.ts", path.join(appPath, "src"), projectName);
+    mkFile("config.json", path.join(appPath, "src"), projectName);
+    console.log('');
+    console.log('  Create speed project success!');
+    console.log('');
+    console.log('  Next steps:');
+    console.log(`    cd ${projectName}`);
+    console.log('    npm install');
+    console.log('    npm run start');
+    console.log('');
+});
+program.on('--help', () => {
+    console.log('');
+    console.log('  Examples:');
+    console.log('');
+    console.log('    $ speed new demo');
+});
+program.parse(process.argv);
+function mkFile(fileName, targetPath, projectName) {
+    const tplPath = path.join(__dirname, "templates");
+    const fileContents = fs.readFileSync(path.join(tplPath, fileName + ".tpl"), "utf-8");
+    fs.writeFileSync(path.join(targetPath, fileName), fileContents.replace(/###appName###/g, projectName));
+}

package/dist/scaffold/templates/.gitignore.tpl

@@ -0,0 +1,4 @@
+node_modules/
+dist/
+*.log
+.DS_Store

package/dist/scaffold/templates/config.json.tpl

@@ -0,0 +1,3 @@
+{
+    "name": "###appName###"
+}

package/dist/scaffold/templates/main.ts.tpl

@@ -0,0 +1,26 @@
+// Symbol.metadata polyfill：Node 22/24/26 均无 Symbol.metadata，
+// 标准装饰器的 context.metadata 依赖它，缺失会 TypeError，必须最先执行。
+(Symbol as { metadata?: symbol }).metadata ??= Symbol("Symbol.metadata");
+
+// 骨架阶段直接使用 typespeed 的 @app 引导（speed 的微服务装饰器 @Service 等自 1.3.2 起提供）。
+import { app, autoware, ServerFactory } from "typespeed";
+
+/**
+ * speed 项目入口骨架（标准装饰器模式）。
+ *
+ * 目录约定：
+ *   - 服务类放 src/（本文件即入口）；
+ *   - 配置文件 src/config.json（可选，typespeed 启动时自动读取，可用 config()/@value 访问）；
+ *   - tsconfig.json 已固定标准装饰器（experimentalDecorators:false + esnext.decorators lib）。
+ */
+@app
+class Main {
+
+    @autoware(ServerFactory)
+    public server!: ServerFactory;
+
+    public main() {
+        this.server.start(8080);
+        console.log("speed service started at http://127.0.0.1:8080");
+    }
+}

package/dist/scaffold/templates/package.json.tpl

@@ -0,0 +1,19 @@
+{
+    "name": "###appName###",
+    "version": "1.0.0",
+    "description": "A speed microservice project (built on typespeed).",
+    "scripts": {
+        "start": "ts-node --transpile-only src/main.ts",
+        "build": "tsc -p .",
+        "test": "ts-node --transpile-only src/main.ts"
+    },
+    "dependencies": {
+        "speed": "^1.3.0",
+        "typespeed": "^2.6.7"
+    },
+    "devDependencies": {
+        "typescript": "^5.9.3",
+        "ts-node": "^10.9.2",
+        "@types/node": "^22.0.0"
+    }
+}

package/dist/scaffold/templates/tsconfig.json.tpl

@@ -0,0 +1,17 @@
+{
+    "compilerOptions": {
+        "target": "es2022",
+        "module": "commonjs",
+        "moduleResolution": "node",
+        "outDir": "./dist",
+        "rootDir": "./src",
+        "strict": false,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "useDefineForClassFields": true,
+        "experimentalDecorators": false,
+        "emitDecoratorMetadata": false,
+        "lib": ["es2022", "esnext.decorators"]
+    },
+    "include": ["src/**/*.ts"]
+}

package/package.json

@@ -1,8 +1,40 @@
 {
   "name": "speed",
-  "version": "1.2.2",
-  "description": "A new Framework for TypeScript.",
-  "author": "speed",
-  "license": "MIT License"
-
+  "version": "1.3.0",
+  "description": "A microservices orchestration framework for TypeScript (the Spring Cloud equivalent, built on typespeed).",
+  "author": "speedphp",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+    "./registry": { "types": "./dist/registry/index.d.ts", "default": "./dist/registry/index.js" },
+    "./gateway": { "types": "./dist/gateway/index.d.ts", "default": "./dist/gateway/index.js" },
+    "./config": { "types": "./dist/config/index.d.ts", "default": "./dist/config/index.js" },
+    "./loadbalancer": { "types": "./dist/loadbalancer/index.d.ts", "default": "./dist/loadbalancer/index.js" },
+    "./circuit-breaker": { "types": "./dist/circuit-breaker/index.d.ts", "default": "./dist/circuit-breaker/index.js" },
+    "./rpc": { "types": "./dist/rpc/index.d.ts", "default": "./dist/rpc/index.js" },
+    "./messaging": { "types": "./dist/messaging/index.d.ts", "default": "./dist/messaging/index.js" },
+    "./observability": { "types": "./dist/observability/index.d.ts", "default": "./dist/observability/index.js" }
+  },
+  "bin": {
+    "speed": "dist/scaffold/command.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "typespeed": "^2.6.7",
+    "commander": "^9.5.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "@types/node": "^22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p .",
+    "prebuild": "rm -rf dist",
+    "postbuild": "cp -r src/scaffold/templates dist/scaffold/templates",
+    "clean": "rm -rf dist"
+  }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2022 speed
-
-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.