@sfmc-bds/bds-tools 0.2.0-beta.0 → 0.2.0-beta.10

package/dist/pack-update/version-policy.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/pack-update/version-policy.test.ts"],
+  "sourcesContent": ["/**\n * version-policy / slug \u5339\u914D\u6D4B\u8BD5\uFF08\u6D4B\u751F\u4EA7\u5951\u7EA6\uFF0C\u7981\u6B62\u5185\u8054\u590D\u5236\uFF09\n */\nimport assert from \"node:assert/strict\";\nimport { describe, it } from \"node:test\";\nimport {\n  buildSearchQueries,\n  buildSearchQueriesFromSources,\n  collectQuerySeeds,\n  decideVersionPolicy,\n  extractLatinPhrase,\n  insertCjkLatinBoundaries,\n  nextEnabledVersion,\n  normalizePackSearchName,\n  packSourceScore,\n  toCfSlugCandidate,\n} from \"./index.js\";\n\ndescribe(\"version-policy\", () => {\n  it(\"\u540C major \u66F4\u65B0\u5E94 bump RP\", () => {\n    const d = decideVersionPolicy([1, 21, 100], [1, 21, 110], {\n      authority: \"behavior_pack\",\n      onUpdateOverwriteBoth: true,\n      rpBumpWhenSameMajor: true,\n      rpBumpComponent: \"patch\",\n      majorHigherSkipRpBump: true,\n    });\n    assert.equal(d.remoteNewer, true);\n    assert.equal(d.shouldBumpRp, true);\n  });\n\n  it(\"major \u66F4\u9AD8\u5219\u4E0D\u989D\u5916 bump RP\", () => {\n    const d = decideVersionPolicy([1, 21, 100], [2, 0, 0], {\n      authority: \"behavior_pack\",\n      onUpdateOverwriteBoth: true,\n      rpBumpWhenSameMajor: true,\n      rpBumpComponent: \"patch\",\n      majorHigherSkipRpBump: true,\n    });\n    assert.equal(d.majorHigher, true);\n    assert.equal(d.shouldBumpRp, false);\n  });\n\n  it(\"\u540C\u7248\u672C\u672A\u66F4\u9AD8\u65F6\u9ED8\u8BA4\u4E0D bump\uFF1BtreatAsUpdate \u5F3A\u5236\u540C\u6B65\u4ECD\u53EF bump RP\", () => {\n    const policy = {\n      authority: \"behavior_pack\" as const,\n      onUpdateOverwriteBoth: true,\n      rpBumpWhenSameMajor: true,\n      rpBumpComponent: \"patch\" as const,\n      majorHigherSkipRpBump: true,\n    };\n    const plain = decideVersionPolicy([1, 0, 0], [1, 0, 0], policy);\n    assert.equal(plain.remoteNewer, false);\n    assert.equal(plain.shouldBumpRp, false);\n\n    const forced = decideVersionPolicy([1, 0, 0], [1, 0, 0], policy, { treatAsUpdate: true });\n    assert.equal(forced.remoteNewer, false);\n    assert.equal(forced.shouldBumpRp, true);\n  });\n\n  it(\"\u8FDC\u7A0B\u66F4\u65E7\u4F46 treatAsUpdate \u65F6\u4ECD\u6309\u540C major \u89C4\u5219 bump RP\", () => {\n    const d = decideVersionPolicy(\n      [1, 2, 0],\n      [1, 1, 0],\n      {\n        authority: \"behavior_pack\",\n        onUpdateOverwriteBoth: true,\n        rpBumpWhenSameMajor: true,\n        rpBumpComponent: \"patch\",\n        majorHigherSkipRpBump: true,\n      },\n      { treatAsUpdate: true }\n    );\n    assert.equal(d.remoteNewer, false);\n    assert.equal(d.majorHigher, false);\n    assert.equal(d.shouldBumpRp, true);\n  });\n\n  it(\"nextEnabledVersion = bump(max(remote, previous))\", () => {\n    assert.deepEqual(nextEnabledVersion([1, 0, 5], [1, 0, 8], \"patch\"), [1, 0, 9]);\n    assert.deepEqual(nextEnabledVersion([1, 0, 0], [1, 21, 100], \"patch\"), [1, 21, 101]);\n    assert.deepEqual(nextEnabledVersion([2, 0, 0], [1, 99, 99], \"patch\"), [2, 0, 1]);\n    assert.deepEqual(nextEnabledVersion([1, 2, 0], [1, 1, 9], \"minor\"), [1, 3, 0]);\n  });\n\n  it(\"normalize \u53BB\u6389\u65B9\u62EC\u53F7\u3001\u7248\u672C\u4E0E BP\", () => {\n    const n = normalizePackSearchName(\"[BA] [\u73A9\u6CD5] Slash Blade v4 BP\");\n    assert.equal(n, \"Slash Blade\");\n  });\n\n  it(\"CJK \u7C98\u8FDE\u5206\u754C\u5E76\u63D0\u53D6\u62C9\u4E01\u6838\u5FC3\", () => {\n    const folder = \"[BP] [BA] [\u73A9\u6CD5] \u62D4\u5200\u5251Slash Blade v4 BP\";\n    assert.equal(normalizePackSearchName(folder), \"\u62D4\u5200\u5251 Slash Blade\");\n    assert.equal(\n      extractLatinPhrase(insertCjkLatinBoundaries(folder.replace(/\\[[^\\]]*\\]/g, \" \"))),\n      \"Slash Blade v4 BP\"\n    );\n    const seeds = collectQuerySeeds(folder);\n    assert.ok(seeds.includes(\"Slash Blade v4 BP\"));\n    assert.ok(seeds.includes(\"Slash Blade v4\"));\n    assert.ok(seeds.includes(\"Slash Blade\"));\n    assert.ok(seeds.some((s) => s.includes(\"\u62D4\u5200\u5251\")));\n  });\n\n  it(\"\u810F\u6587\u4EF6\u5939\u540D\u6D3E\u751F\u542B slug / Title-Slug / addon\", () => {\n    const qs = buildSearchQueries(\"[BP] [BA] [\u73A9\u6CD5] \u62D4\u5200\u5251Slash Blade v4 BP\");\n    assert.ok(qs.includes(\"slash-blade\"), `queries=${JSON.stringify(qs)}`);\n    assert.ok(qs.includes(\"slash-blade-addon\"), `queries=${JSON.stringify(qs)}`);\n    assert.ok(qs.includes(\"Slash Blade\"), `queries=${JSON.stringify(qs)}`);\n    assert.ok(\n      qs.some((q) => q.toLowerCase() === \"slash-blade\"),\n      `queries=${JSON.stringify(qs)}`\n    );\n    const iSlug = qs.findIndex((q) => q === \"slash-blade-addon\");\n    const iCjk = qs.findIndex((q) => q.includes(\"\u62D4\u5200\u5251\"));\n    assert.ok(iSlug >= 0 && (iCjk < 0 || iSlug < iCjk));\n  });\n\n  it(\"header+\u6587\u4EF6\u5939\u53CC\u6E90\uFF1A\u6709\u62C9\u4E01\u65F6\u4E0D\u641C\u7EAF\u4E2D\u6587\uFF0C\u4E14\u6587\u4EF6\u5939\u8D21\u732E slug\", () => {\n    const qs = buildSearchQueries([\"\u62D4\u5200\u5251\", \"[BP] [BA] [\u73A9\u6CD5] \u62D4\u5200\u5251Slash Blade v4 BP\"]);\n    assert.ok(qs.includes(\"slash-blade-addon\"));\n    assert.ok(qs.includes(\"Slash Blade\"));\n    assert.ok(qs.every((q) => /[A-Za-z]/.test(q)), `\u4E0D\u5E94\u518D\u641C\u7EAF\u4E2D\u6587: ${JSON.stringify(qs)}`);\n  });\n\n  it(\"\u53CC\u6E90\u8F6E\u8BE2\uFF1Aheader \u4E0E folder \u90FD\u4F1A\u8D21\u732E\", () => {\n    const plan = buildSearchQueriesFromSources([\n      { id: \"header\", raw: \"Cool Swords Pack\" },\n      { id: \"folder\", raw: \"[BP] [BA] [\u73A9\u6CD5] \u62D4\u5200\u5251Slash Blade v4 BP\" },\n    ]);\n    assert.ok(plan.perSource.header?.some((q) => /cool|swords/i.test(q)));\n    assert.ok(plan.perSource.folder?.some((q) => /slash-blade/i.test(q)));\n    assert.ok(plan.queries.some((q) => /slash-blade/i.test(q)));\n    assert.ok(plan.queries.some((q) => /cool|swords/i.test(q)));\n  });\n\n  it(\"slug \u5019\u9009\u65E0\u7A7A\u683C\", () => {\n    assert.equal(toCfSlugCandidate(\"Slash Blade v4\"), \"slash-blade\");\n    const qs = buildSearchQueries(\"Slash Blade v4\");\n    assert.ok(qs.includes(\"Slash Blade\"));\n    assert.ok(qs.includes(\"slash-blade\"));\n    assert.ok(qs.includes(\"slash-blade-addon\"));\n  });\n\n  it(\"slug \u547D\u4E2D slash-blade-addon \u9AD8\u5206\", () => {\n    const score = packSourceScore(\"Slash Blade v4\", {\n      name: \"Slash Blade Addon\",\n      slug: \"slash-blade-addon\",\n    });\n    assert.ok(score >= 0.95, `score=${score}`);\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/paths.d.ts

@@ -28,6 +28,6 @@ export interface BdsPaths {
     cfg: BdsUpdaterConfig;
 }
 export declare function resolvePaths(cfg: BdsUpdaterConfig): BdsPaths;
-/** 删除 PID 文件 */
+/** 删除 PID 文件（委托 process-probe，与 bds-manager / sfmc 共用） */
 export declare function clearPid(): void;
 //# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAOL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AAOnC,wCAAwC;AACxC,eAAO,MAAM,QAAQ,EAAE,MAAiE,CAAC;AACzF,eAAO,MAAM,QAAQ,EAAE,MAAiD,CAAC;AAEzE,sCAAsC;AACtC,eAAO,MAAM,SAAS,EAAE,MAA2B,CAAC;AACpD,eAAO,MAAM,QAAQ,EAAE,MAAwC,CAAC;AAChE,eAAO,MAAM,aAAa,EAAE,MAAuD,CAAC;AACpF,eAAO,MAAM,QAAQ,EAAE,MAAwC,CAAC;AAChE,qBAAqB;AACrB,eAAO,MAAM,eAAe,EAAE,MAA0D,CAAC;AAEzF,kDAAkD;AAClD,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;yEACyE;AACzE,wBAAgB,UAAU,IAAI,gBAAgB,CAO7C;AAED,yBAAyB;AACzB,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,QAAQ,CAS5D;AAED,gBAAgB;AAChB,wBAAgB,QAAQ,IAAI,IAAI,CAM/B"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAOL,KAAK,gBAAgB,EACtB,MAAM,2BAA2B,CAAC;AAQnC,wCAAwC;AACxC,eAAO,MAAM,QAAQ,EAAE,MAAuC,CAAC;AAC/D,eAAO,MAAM,QAAQ,EAAE,MAAiD,CAAC;AAEzE,sCAAsC;AACtC,eAAO,MAAM,SAAS,EAAE,MAA2B,CAAC;AACpD,eAAO,MAAM,QAAQ,EAAE,MAAwC,CAAC;AAChE,eAAO,MAAM,aAAa,EAAE,MAAuD,CAAC;AACpF,eAAO,MAAM,QAAQ,EAAE,MAAwC,CAAC;AAChE,qBAAqB;AACrB,eAAO,MAAM,eAAe,EAAE,MAA0D,CAAC;AAEzF,kDAAkD;AAClD,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED;yEACyE;AACzE,wBAAgB,UAAU,IAAI,gBAAgB,CAO7C;AAED,yBAAyB;AACzB,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,QAAQ,CAS5D;AAED,0DAA0D;AAC1D,wBAAgB,QAAQ,IAAI,IAAI,CAE/B"}

package/dist/paths.js

@@ -9,9 +9,10 @@ import {
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { clearBdsPidFile } from "./process-probe.js";
 const __filename = fileURLToPath(import.meta.url);
 const SCRIPT_DIR = path.dirname(__filename);
-const ROOT_DIR = resolveRuntimeRoot(path.resolve(SCRIPT_DIR, "..", ".."));
+const ROOT_DIR = resolveRuntimeRoot(SCRIPT_DIR);
 const CFG_PATH = configPath(ROOT_DIR, "bds_updater.json");
 const STATE_DIR = stateDir(ROOT_DIR);
 const LOG_PATH = logFile(ROOT_DIR, "bds-update");
@@ -40,10 +41,7 @@ function resolvePaths(cfg) {
   return { bds_path, backup_dir, preserve, cfg };
 }
 function clearPid() {
-  try {
-    if (fs.existsSync(PID_FILE)) fs.unlinkSync(PID_FILE);
-  } catch {
-  }
+  clearBdsPidFile(ROOT_DIR);
 }
 export {
   CFG_PATH,

package/dist/paths.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/paths.ts"],
-  "sourcesContent": ["/**\n * paths.ts \u2014 \u8DEF\u5F84\u5E38\u91CF & \u52A0\u8F7D bds_updater.json\n *\n * ROOT_DIR = \u9879\u76EE/\u6570\u636E\u6839,\u901A\u8FC7 SDK \u7EDF\u4E00\u89E3\u6790(env SFMC_ROOT > __dirname \u4E0A\u6EAF)\u3002\n * STATE_DIR / LOG_PATH \u7B49\u8FD0\u884C\u6001\u8DEF\u5F84\u4E00\u5F8B\u8D70 SDK stateDir / logFile,\u52FF\u518D\u624B\u5199 \".sfmc\"\u3002\n */\n\nimport {\n  configPath,\n  DEFAULT_BDS_UPDATER_CONFIG,\n  loadEnsuredConfig,\n  logFile,\n  resolveRuntimeRoot,\n  stateDir,\n  type BdsUpdaterConfig,\n} from \"@sfmc-bds/sdk/node/config\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst SCRIPT_DIR: string = path.dirname(__filename);\n/** \u9879\u76EE\u6839\u76EE\u5F55:bds-tools \u7684\u4E0A\u4E00\u7EA7\u3002\u7EDF\u4E00\u901A\u8FC7 SDK \u89E3\u6790\u3002 */\nexport const ROOT_DIR: string = resolveRuntimeRoot(path.resolve(SCRIPT_DIR, \"..\", \"..\"));\nexport const CFG_PATH: string = configPath(ROOT_DIR, \"bds_updater.json\");\n\n/** \u8FD0\u884C\u6001\u76EE\u5F55(\u76F8\u5BF9\u6570\u636E\u6839\uFF0C\u52FF\u843D\u5728 bds-tools/dist) */\nexport const STATE_DIR: string = stateDir(ROOT_DIR);\nexport const LOG_PATH: string = logFile(ROOT_DIR, \"bds-update\");\nexport const VERSION_CACHE: string = path.join(STATE_DIR, \"bds-version-cache.json\");\nexport const PID_FILE: string = path.join(STATE_DIR, \"bds.pid\");\n/** \u66F4\u65B0\u4E2D\u9014\u5931\u8D25\u53EF\u6062\u590D\u7684\u56DE\u6EDA\u6807\u8BB0 */\nexport const ROLLBACK_MARKER: string = path.join(STATE_DIR, \"last_update_rollback.json\");\n\n/** \u786E\u4FDD .sfmc \u8FD0\u884C\u6001\u76EE\u5F55\u5B58\u5728(PID \u5199\u5165\u7B49\u4E0D\u7ECF writeJson \u7684\u8DEF\u5F84\u9700\u8981) */\nexport function ensureStateDir(): void {\n  fs.mkdirSync(STATE_DIR, { recursive: true });\n}\n\n/** \u52A0\u8F7D\u5E76\u89E3\u6790 bds_updater.json\u3002\n *  \u542F\u52A8\u65F6 ensure \u6587\u4EF6\u5B58\u5728,\u907F\u514D wizard \u6CA1\u8DD1\u65F6 bds_updater.json \u7F3A\u5931\u5BFC\u81F4 loadConfig \u629B\u9519\u3002 */\nexport function loadConfig(): BdsUpdaterConfig {\n  return loadEnsuredConfig(\n    ROOT_DIR,\n    \"bds_updater.json\",\n    \"bds_updater\",\n    { ...DEFAULT_BDS_UPDATER_CONFIG } as Record<string, unknown>\n  ) as BdsUpdaterConfig;\n}\n\n/** \u89E3\u6790\u540E\u7684 BDS \u8DEF\u5F84 / \u5907\u4EFD\u76EE\u5F55 */\nexport interface BdsPaths {\n  bds_path: string;\n  backup_dir: string;\n  preserve: string[];\n  cfg: BdsUpdaterConfig;\n}\n\nexport function resolvePaths(cfg: BdsUpdaterConfig): BdsPaths {\n  const bds_path = path.resolve(cfg.bds_path || process.cwd());\n  const backup_dir = path.resolve(cfg.backup_dir || path.join(bds_path, \"..\", \"backups\"));\n  const relativeBackup = path.relative(bds_path, backup_dir);\n  if (relativeBackup === \"\" || (!relativeBackup.startsWith(\"..\") && !path.isAbsolute(relativeBackup))) {\n    throw new Error(\"backup_dir must be outside bds_path so deployment cannot delete the backup\");\n  }\n  const preserve = Array.isArray(cfg.preserve) ? cfg.preserve : [];\n  return { bds_path, backup_dir, preserve, cfg };\n}\n\n/** \u5220\u9664 PID \u6587\u4EF6 */\nexport function clearPid(): void {\n  try {\n    if (fs.existsSync(PID_FILE)) fs.unlinkSync(PID_FILE);\n  } catch {\n    /* ignore */\n  }\n}\n"],
-  "mappings": "AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAE9B,MAAM,aAAa,cAAc,YAAY,GAAG;AAChD,MAAM,aAAqB,KAAK,QAAQ,UAAU;AAE3C,MAAM,WAAmB,mBAAmB,KAAK,QAAQ,YAAY,MAAM,IAAI,CAAC;AAChF,MAAM,WAAmB,WAAW,UAAU,kBAAkB;AAGhE,MAAM,YAAoB,SAAS,QAAQ;AAC3C,MAAM,WAAmB,QAAQ,UAAU,YAAY;AACvD,MAAM,gBAAwB,KAAK,KAAK,WAAW,wBAAwB;AAC3E,MAAM,WAAmB,KAAK,KAAK,WAAW,SAAS;AAEvD,MAAM,kBAA0B,KAAK,KAAK,WAAW,2BAA2B;AAGhF,SAAS,iBAAuB;AACrC,KAAG,UAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AAC7C;AAIO,SAAS,aAA+B;AAC7C,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,EAAE,GAAG,2BAA2B;AAAA,EAClC;AACF;AAUO,SAAS,aAAa,KAAiC;AAC5D,QAAM,WAAW,KAAK,QAAQ,IAAI,YAAY,QAAQ,IAAI,CAAC;AAC3D,QAAM,aAAa,KAAK,QAAQ,IAAI,cAAc,KAAK,KAAK,UAAU,MAAM,SAAS,CAAC;AACtF,QAAM,iBAAiB,KAAK,SAAS,UAAU,UAAU;AACzD,MAAI,mBAAmB,MAAO,CAAC,eAAe,WAAW,IAAI,KAAK,CAAC,KAAK,WAAW,cAAc,GAAI;AACnG,UAAM,IAAI,MAAM,4EAA4E;AAAA,EAC9F;AACA,QAAM,WAAW,MAAM,QAAQ,IAAI,QAAQ,IAAI,IAAI,WAAW,CAAC;AAC/D,SAAO,EAAE,UAAU,YAAY,UAAU,IAAI;AAC/C;AAGO,SAAS,WAAiB;AAC/B,MAAI;AACF,QAAI,GAAG,WAAW,QAAQ,EAAG,IAAG,WAAW,QAAQ;AAAA,EACrD,QAAQ;AAAA,EAER;AACF;",
+  "sourcesContent": ["/**\n * paths.ts \u2014 \u8DEF\u5F84\u5E38\u91CF & \u52A0\u8F7D bds_updater.json\n *\n * ROOT_DIR = \u9879\u76EE/\u6570\u636E\u6839,\u901A\u8FC7 SDK \u7EDF\u4E00\u89E3\u6790(env SFMC_ROOT > __dirname \u4E0A\u6EAF)\u3002\n * STATE_DIR / LOG_PATH \u7B49\u8FD0\u884C\u6001\u8DEF\u5F84\u4E00\u5F8B\u8D70 SDK stateDir / logFile,\u52FF\u518D\u624B\u5199 \".sfmc\"\u3002\n */\n\nimport {\n  configPath,\n  DEFAULT_BDS_UPDATER_CONFIG,\n  loadEnsuredConfig,\n  logFile,\n  resolveRuntimeRoot,\n  stateDir,\n  type BdsUpdaterConfig,\n} from \"@sfmc-bds/sdk/node/config\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { clearBdsPidFile } from \"./process-probe.js\";\n\nconst __filename = fileURLToPath(import.meta.url);\nconst SCRIPT_DIR: string = path.dirname(__filename);\n/** \u9879\u76EE\u6839\u76EE\u5F55:bds-tools \u7684\u4E0A\u4E00\u7EA7\u3002\u7EDF\u4E00\u901A\u8FC7 SDK \u89E3\u6790\u3002 */\nexport const ROOT_DIR: string = resolveRuntimeRoot(SCRIPT_DIR);\nexport const CFG_PATH: string = configPath(ROOT_DIR, \"bds_updater.json\");\n\n/** \u8FD0\u884C\u6001\u76EE\u5F55(\u76F8\u5BF9\u6570\u636E\u6839\uFF0C\u52FF\u843D\u5728 bds-tools/dist) */\nexport const STATE_DIR: string = stateDir(ROOT_DIR);\nexport const LOG_PATH: string = logFile(ROOT_DIR, \"bds-update\");\nexport const VERSION_CACHE: string = path.join(STATE_DIR, \"bds-version-cache.json\");\nexport const PID_FILE: string = path.join(STATE_DIR, \"bds.pid\");\n/** \u66F4\u65B0\u4E2D\u9014\u5931\u8D25\u53EF\u6062\u590D\u7684\u56DE\u6EDA\u6807\u8BB0 */\nexport const ROLLBACK_MARKER: string = path.join(STATE_DIR, \"last_update_rollback.json\");\n\n/** \u786E\u4FDD .sfmc \u8FD0\u884C\u6001\u76EE\u5F55\u5B58\u5728(PID \u5199\u5165\u7B49\u4E0D\u7ECF writeJson \u7684\u8DEF\u5F84\u9700\u8981) */\nexport function ensureStateDir(): void {\n  fs.mkdirSync(STATE_DIR, { recursive: true });\n}\n\n/** \u52A0\u8F7D\u5E76\u89E3\u6790 bds_updater.json\u3002\n *  \u542F\u52A8\u65F6 ensure \u6587\u4EF6\u5B58\u5728,\u907F\u514D wizard \u6CA1\u8DD1\u65F6 bds_updater.json \u7F3A\u5931\u5BFC\u81F4 loadConfig \u629B\u9519\u3002 */\nexport function loadConfig(): BdsUpdaterConfig {\n  return loadEnsuredConfig(\n    ROOT_DIR,\n    \"bds_updater.json\",\n    \"bds_updater\",\n    { ...DEFAULT_BDS_UPDATER_CONFIG } as Record<string, unknown>\n  ) as BdsUpdaterConfig;\n}\n\n/** \u89E3\u6790\u540E\u7684 BDS \u8DEF\u5F84 / \u5907\u4EFD\u76EE\u5F55 */\nexport interface BdsPaths {\n  bds_path: string;\n  backup_dir: string;\n  preserve: string[];\n  cfg: BdsUpdaterConfig;\n}\n\nexport function resolvePaths(cfg: BdsUpdaterConfig): BdsPaths {\n  const bds_path = path.resolve(cfg.bds_path || process.cwd());\n  const backup_dir = path.resolve(cfg.backup_dir || path.join(bds_path, \"..\", \"backups\"));\n  const relativeBackup = path.relative(bds_path, backup_dir);\n  if (relativeBackup === \"\" || (!relativeBackup.startsWith(\"..\") && !path.isAbsolute(relativeBackup))) {\n    throw new Error(\"backup_dir must be outside bds_path so deployment cannot delete the backup\");\n  }\n  const preserve = Array.isArray(cfg.preserve) ? cfg.preserve : [];\n  return { bds_path, backup_dir, preserve, cfg };\n}\n\n/** \u5220\u9664 PID \u6587\u4EF6\uFF08\u59D4\u6258 process-probe\uFF0C\u4E0E bds-manager / sfmc \u5171\u7528\uFF09 */\nexport function clearPid(): void {\n  clearBdsPidFile(ROOT_DIR);\n}\n"],
+  "mappings": "AAOA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAC9B,SAAS,uBAAuB;AAEhC,MAAM,aAAa,cAAc,YAAY,GAAG;AAChD,MAAM,aAAqB,KAAK,QAAQ,UAAU;AAE3C,MAAM,WAAmB,mBAAmB,UAAU;AACtD,MAAM,WAAmB,WAAW,UAAU,kBAAkB;AAGhE,MAAM,YAAoB,SAAS,QAAQ;AAC3C,MAAM,WAAmB,QAAQ,UAAU,YAAY;AACvD,MAAM,gBAAwB,KAAK,KAAK,WAAW,wBAAwB;AAC3E,MAAM,WAAmB,KAAK,KAAK,WAAW,SAAS;AAEvD,MAAM,kBAA0B,KAAK,KAAK,WAAW,2BAA2B;AAGhF,SAAS,iBAAuB;AACrC,KAAG,UAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AAC7C;AAIO,SAAS,aAA+B;AAC7C,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA,EAAE,GAAG,2BAA2B;AAAA,EAClC;AACF;AAUO,SAAS,aAAa,KAAiC;AAC5D,QAAM,WAAW,KAAK,QAAQ,IAAI,YAAY,QAAQ,IAAI,CAAC;AAC3D,QAAM,aAAa,KAAK,QAAQ,IAAI,cAAc,KAAK,KAAK,UAAU,MAAM,SAAS,CAAC;AACtF,QAAM,iBAAiB,KAAK,SAAS,UAAU,UAAU;AACzD,MAAI,mBAAmB,MAAO,CAAC,eAAe,WAAW,IAAI,KAAK,CAAC,KAAK,WAAW,cAAc,GAAI;AACnG,UAAM,IAAI,MAAM,4EAA4E;AAAA,EAC9F;AACA,QAAM,WAAW,MAAM,QAAQ,IAAI,QAAQ,IAAI,IAAI,WAAW,CAAC;AAC/D,SAAO,EAAE,UAAU,YAAY,UAAU,IAAI;AAC/C;AAGO,SAAS,WAAiB;AAC/B,kBAAgB,QAAQ;AAC1B;",
   "names": []
 }

package/dist/process-probe.d.ts

@@ -0,0 +1,34 @@
+/**
+ * process-probe.ts — OS 级 BDS 进程探测与 PID 文件管理
+ *
+ * 供 bds-manager / sfmc 共用，避免重复 tasklist / taskkill 逻辑。
+ */
+export type ExecFn = (cmd: string, opts?: {
+    windowsHide?: boolean;
+}) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+/** 测试注入 exec，传 null 恢复默认 */
+export declare function setExecForTesting(fn: ExecFn | null): void;
+export declare function readBdsPidFile(rootDir?: string): number;
+export declare function writeBdsPidFile(pid: number, rootDir?: string): void;
+export declare function clearBdsPidFile(rootDir?: string): void;
+/** 测试注入探活，传 null 恢复默认（避免 Linux 上 process.kill 碰到真实 PID） */
+export declare function setIsAliveForTesting(fn: ((pid: number) => boolean) | null): void;
+export declare function isProcessAlive(pid: number): Promise<boolean>;
+/** 同步探活（供 sync 的 sendCommand 等路径；避免 Promise 被当 truthy） */
+export declare function isProcessAliveSync(pid: number): boolean;
+export declare function findBedrockServerPids(): Promise<number[]>;
+export declare function killBedrockServerByImage(): Promise<void>;
+export type BdsProbeState = "stopped" | "managed" | "external";
+export interface BdsProbeResult {
+    state: BdsProbeState;
+    pid: number;
+}
+export declare function probeBdsStatus(opts: {
+    managedPid?: number;
+    hasStdin?: boolean;
+    rootDir?: string;
+}): Promise<BdsProbeResult>;
+//# sourceMappingURL=process-probe.d.ts.map

package/dist/process-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-probe.d.ts","sourceRoot":"","sources":["../src/process-probe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,MAAM,MAAM,MAAM,GAAG,CACnB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,KAC7B,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAOjD,4BAA4B;AAC5B,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAOzD;AAcD,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAMvD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAOnE;AAED,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAOtD;AAID,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,IAAI,GAAG,IAAI,CAEhF;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAalE;AAED,0DAA0D;AAC1D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAgBvD;AAED,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CA0B/D;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAU9D;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuB1B"}

package/dist/process-probe.js

@@ -0,0 +1,152 @@
+import { exec, execSync } from "node:child_process";
+import { promisify } from "node:util";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { resolveRuntimeRoot, stateDir } from "@sfmc-bds/sdk/node/config";
+import { bdsExeName } from "./host-platform.js";
+const execAsync = promisify(exec);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const DEFAULT_ROOT_DIR = resolveRuntimeRoot(__dirname);
+let execImpl = async (cmd, opts) => {
+  const result = await execAsync(cmd, opts);
+  return { stdout: String(result.stdout), stderr: String(result.stderr) };
+};
+function setExecForTesting(fn) {
+  execImpl = fn ?? (async (cmd, opts) => {
+    const result = await execAsync(cmd, opts);
+    return { stdout: String(result.stdout), stderr: String(result.stderr) };
+  });
+}
+function resolveRoot(rootDir) {
+  return rootDir ?? DEFAULT_ROOT_DIR;
+}
+function pidFilePath(rootDir) {
+  return path.join(stateDir(resolveRoot(rootDir)), "bds.pid");
+}
+function ensureStateDirForRoot(rootDir) {
+  fs.mkdirSync(stateDir(resolveRoot(rootDir)), { recursive: true });
+}
+function readBdsPidFile(rootDir) {
+  try {
+    return parseInt(fs.readFileSync(pidFilePath(rootDir), "utf-8").trim(), 10) || 0;
+  } catch {
+    return 0;
+  }
+}
+function writeBdsPidFile(pid, rootDir) {
+  try {
+    ensureStateDirForRoot(rootDir);
+    fs.writeFileSync(pidFilePath(rootDir), String(pid));
+  } catch {
+  }
+}
+function clearBdsPidFile(rootDir) {
+  try {
+    const file = pidFilePath(rootDir);
+    if (fs.existsSync(file)) fs.unlinkSync(file);
+  } catch {
+  }
+}
+let aliveOverride = null;
+function setIsAliveForTesting(fn) {
+  aliveOverride = fn;
+}
+async function isProcessAlive(pid) {
+  if (!pid) return false;
+  if (aliveOverride) return aliveOverride(pid);
+  try {
+    if (process.platform === "win32") {
+      const { stdout } = await execImpl(`tasklist /fi "PID eq ${pid}" /nh`, { windowsHide: true });
+      return stdout.includes(String(pid));
+    }
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isProcessAliveSync(pid) {
+  if (!pid) return false;
+  if (aliveOverride) return aliveOverride(pid);
+  try {
+    if (process.platform === "win32") {
+      const stdout = execSync(`tasklist /fi "PID eq ${pid}" /nh`, {
+        windowsHide: true,
+        encoding: "utf8"
+      });
+      return String(stdout).includes(String(pid));
+    }
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+async function findBedrockServerPids() {
+  try {
+    if (process.platform === "win32") {
+      const image = bdsExeName("windows");
+      const { stdout: stdout2 } = await execImpl(`tasklist /fi "IMAGENAME eq ${image}" /fo csv /nh`, {
+        windowsHide: true
+      });
+      const pids = [];
+      const re = new RegExp(`"${image.replace(".", "\\.")}","(\\d+)"`, "i");
+      for (const line of stdout2.split(/\r?\n/)) {
+        const m = line.match(re);
+        if (m) {
+          const pid = parseInt(m[1] ?? "0", 10);
+          if (pid > 0) pids.push(pid);
+        }
+      }
+      return pids;
+    }
+    const { stdout } = await execImpl("pgrep -x bedrock_server", { windowsHide: true });
+    return stdout.split(/\r?\n/).map((s) => parseInt(s.trim(), 10)).filter((n) => n > 0);
+  } catch {
+    return [];
+  }
+}
+async function killBedrockServerByImage() {
+  try {
+    if (process.platform === "win32") {
+      await execImpl(`taskkill /f /im ${bdsExeName("windows")}`, { windowsHide: true });
+    } else {
+      await execImpl("pkill -x bedrock_server", { windowsHide: true });
+    }
+  } catch {
+  }
+}
+async function probeBdsStatus(opts) {
+  const managedPid = opts.managedPid ?? 0;
+  const hasStdin = opts.hasStdin ?? false;
+  if (managedPid > 0 && hasStdin && await isProcessAlive(managedPid)) {
+    return { state: "managed", pid: managedPid };
+  }
+  const filePid = readBdsPidFile(opts.rootDir);
+  if (filePid > 0 && await isProcessAlive(filePid)) {
+    return { state: "external", pid: filePid };
+  }
+  const imagePids = await findBedrockServerPids();
+  if (imagePids.length > 0) {
+    return { state: "external", pid: imagePids[0] ?? 0 };
+  }
+  if (filePid > 0) {
+    clearBdsPidFile(opts.rootDir);
+  }
+  return { state: "stopped", pid: 0 };
+}
+export {
+  clearBdsPidFile,
+  findBedrockServerPids,
+  isProcessAlive,
+  isProcessAliveSync,
+  killBedrockServerByImage,
+  probeBdsStatus,
+  readBdsPidFile,
+  setExecForTesting,
+  setIsAliveForTesting,
+  writeBdsPidFile
+};
+//# sourceMappingURL=process-probe.js.map

package/dist/process-probe.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/process-probe.ts"],
+  "sourcesContent": ["/**\n * process-probe.ts \u2014 OS \u7EA7 BDS \u8FDB\u7A0B\u63A2\u6D4B\u4E0E PID \u6587\u4EF6\u7BA1\u7406\n *\n * \u4F9B bds-manager / sfmc \u5171\u7528\uFF0C\u907F\u514D\u91CD\u590D tasklist / taskkill \u903B\u8F91\u3002\n */\n\nimport { exec, execSync } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { resolveRuntimeRoot, stateDir } from \"@sfmc-bds/sdk/node/config\";\nimport { bdsExeName } from \"./host-platform.js\";\n\nconst execAsync = promisify(exec);\n\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = path.dirname(__filename);\n\n/** \u4E0E paths.ROOT_DIR \u4E00\u81F4\uFF1ASFMC_ROOT > walk-up monorepo */\nconst DEFAULT_ROOT_DIR = resolveRuntimeRoot(__dirname);\n\nexport type ExecFn = (\n  cmd: string,\n  opts?: { windowsHide?: boolean }\n) => Promise<{ stdout: string; stderr: string }>;\n\nlet execImpl: ExecFn = async (cmd, opts) => {\n  const result = await execAsync(cmd, opts);\n  return { stdout: String(result.stdout), stderr: String(result.stderr) };\n};\n\n/** \u6D4B\u8BD5\u6CE8\u5165 exec\uFF0C\u4F20 null \u6062\u590D\u9ED8\u8BA4 */\nexport function setExecForTesting(fn: ExecFn | null): void {\n  execImpl =\n    fn ??\n    (async (cmd, opts) => {\n      const result = await execAsync(cmd, opts);\n      return { stdout: String(result.stdout), stderr: String(result.stderr) };\n    });\n}\n\nfunction resolveRoot(rootDir?: string): string {\n  return rootDir ?? DEFAULT_ROOT_DIR;\n}\n\nfunction pidFilePath(rootDir?: string): string {\n  return path.join(stateDir(resolveRoot(rootDir)), \"bds.pid\");\n}\n\nfunction ensureStateDirForRoot(rootDir?: string): void {\n  fs.mkdirSync(stateDir(resolveRoot(rootDir)), { recursive: true });\n}\n\nexport function readBdsPidFile(rootDir?: string): number {\n  try {\n    return parseInt(fs.readFileSync(pidFilePath(rootDir), \"utf-8\").trim(), 10) || 0;\n  } catch {\n    return 0;\n  }\n}\n\nexport function writeBdsPidFile(pid: number, rootDir?: string): void {\n  try {\n    ensureStateDirForRoot(rootDir);\n    fs.writeFileSync(pidFilePath(rootDir), String(pid));\n  } catch {\n    /* ignore */\n  }\n}\n\nexport function clearBdsPidFile(rootDir?: string): void {\n  try {\n    const file = pidFilePath(rootDir);\n    if (fs.existsSync(file)) fs.unlinkSync(file);\n  } catch {\n    /* ignore */\n  }\n}\n\nlet aliveOverride: ((pid: number) => boolean) | null = null;\n\n/** \u6D4B\u8BD5\u6CE8\u5165\u63A2\u6D3B\uFF0C\u4F20 null \u6062\u590D\u9ED8\u8BA4\uFF08\u907F\u514D Linux \u4E0A process.kill \u78B0\u5230\u771F\u5B9E PID\uFF09 */\nexport function setIsAliveForTesting(fn: ((pid: number) => boolean) | null): void {\n  aliveOverride = fn;\n}\n\nexport async function isProcessAlive(pid: number): Promise<boolean> {\n  if (!pid) return false;\n  if (aliveOverride) return aliveOverride(pid);\n  try {\n    if (process.platform === \"win32\") {\n      const { stdout } = await execImpl(`tasklist /fi \"PID eq ${pid}\" /nh`, { windowsHide: true });\n      return stdout.includes(String(pid));\n    }\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/** \u540C\u6B65\u63A2\u6D3B\uFF08\u4F9B sync \u7684 sendCommand \u7B49\u8DEF\u5F84\uFF1B\u907F\u514D Promise \u88AB\u5F53 truthy\uFF09 */\nexport function isProcessAliveSync(pid: number): boolean {\n  if (!pid) return false;\n  if (aliveOverride) return aliveOverride(pid);\n  try {\n    if (process.platform === \"win32\") {\n      const stdout = execSync(`tasklist /fi \"PID eq ${pid}\" /nh`, {\n        windowsHide: true,\n        encoding: \"utf8\",\n      });\n      return String(stdout).includes(String(pid));\n    }\n    process.kill(pid, 0);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\nexport async function findBedrockServerPids(): Promise<number[]> {\n  try {\n    if (process.platform === \"win32\") {\n      const image = bdsExeName(\"windows\");\n      const { stdout } = await execImpl(`tasklist /fi \"IMAGENAME eq ${image}\" /fo csv /nh`, {\n        windowsHide: true,\n      });\n      const pids: number[] = [];\n      const re = new RegExp(`\"${image.replace(\".\", \"\\\\.\")}\",\"(\\\\d+)\"`, \"i\");\n      for (const line of stdout.split(/\\r?\\n/)) {\n        const m = line.match(re);\n        if (m) {\n          const pid = parseInt(m[1] ?? \"0\", 10);\n          if (pid > 0) pids.push(pid);\n        }\n      }\n      return pids;\n    }\n    const { stdout } = await execImpl(\"pgrep -x bedrock_server\", { windowsHide: true });\n    return stdout\n      .split(/\\r?\\n/)\n      .map((s) => parseInt(s.trim(), 10))\n      .filter((n) => n > 0);\n  } catch {\n    return [];\n  }\n}\n\nexport async function killBedrockServerByImage(): Promise<void> {\n  try {\n    if (process.platform === \"win32\") {\n      await execImpl(`taskkill /f /im ${bdsExeName(\"windows\")}`, { windowsHide: true });\n    } else {\n      await execImpl(\"pkill -x bedrock_server\", { windowsHide: true });\n    }\n  } catch {\n    /* ignore \u2014 \u65E0\u8FDB\u7A0B\u65F6 taskkill/pkill \u4F1A\u975E\u96F6\u9000\u51FA */\n  }\n}\n\nexport type BdsProbeState = \"stopped\" | \"managed\" | \"external\";\n\nexport interface BdsProbeResult {\n  state: BdsProbeState;\n  pid: number;\n}\n\nexport async function probeBdsStatus(opts: {\n  managedPid?: number;\n  hasStdin?: boolean;\n  rootDir?: string;\n}): Promise<BdsProbeResult> {\n  const managedPid = opts.managedPid ?? 0;\n  const hasStdin = opts.hasStdin ?? false;\n\n  if (managedPid > 0 && hasStdin && (await isProcessAlive(managedPid))) {\n    return { state: \"managed\", pid: managedPid };\n  }\n\n  const filePid = readBdsPidFile(opts.rootDir);\n  if (filePid > 0 && (await isProcessAlive(filePid))) {\n    return { state: \"external\", pid: filePid };\n  }\n\n  const imagePids = await findBedrockServerPids();\n  if (imagePids.length > 0) {\n    return { state: \"external\", pid: imagePids[0] ?? 0 };\n  }\n\n  if (filePid > 0) {\n    clearBdsPidFile(opts.rootDir);\n  }\n\n  return { state: \"stopped\", pid: 0 };\n}\n"],
+  "mappings": "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",
+  "names": ["stdout"]
+}

package/dist/process-probe.test.js

@@ -0,0 +1,76 @@
+import assert from "node:assert/strict";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { after, describe, it } from "node:test";
+import * as probe from "./process-probe.js";
+describe("process-probe pid file", () => {
+  let tempRoot = "";
+  after(() => {
+    if (tempRoot) {
+      fs.rmSync(tempRoot, { recursive: true, force: true });
+    }
+  });
+  it("read/write/clear bds.pid \u5728\u72EC\u7ACB temp \u6839\u76EE\u5F55", () => {
+    tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "sfmc-probe-"));
+    assert.equal(probe.readBdsPidFile(tempRoot), 0);
+    probe.writeBdsPidFile(4242, tempRoot);
+    assert.equal(probe.readBdsPidFile(tempRoot), 4242);
+    probe.clearBdsPidFile(tempRoot);
+    assert.equal(probe.readBdsPidFile(tempRoot), 0);
+  });
+});
+describe("process-probe probeBdsStatus", () => {
+  let tempRoot = "";
+  const calls = [];
+  after(() => {
+    probe.setExecForTesting(null);
+    probe.setIsAliveForTesting(null);
+    if (tempRoot) {
+      fs.rmSync(tempRoot, { recursive: true, force: true });
+    }
+  });
+  it("managedPid + hasStdin \u4E14\u8FDB\u7A0B\u5B58\u6D3B \u2192 managed", async () => {
+    tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "sfmc-probe-"));
+    calls.length = 0;
+    probe.setIsAliveForTesting((pid) => pid === 100);
+    probe.setExecForTesting(async (cmd) => {
+      calls.push(cmd);
+      if (cmd.includes("PID eq 100")) {
+        return { stdout: "bedrock_server.exe  100 Console", stderr: "" };
+      }
+      return { stdout: "", stderr: "" };
+    });
+    const result = await probe.probeBdsStatus({ managedPid: 100, hasStdin: true, rootDir: tempRoot });
+    assert.deepEqual(result, { state: "managed", pid: 100 });
+  });
+  it("PID \u6587\u4EF6\u5B58\u6D3B\u4F46\u65E0 stdin \u2192 external", async () => {
+    probe.writeBdsPidFile(200, tempRoot);
+    probe.setIsAliveForTesting((pid) => pid === 200);
+    probe.setExecForTesting(async (cmd) => {
+      if (cmd.includes("PID eq 200")) {
+        return { stdout: "bedrock_server.exe  200 Console", stderr: "" };
+      }
+      return { stdout: "", stderr: "" };
+    });
+    const result = await probe.probeBdsStatus({ managedPid: 200, hasStdin: false, rootDir: tempRoot });
+    assert.equal(result.state, "external");
+    assert.equal(result.pid, 200);
+  });
+  it("\u65E0 PID \u6587\u4EF6\u4F46\u6709 bedrock_server \u955C\u50CF \u2192 external", async () => {
+    probe.clearBdsPidFile(tempRoot);
+    probe.setIsAliveForTesting(() => false);
+    probe.setExecForTesting(async (cmd) => {
+      if (cmd.includes("IMAGENAME eq bedrock_server.exe")) {
+        return { stdout: '"bedrock_server.exe","555","Console","1","999 K"\n', stderr: "" };
+      }
+      if (cmd.includes("pgrep")) {
+        return { stdout: "555\n", stderr: "" };
+      }
+      return { stdout: "", stderr: "" };
+    });
+    const result = await probe.probeBdsStatus({ rootDir: tempRoot });
+    assert.deepEqual(result, { state: "external", pid: 555 });
+  });
+});
+//# sourceMappingURL=process-probe.test.js.map

package/dist/process-probe.test.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/process-probe.test.ts"],
+  "sourcesContent": ["/**\n * process-probe \u5355\u5143\u6D4B\u8BD5\uFF1APID \u6587\u4EF6\u7EAF\u51FD\u6570 + \u53EF\u6CE8\u5165 exec \u7684\u63A2\u6D4B\u903B\u8F91\n */\nimport assert from \"node:assert/strict\";\nimport fs from \"node:fs\";\nimport os from \"node:os\";\nimport path from \"node:path\";\nimport { after, describe, it } from \"node:test\";\nimport * as probe from \"./process-probe.js\";\n\ndescribe(\"process-probe pid file\", () => {\n  let tempRoot = \"\";\n\n  after(() => {\n    if (tempRoot) {\n      fs.rmSync(tempRoot, { recursive: true, force: true });\n    }\n  });\n\n  it(\"read/write/clear bds.pid \u5728\u72EC\u7ACB temp \u6839\u76EE\u5F55\", () => {\n    tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), \"sfmc-probe-\"));\n\n    assert.equal(probe.readBdsPidFile(tempRoot), 0);\n\n    probe.writeBdsPidFile(4242, tempRoot);\n    assert.equal(probe.readBdsPidFile(tempRoot), 4242);\n\n    probe.clearBdsPidFile(tempRoot);\n    assert.equal(probe.readBdsPidFile(tempRoot), 0);\n  });\n});\n\ndescribe(\"process-probe probeBdsStatus\", () => {\n  let tempRoot = \"\";\n  const calls: string[] = [];\n\n  after(() => {\n    probe.setExecForTesting(null);\n    probe.setIsAliveForTesting(null);\n    if (tempRoot) {\n      fs.rmSync(tempRoot, { recursive: true, force: true });\n    }\n  });\n\n  it(\"managedPid + hasStdin \u4E14\u8FDB\u7A0B\u5B58\u6D3B \u2192 managed\", async () => {\n    tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), \"sfmc-probe-\"));\n    calls.length = 0;\n    probe.setIsAliveForTesting((pid) => pid === 100);\n\n    probe.setExecForTesting(async (cmd) => {\n      calls.push(cmd);\n      if (cmd.includes(\"PID eq 100\")) {\n        return { stdout: \"bedrock_server.exe  100 Console\", stderr: \"\" };\n      }\n      return { stdout: \"\", stderr: \"\" };\n    });\n\n    const result = await probe.probeBdsStatus({ managedPid: 100, hasStdin: true, rootDir: tempRoot });\n    assert.deepEqual(result, { state: \"managed\", pid: 100 });\n  });\n\n  it(\"PID \u6587\u4EF6\u5B58\u6D3B\u4F46\u65E0 stdin \u2192 external\", async () => {\n    probe.writeBdsPidFile(200, tempRoot);\n    probe.setIsAliveForTesting((pid) => pid === 200);\n\n    probe.setExecForTesting(async (cmd) => {\n      if (cmd.includes(\"PID eq 200\")) {\n        return { stdout: \"bedrock_server.exe  200 Console\", stderr: \"\" };\n      }\n      return { stdout: \"\", stderr: \"\" };\n    });\n\n    const result = await probe.probeBdsStatus({ managedPid: 200, hasStdin: false, rootDir: tempRoot });\n    assert.equal(result.state, \"external\");\n    assert.equal(result.pid, 200);\n  });\n\n  it(\"\u65E0 PID \u6587\u4EF6\u4F46\u6709 bedrock_server \u955C\u50CF \u2192 external\", async () => {\n    probe.clearBdsPidFile(tempRoot);\n    probe.setIsAliveForTesting(() => false);\n\n    probe.setExecForTesting(async (cmd) => {\n      if (cmd.includes(\"IMAGENAME eq bedrock_server.exe\")) {\n        return { stdout: '\"bedrock_server.exe\",\"555\",\"Console\",\"1\",\"999 K\"\\n', stderr: \"\" };\n      }\n      if (cmd.includes(\"pgrep\")) {\n        return { stdout: \"555\\n\", stderr: \"\" };\n      }\n      return { stdout: \"\", stderr: \"\" };\n    });\n\n    const result = await probe.probeBdsStatus({ rootDir: tempRoot });\n    assert.deepEqual(result, { state: \"external\", pid: 555 });\n  });\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/qq-events-notify.d.ts

@@ -0,0 +1,16 @@
+/**
+ * qq-events-notify.ts — 向 db-server 上报 BDS 启停事件
+ *
+ * 只 POST 结构化事件；群 openid / 频控由 db-server 处理（DIP）。
+ * 失败仅 warn，不抛错。
+ */
+export type BdsLifecycleEventType = "crash" | "start";
+/**
+ * POST /api/sfmc/qq/events；超时/非 2xx 不抛。
+ */
+export declare function postBdsLifecycleEvent(type: BdsLifecycleEventType, detail?: string, opts?: {
+    host?: string;
+    port?: number;
+    timeoutMs?: number;
+}): Promise<void>;
+//# sourceMappingURL=qq-events-notify.d.ts.map

package/dist/qq-events-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qq-events-notify.d.ts","sourceRoot":"","sources":["../src/qq-events-notify.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,MAAM,qBAAqB,GAAG,OAAO,GAAG,OAAO,CAAC;AAiBtD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,qBAAqB,EAC3B,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/qq-events-notify.js

@@ -0,0 +1,70 @@
+import {
+  DEFAULT_DB_CONFIG,
+  loadEnsuredConfig
+} from "@sfmc-bds/sdk/node/config";
+import http from "node:http";
+import { log } from "./log.js";
+import { ROOT_DIR } from "./paths.js";
+function resolveDbPort() {
+  try {
+    const cfg = loadEnsuredConfig(
+      ROOT_DIR,
+      "db_config.json",
+      "db_config",
+      { ...DEFAULT_DB_CONFIG }
+    );
+    const n = Number(cfg.db_port ?? 3001);
+    return Number.isFinite(n) && n > 0 ? n : 3001;
+  } catch {
+    return 3001;
+  }
+}
+function postBdsLifecycleEvent(type, detail, opts) {
+  const host = opts?.host ?? "127.0.0.1";
+  const port = opts?.port ?? resolveDbPort();
+  const timeoutMs = opts?.timeoutMs ?? 3e3;
+  const payload = JSON.stringify({
+    type,
+    detail: detail ?? void 0
+  });
+  return new Promise((resolve) => {
+    const req = http.request(
+      {
+        hostname: host,
+        port,
+        path: "/api/sfmc/qq/events",
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Content-Length": Buffer.byteLength(payload)
+        },
+        timeout: timeoutMs
+      },
+      (res) => {
+        res.resume();
+        res.on("end", () => {
+          const code = res.statusCode ?? 0;
+          if (code < 200 || code >= 300) {
+            log.warn(`[QQ\u4E8B\u4EF6] db-server \u8FD4\u56DE HTTP ${code} (type=${type})`);
+          }
+          resolve();
+        });
+      }
+    );
+    req.on("timeout", () => {
+      req.destroy();
+      log.warn(`[QQ\u4E8B\u4EF6] \u4E0A\u62A5\u8D85\u65F6 ${timeoutMs}ms (type=${type})`);
+      resolve();
+    });
+    req.on("error", (err) => {
+      log.warn(`[QQ\u4E8B\u4EF6] \u4E0A\u62A5\u5931\u8D25: ${err.message} (type=${type})`);
+      resolve();
+    });
+    req.write(payload);
+    req.end();
+  });
+}
+export {
+  postBdsLifecycleEvent
+};
+//# sourceMappingURL=qq-events-notify.js.map

package/dist/qq-events-notify.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/qq-events-notify.ts"],
+  "sourcesContent": ["/**\n * qq-events-notify.ts \u2014 \u5411 db-server \u4E0A\u62A5 BDS \u542F\u505C\u4E8B\u4EF6\n *\n * \u53EA POST \u7ED3\u6784\u5316\u4E8B\u4EF6\uFF1B\u7FA4 openid / \u9891\u63A7\u7531 db-server \u5904\u7406\uFF08DIP\uFF09\u3002\n * \u5931\u8D25\u4EC5 warn\uFF0C\u4E0D\u629B\u9519\u3002\n */\n\nimport {\n  DEFAULT_DB_CONFIG,\n  loadEnsuredConfig,\n  type DBConfig,\n} from \"@sfmc-bds/sdk/node/config\";\nimport http from \"node:http\";\nimport { log } from \"./log.js\";\nimport { ROOT_DIR } from \"./paths.js\";\n\nexport type BdsLifecycleEventType = \"crash\" | \"start\";\n\nfunction resolveDbPort(): number {\n  try {\n    const cfg = loadEnsuredConfig(\n      ROOT_DIR,\n      \"db_config.json\",\n      \"db_config\",\n      { ...DEFAULT_DB_CONFIG } as Record<string, unknown>\n    ) as DBConfig;\n    const n = Number(cfg.db_port ?? 3001);\n    return Number.isFinite(n) && n > 0 ? n : 3001;\n  } catch {\n    return 3001;\n  }\n}\n\n/**\n * POST /api/sfmc/qq/events\uFF1B\u8D85\u65F6/\u975E 2xx \u4E0D\u629B\u3002\n */\nexport function postBdsLifecycleEvent(\n  type: BdsLifecycleEventType,\n  detail?: string,\n  opts?: { host?: string; port?: number; timeoutMs?: number }\n): Promise<void> {\n  const host = opts?.host ?? \"127.0.0.1\";\n  const port = opts?.port ?? resolveDbPort();\n  const timeoutMs = opts?.timeoutMs ?? 3_000;\n  const payload = JSON.stringify({\n    type,\n    detail: detail ?? undefined,\n  });\n\n  return new Promise((resolve) => {\n    const req = http.request(\n      {\n        hostname: host,\n        port,\n        path: \"/api/sfmc/qq/events\",\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          \"Content-Length\": Buffer.byteLength(payload),\n        },\n        timeout: timeoutMs,\n      },\n      (res) => {\n        res.resume();\n        res.on(\"end\", () => {\n          const code = res.statusCode ?? 0;\n          if (code < 200 || code >= 300) {\n            log.warn(`[QQ\u4E8B\u4EF6] db-server \u8FD4\u56DE HTTP ${code} (type=${type})`);\n          }\n          resolve();\n        });\n      }\n    );\n    req.on(\"timeout\", () => {\n      req.destroy();\n      log.warn(`[QQ\u4E8B\u4EF6] \u4E0A\u62A5\u8D85\u65F6 ${timeoutMs}ms (type=${type})`);\n      resolve();\n    });\n    req.on(\"error\", (err) => {\n      log.warn(`[QQ\u4E8B\u4EF6] \u4E0A\u62A5\u5931\u8D25: ${err.message} (type=${type})`);\n      resolve();\n    });\n    req.write(payload);\n    req.end();\n  });\n}\n"],
+  "mappings": "AAOA;AAAA,EACE;AAAA,EACA;AAAA,OAEK;AACP,OAAO,UAAU;AACjB,SAAS,WAAW;AACpB,SAAS,gBAAgB;AAIzB,SAAS,gBAAwB;AAC/B,MAAI;AACF,UAAM,MAAM;AAAA,MACV;AAAA,MACA;AAAA,MACA;AAAA,MACA,EAAE,GAAG,kBAAkB;AAAA,IACzB;AACA,UAAM,IAAI,OAAO,IAAI,WAAW,IAAI;AACpC,WAAO,OAAO,SAAS,CAAC,KAAK,IAAI,IAAI,IAAI;AAAA,EAC3C,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAKO,SAAS,sBACd,MACA,QACA,MACe;AACf,QAAM,OAAO,MAAM,QAAQ;AAC3B,QAAM,OAAO,MAAM,QAAQ,cAAc;AACzC,QAAM,YAAY,MAAM,aAAa;AACrC,QAAM,UAAU,KAAK,UAAU;AAAA,IAC7B;AAAA,IACA,QAAQ,UAAU;AAAA,EACpB,CAAC;AAED,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,MAAM,KAAK;AAAA,MACf;AAAA,QACE,UAAU;AAAA,QACV;AAAA,QACA,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,kBAAkB,OAAO,WAAW,OAAO;AAAA,QAC7C;AAAA,QACA,SAAS;AAAA,MACX;AAAA,MACA,CAAC,QAAQ;AACP,YAAI,OAAO;AACX,YAAI,GAAG,OAAO,MAAM;AAClB,gBAAM,OAAO,IAAI,cAAc;AAC/B,cAAI,OAAO,OAAO,QAAQ,KAAK;AAC7B,gBAAI,KAAK,gDAA4B,IAAI,UAAU,IAAI,GAAG;AAAA,UAC5D;AACA,kBAAQ;AAAA,QACV,CAAC;AAAA,MACH;AAAA,IACF;AACA,QAAI,GAAG,WAAW,MAAM;AACtB,UAAI,QAAQ;AACZ,UAAI,KAAK,6CAAe,SAAS,YAAY,IAAI,GAAG;AACpD,cAAQ;AAAA,IACV,CAAC;AACD,QAAI,GAAG,SAAS,CAAC,QAAQ;AACvB,UAAI,KAAK,8CAAgB,IAAI,OAAO,UAAU,IAAI,GAAG;AACrD,cAAQ;AAAA,IACV,CAAC;AACD,QAAI,MAAM,OAAO;AACjB,QAAI,IAAI;AAAA,EACV,CAAC;AACH;",
+  "names": []
+}

package/dist/qqutil.d.ts

@@ -1,11 +1,16 @@
 /**
- * qqutil.ts — QQ 通知工具 (基于 LLBot HTTP OneBot 11)
+ * qqutil.ts — BDS 运维与更新通知推送工具（支持官方 Bot 与 LLBot 双后端）
  *
- * 改进:
- *  - sendTimeout 提供总超时，避免通知发送挂死主流程
- *  - 静默模式 (失败不抛出)，保证主流程不被通知干扰
+ * 核心机制：
+ * - 双后端适配：根据 `qq_backend` 配置自动分发至官方开放平台发群接口或 LLBot OneBot HTTP 接口
+ * - 故障隔离：通知发送失败仅记录告警日志并不中断主流程，确保主服务运维正常执行
+ * - 发送超时熔断：设置请求超时时间，防止外部网络响应延迟堵塞 BDS 启动与更新
+ */
+/**
+ * 检查平台中 `qq-bridge` 模块是否处于启用状态。
+ *
+ * @returns 若启用返回 `true`，否则返回 `false`。
  */
-/** 检查 qq-bridge 模块是否启用 */
 export declare function isQqBridgeEnabled(): boolean;
 export declare function sendText(text: string): Promise<void>;
 export declare function sendMixed(segments: unknown[]): Promise<void>;

package/dist/qqutil.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"qqutil.d.ts","sourceRoot":"","sources":["../src/qqutil.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,0BAA0B;AAC1B,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C;AA6CD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1D;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAYlE;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlF"}
+{"version":3,"file":"qqutil.d.ts","sourceRoot":"","sources":["../src/qqutil.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiCH;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAO3C;AAgED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB1D;AAED,wBAAsB,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BlE;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlF"}