@sfmc-bds/cli 0.6.1 → 0.8.0

package/scripts/module-install/.sfmc-registry-cache.json

@@ -1,95 +1,218 @@
 {
-  "fetchedAt": 1790867366873,
+  "fetchedAt": 1792926615467,
   "index": {
     "activity-log": {
       "npm": "@sfmc-bds/module-activity-log",
-      "version": "0.2.2",
-      "sdk": ">=0.2.0"
+      "version": "0.3.0",
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/DogeLakeDev/sfmc-module-activity-log",
+      "name": "行为日志",
+      "category": "system",
+      "license": "ISC",
+      "official": true,
+      "requires": []
     },
     "afk": {
       "npm": "@sfmc-bds/module-afk",
-      "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "version": "0.3.0",
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/DogeLakeDev/sfmc-module-afk",
+      "name": "afk",
+      "category": "utility",
+      "license": "ISC",
+      "official": true,
+      "requires": []
     },
     "area": {
       "npm": "@sfmc-bds/module-area",
       "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/Tanya7z/sfmc-module-area",
+      "name": "area",
+      "description": "区域特性调度引擎",
+      "category": "system",
+      "license": "ISC",
+      "official": true,
+      "requires": []
     },
     "chat": {
       "npm": "@sfmc-bds/module-chat",
-      "version": "0.2.2",
-      "sdk": ">=0.2.2"
+      "version": "0.2.1",
+      "sdk": ">=0.2.0-beta.17",
+      "repo": "https://github.com/Tanya7z/sfmc-module-chat",
+      "name": "chat",
+      "category": "social",
+      "license": "ISC",
+      "official": true,
+      "requires": []
     },
     "chat-sounds": {
       "npm": "@sfmc-bds/module-chat-sounds",
       "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/Tanya7z/sfmc-module-chat-sounds",
+      "name": "chat-sounds",
+      "category": "social",
+      "license": "ISC",
+      "official": true,
+      "requires": [
+        "chat"
+      ]
     },
     "clean": {
       "npm": "@sfmc-bds/module-clean",
       "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/Tanya7z/sfmc-module-clean",
+      "name": "掉落物清理",
+      "description": "区域与全服掉落物预警、倒计时广播与物理回收箱清理",
+      "category": "utility",
+      "license": "ISC",
+      "official": true,
+      "requires": [
+        "area"
+      ]
     },
     "coop": {
       "npm": "@sfmc-bds/module-coop",
       "version": "0.2.2",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0-beta.17",
+      "repo": "https://github.com/Tanya7z/sfmc-module-coop",
+      "name": "合作社",
+      "category": "social",
+      "license": "ISC",
+      "official": true,
+      "requires": [
+        "economy",
+        "activity-log"
+      ]
     },
     "data-backup": {
       "npm": "@sfmc-bds/module-data-backup",
       "version": "0.2.2",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/Tanya7z/sfmc-module-data-backup",
+      "name": "数据备份",
+      "category": "system",
+      "license": "ISC",
+      "official": true,
+      "requires": []
     },
     "economy": {
       "npm": "@sfmc-bds/module-economy",
       "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/Tanya7z/sfmc-module-economy",
+      "name": "经济系统",
+      "category": "economy",
+      "license": "ISC",
+      "official": true,
+      "requires": []
     },
     "fly-area": {
       "npm": "@sfmc-bds/module-fly-area",
       "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/Tanya7z/sfmc-module-fly-area",
+      "name": "区域飞行",
+      "category": "gameplay",
+      "license": "ISC",
+      "official": true,
+      "requires": [
+        "area"
+      ]
     },
     "gamemode-area": {
       "npm": "@sfmc-bds/module-gamemode-area",
       "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/Tanya7z/sfmc-module-gamemode-area",
+      "name": "区域游戏模式",
+      "description": "区域游戏模式切换与背包隔离置换",
+      "category": "gameplay",
+      "license": "ISC",
+      "official": true,
+      "requires": [
+        "area",
+        "inventory-switcher"
+      ]
     },
     "inventory-switcher": {
       "npm": "@sfmc-bds/module-inventory-switcher",
       "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/Tanya7z/sfmc-module-inventory-switcher",
+      "name": "背包切换",
+      "description": "通用背包多槽位快照持久化与原子置换服务",
+      "category": "system",
+      "license": "ISC",
+      "official": true,
+      "requires": []
     },
     "land": {
       "npm": "@sfmc-bds/module-land",
-      "version": "0.2.2",
-      "sdk": ">=0.2.0"
-    },
-    "monitor": {
-      "npm": "@sfmc-bds/module-monitor",
-      "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "version": "1.0.0",
+      "sdk": ">=0.5.0",
+      "repo": "https://github.com/DogeLakeDev/sfmc-module-land",
+      "name": "领地",
+      "category": "gameplay",
+      "license": "ISC",
+      "official": true,
+      "requires": [
+        "economy",
+        "activity-log"
+      ]
     },
     "online-time": {
       "npm": "@sfmc-bds/module-online-time",
       "version": "0.2.2",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0-beta.17",
+      "repo": "https://github.com/Tanya7z/sfmc-module-online-time",
+      "name": "在线时长统计",
+      "description": "进服打点与心跳增量结转在线统计",
+      "category": "utility",
+      "license": "ISC",
+      "official": true,
+      "requires": []
     },
     "peace-area": {
       "npm": "@sfmc-bds/module-peace-area",
-      "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "version": "1.0.0",
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/DogeLakeDev/sfmc-module-peace-area",
+      "name": "和平区域",
+      "description": "区域怪物生成拦截",
+      "category": "gameplay",
+      "license": "ISC",
+      "official": true,
+      "requires": [
+        "area"
+      ]
     },
     "qa": {
       "npm": "@sfmc-bds/module-qa",
       "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0-beta.17",
+      "repo": "https://github.com/Tanya7z/sfmc-module-qa",
+      "name": "QA",
+      "category": "gameplay",
+      "license": "ISC",
+      "official": true,
+      "requires": [
+        "economy",
+        "chat"
+      ]
     },
     "spawn-protect": {
       "npm": "@sfmc-bds/module-spawn-protect",
       "version": "0.2.1",
-      "sdk": ">=0.2.0"
+      "sdk": ">=0.2.0",
+      "repo": "https://github.com/Tanya7z/sfmc-module-spawn-protect",
+      "name": "出生保护",
+      "category": "utility",
+      "license": "ISC",
+      "official": true,
+      "requires": []
     }
   }
 }

package/scripts/module-install/lib/registry-index.mjs

@@ -3,15 +3,40 @@
  * 解析 Tanya7z/sfmc-modules index.json
  *
  * 契约（与 sfmc/src/registry.ts#parseRegistryIndex 保持一致）:
- *   { modules: { <id>: { npm?, version?, sdk?, repo?, tag? } } }
+ *   { modules: { <id>: { npm?, version?, sdk?, repo?, tag?, name?, description?, category?, license?, official?, requires? } } }
  * 条目至少具备 npm 或 repo+tag。`_` 前缀键视为元数据并忽略。
+ * requires 只有在全部是非空字符串时才保留；空数组表示没有额外依赖。缺字段表示索引没有声明依赖。
  */
 
 /**
- * @typedef {{ npm?: string, version?: string, sdk?: string, repo?: string, tag?: string }} RegistryEntry
+ * @typedef {{ npm?: string, version?: string, sdk?: string, repo?: string, tag?: string, name?: string, description?: string, category?: string, license?: string, official?: boolean, requires?: string[] }} RegistryEntry
  * @typedef {Record<string, RegistryEntry>} RegistryIndex
  */
 
+/**
+ * @param {unknown} value
+ * @returns {string | undefined}
+ */
+function optionalText(value) {
+  return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+
+/**
+ * 索引 requires。格式不对时返回 undefined，让安装方拒绝，而不是当成没有依赖。
+ * @param {unknown} value
+ * @returns {string[] | undefined}
+ */
+function optionalRequires(value) {
+  if (!Array.isArray(value)) return undefined;
+  /** @type {string[]} */
+  const items = [];
+  for (const item of value) {
+    if (typeof item !== "string" || !item.trim()) return undefined;
+    items.push(item.trim());
+  }
+  return items;
+}
+
 /**
  * @param {unknown} json
  * @returns {RegistryIndex}
@@ -30,20 +55,32 @@ export function parseRegistryIndex(json) {
     if (k.startsWith("_")) continue;
     if (typeof v !== "object" || v === null || Array.isArray(v)) continue;
     const entry = /** @type {Record<string, unknown>} */ (v);
-    const hasNpm = typeof entry.npm === "string" && entry.npm.length > 0;
-    const hasGh = typeof entry.repo === "string" && typeof entry.tag === "string";
+    const npm = optionalText(entry.npm);
+    const repo = optionalText(entry.repo);
+    const tag = optionalText(entry.tag);
+    const hasNpm = Boolean(npm);
+    const hasGh = Boolean(repo && tag);
     if (!hasNpm && !hasGh) continue;
     /** @type {RegistryEntry} */
     const out = {};
-    if (hasNpm) {
-      out.npm = /** @type {string} */ (entry.npm);
-      if (typeof entry.version === "string") out.version = entry.version;
-      if (typeof entry.sdk === "string") out.sdk = entry.sdk;
-    }
-    if (hasGh) {
-      out.repo = /** @type {string} */ (entry.repo);
-      out.tag = /** @type {string} */ (entry.tag);
-    }
+    if (npm) out.npm = npm;
+    const version = optionalText(entry.version);
+    const sdk = optionalText(entry.sdk);
+    const name = optionalText(entry.name);
+    const description = optionalText(entry.description);
+    const category = optionalText(entry.category);
+    const license = optionalText(entry.license);
+    const requires = optionalRequires(entry.requires);
+    if (version) out.version = version;
+    if (sdk) out.sdk = sdk;
+    if (repo) out.repo = repo;
+    if (repo && tag) out.tag = tag;
+    if (name) out.name = name;
+    if (description) out.description = description;
+    if (category) out.category = category;
+    if (license) out.license = license;
+    if (typeof entry.official === "boolean") out.official = entry.official;
+    if (requires !== undefined) out.requires = requires;
     filtered[k] = out;
   }
   return filtered;