speed 1.3.0 → 1.3.1

package/README.md

@@ -16,6 +16,23 @@ npm run start        # 访问 http://127.0.0.1:8080/health
 
 `speed new` 生成的项目使用 **标准装饰器**（TC39，`experimentalDecorators: false`），入口骨架见 `src/main.ts`。
 
+## 注册中心（1.3.1）
+
+注册表是注册中心的「单点真相」，提供 `register` / `unregister` / `getInstances` 三个基础 API（纯内存，同 `host:port` 重复注册只更新不新增）：
+
+```ts
+import { LocalRegistry } from "speed/registry";
+
+const registry = new LocalRegistry();
+registry.register("user-service", { host: "127.0.0.1", port: 8080 });
+registry.register("user-service", { host: "127.0.0.1", port: 8081, metadata: { version: "v2" } });
+
+registry.getInstances("user-service");           // 两个实例
+registry.unregister("user-service", "127.0.0.1", 8080); // true
+```
+
+> 详见 `docs/1.3.1-本地注册表.md`（为什么 → 怎么用 → 原理 → 怎么扩展）。
+
 ## 模块（单包 `speed` + 子路径导出）
 
 | 子路径 | 模块 | 版本 |

package/dist/index.d.ts

@@ -1 +1,2 @@
+export * from "./registry";
 export {};

package/dist/index.js

@@ -1,2 +1,22 @@
 "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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+// speed —— TypeScript 微服务编排框架（对标 Spring Cloud），构建于 typespeed 之上。
+//
+// 骨架阶段（1.3.x）：speed 自身的微服务能力（@Service / @RpcClient / @GatewayRoute / @Config 等）
+// 随模块开发逐步加入；项目入口引导暂由 typespeed 的 @app / ServerFactory 承担
+// （脚手架模板 src/main.ts 直接从 "typespeed" 引入，保证 MAIN_PATH 正确解析到应用目录）。
+__exportStar(require("./registry"), exports);

package/dist/registry/index.d.ts

@@ -1 +1,2 @@
-export {};
+export { LocalRegistry } from "./registry";
+export type { ServiceInstance } from "./registry";

package/dist/registry/index.js

@@ -1,2 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalRegistry = void 0;
+// ① 注册中心（服务注册 + 发现）—— 1.3.x 实现
+var registry_1 = require("./registry");
+Object.defineProperty(exports, "LocalRegistry", { enumerable: true, get: function () { return registry_1.LocalRegistry; } });

package/dist/registry/registry.d.ts

@@ -0,0 +1,14 @@
+export interface ServiceInstance {
+    host: string;
+    port: number;
+    registeredAt?: number;
+    metadata?: Record<string, unknown>;
+}
+export declare class LocalRegistry {
+    private instances;
+    register(serviceName: string, instance: ServiceInstance): ServiceInstance;
+    unregister(serviceName: string, host: string, port: number): boolean;
+    getInstances(serviceName: string): ServiceInstance[];
+    getServiceNames(): string[];
+    getInstanceCount(serviceName: string): number;
+}

package/dist/registry/registry.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalRegistry = void 0;
+// 本地注册表：服务注册 + 发现的单点真相（纯内存，不涉及网络）。
+// 数据结构为两级：服务名 -> 实例列表（实例列表用数组，实例带 metadata 扩展位）。
+class LocalRegistry {
+    // 两级结构：服务名 -> 实例列表（实例列表用数组）
+    instances = new Map();
+    // 注册一个实例。同 host:port 重复注册只更新不新增。
+    register(serviceName, instance) {
+        // 去重键：host:port（同一服务内的实例唯一标识）
+        const key = `${instance.host}:${instance.port}`;
+        const list = this.instances.get(serviceName);
+        // 服务已存在时，在其列表里做线性查找（实例数量少，线性足够）
+        if (list) {
+            const existing = list.find((item) => `${item.host}:${item.port}` === key);
+            if (existing) {
+                // 原地刷新注册时间（心跳语义），并替换 metadata（若本次提供）
+                existing.registeredAt = Date.now();
+                if (instance.metadata !== undefined) {
+                    existing.metadata = instance.metadata;
+                }
+                return existing;
+            }
+            // 新实例补全 registeredAt 后 push 进列表
+            const newInstance = {
+                ...instance,
+                registeredAt: instance.registeredAt ?? Date.now(),
+            };
+            list.push(newInstance);
+            return newInstance;
+        }
+        // 服务不存在：新建列表并存入 map
+        const newInstance = {
+            ...instance,
+            registeredAt: instance.registeredAt ?? Date.now(),
+        };
+        this.instances.set(serviceName, [newInstance]);
+        return newInstance;
+    }
+    // 注销。找到并移除同 host:port 的实例返回 true；否则返回 false。
+    unregister(serviceName, host, port) {
+        const list = this.instances.get(serviceName);
+        if (!list) {
+            return false;
+        }
+        const key = `${host}:${port}`;
+        const index = list.findIndex((item) => `${item.host}:${item.port}` === key);
+        if (index === -1) {
+            return false;
+        }
+        list.splice(index, 1);
+        // 移除后若该服务实例列表为空，把 serviceName 这个 key 从 map 删除
+        if (list.length === 0) {
+            this.instances.delete(serviceName);
+        }
+        return true;
+    }
+    // 返回该服务的实例列表（浅拷贝，防止外部改动内部状态）；服务不存在返回 []
+    getInstances(serviceName) {
+        const list = this.instances.get(serviceName);
+        return list ? [...list] : [];
+    }
+    // 返回所有已注册的服务名
+    getServiceNames() {
+        return Array.from(this.instances.keys());
+    }
+    // 返回该服务下实例数量；服务不存在返回 0
+    getInstanceCount(serviceName) {
+        return this.instances.get(serviceName)?.length ?? 0;
+    }
+}
+exports.LocalRegistry = LocalRegistry;

package/dist/scaffold/command.js

@@ -41,7 +41,7 @@ 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");
+    .version("1.3.1");
 program.command('new <projectName>')
     .description('Create a new speed project.')
     .action((projectName) => {

package/package.json

@@ -1,21 +1,48 @@
 {
   "name": "speed",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "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" }
+    ".": {
+      "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"
@@ -29,12 +56,18 @@
   },
   "devDependencies": {
     "typescript": "^5.9.3",
-    "@types/node": "^22.0.0"
+    "@types/node": "^22.0.0",
+    "mocha": "10.2.0",
+    "chai": "4.3.7",
+    "@types/mocha": "^10.0.1",
+    "@types/chai": "^4.3.11",
+    "ts-node": "^10.9.1"
   },
   "scripts": {
     "build": "tsc -p .",
     "prebuild": "rm -rf dist",
     "postbuild": "cp -r src/scaffold/templates dist/scaffold/templates",
-    "clean": "rm -rf dist"
+    "clean": "rm -rf dist",
+    "test": "NODE_OPTIONS=--no-experimental-strip-types mocha --require ts-node/register test/**/*.ts --exit"
   }
 }