@gravito/launchpad 1.2.1 → 1.3.1

package/dist/index.mjs

@@ -111,6 +111,36 @@ registry = "${fallbackRegistry}"
   }
 };
 
+// src/Domain/Interfaces.ts
+var DEFAULT_POOL_CONFIG = {
+  maxRockets: 20,
+  warmupCount: 3,
+  maxQueueSize: 50,
+  queueTimeoutMs: 3e4,
+  exhaustionStrategy: "queue",
+  dynamicLimit: 5
+};
+var DEFAULT_REFURBISH_CONFIG = {
+  strategy: "deep-clean",
+  cleanupCommands: [
+    // 1. 殺掉所有使用者進程
+    "pkill -9 -u bun || true",
+    'pkill -9 -u root -f "bun|node" || true',
+    // 2. 清理應用目錄
+    "rm -rf /app/* /app/.* 2>/dev/null || true",
+    // 3. 清理暫存檔案
+    "rm -rf /tmp/* /var/tmp/* 2>/dev/null || true",
+    // 4. 清理 bun 暫存
+    "rm -rf /root/.bun/install/cache/tmp/* 2>/dev/null || true",
+    "rm -rf /home/bun/.bun/install/cache/tmp/* 2>/dev/null || true",
+    // 5. 清理日誌
+    "rm -rf /var/log/*.log 2>/dev/null || true"
+  ],
+  cleanupTimeoutMs: 3e4,
+  failureAction: "decommission",
+  maxRetries: 2
+};
+
 // src/Domain/Rocket.ts
 import { AggregateRoot } from "@gravito/enterprise";
 
@@ -141,6 +171,28 @@ var RefurbishmentCompleted = class extends DomainEvent {
     this.rocketId = rocketId;
   }
 };
+var PoolExhausted = class extends DomainEvent {
+  constructor(totalRockets, maxRockets, queueLength) {
+    super();
+    this.totalRockets = totalRockets;
+    this.maxRockets = maxRockets;
+    this.queueLength = queueLength;
+  }
+};
+var MissionQueued = class extends DomainEvent {
+  constructor(missionId, queuePosition) {
+    super();
+    this.missionId = missionId;
+    this.queuePosition = queuePosition;
+  }
+};
+var MissionQueueTimeout = class extends DomainEvent {
+  constructor(missionId, waitTimeMs) {
+    super();
+    this.missionId = missionId;
+    this.waitTimeMs = waitTimeMs;
+  }
+};
 
 // src/Domain/RocketStatus.ts
 var RocketStatus = /* @__PURE__ */ ((RocketStatus2) => {
@@ -228,6 +280,23 @@ var Rocket = class _Rocket extends AggregateRoot {
   decommission() {
     this._status = "DECOMMISSIONED" /* DECOMMISSIONED */;
   }
+  /**
+   * 替換底層容器（僅在 REFURBISHING 狀態時允許）
+   * 用於 destroy-recreate 策略
+   *
+   * @param newContainerId - 新容器 ID
+   * @throws {Error} 當火箭不在 REFURBISHING 狀態時
+   *
+   * @public
+   * @since 1.3.0
+   */
+  replaceContainer(newContainerId) {
+    if (this._status !== "REFURBISHING" /* REFURBISHING */) {
+      throw new Error(`\u7121\u6CD5\u66FF\u63DB\u5BB9\u5668\uFF1A\u706B\u7BAD ${this.id} \u4E0D\u5728 REFURBISHING \u72C0\u614B`);
+    }
+    this._containerId = newContainerId;
+    this._assignedDomain = null;
+  }
   toJSON() {
     return {
       id: this.id,
@@ -246,44 +315,219 @@ var Rocket = class _Rocket extends AggregateRoot {
   }
 };
 
+// src/Application/MissionQueue.ts
+var MissionQueue = class {
+  queue = [];
+  maxSize;
+  timeoutMs;
+  constructor(maxSize = 50, timeoutMs = 3e4) {
+    this.maxSize = maxSize;
+    this.timeoutMs = timeoutMs;
+  }
+  get length() {
+    return this.queue.length;
+  }
+  get isFull() {
+    return this.queue.length >= this.maxSize;
+  }
+  /**
+   * 將任務加入隊列，返回 Promise 等待分配
+   */
+  enqueue(mission) {
+    if (this.isFull) {
+      return Promise.reject(
+        new PoolExhaustedException(`\u4EFB\u52D9\u968A\u5217\u5DF2\u6EFF\uFF08${this.maxSize}\uFF09\uFF0C\u7121\u6CD5\u63A5\u53D7\u65B0\u4EFB\u52D9`)
+      );
+    }
+    return new Promise((resolve, reject) => {
+      const timeoutId = setTimeout(() => {
+        this.removeFromQueue(mission.id);
+        reject(new QueueTimeoutException(`\u4EFB\u52D9 ${mission.id} \u7B49\u5F85\u8D85\u6642`));
+      }, this.timeoutMs);
+      this.queue.push({
+        mission,
+        resolve,
+        reject,
+        enqueuedAt: Date.now(),
+        timeoutId
+      });
+      console.log(
+        `[MissionQueue] \u4EFB\u52D9 ${mission.id} \u5DF2\u52A0\u5165\u968A\u5217\uFF0C\u7576\u524D\u968A\u5217\u9577\u5EA6: ${this.queue.length}`
+      );
+    });
+  }
+  /**
+   * 取出下一個等待的任務
+   */
+  dequeue() {
+    const item = this.queue.shift();
+    if (item) {
+      clearTimeout(item.timeoutId);
+    }
+    return item ?? null;
+  }
+  /**
+   * 從隊列中移除指定任務
+   */
+  removeFromQueue(missionId) {
+    const index = this.queue.findIndex((q) => q.mission.id === missionId);
+    if (index >= 0) {
+      const [removed] = this.queue.splice(index, 1);
+      clearTimeout(removed.timeoutId);
+    }
+  }
+  /**
+   * 清空隊列並拒絕所有等待的任務
+   */
+  clear(reason) {
+    for (const item of this.queue) {
+      clearTimeout(item.timeoutId);
+      item.reject(new Error(reason));
+    }
+    this.queue = [];
+  }
+  /**
+   * 取得隊列統計資訊
+   */
+  getStats() {
+    const oldestWaitMs = this.queue.length > 0 ? Date.now() - this.queue[0].enqueuedAt : null;
+    return {
+      length: this.queue.length,
+      maxSize: this.maxSize,
+      oldestWaitMs
+    };
+  }
+};
+var PoolExhaustedException = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "PoolExhaustedException";
+  }
+};
+var QueueTimeoutException = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "QueueTimeoutException";
+  }
+};
+
 // src/Application/PoolManager.ts
 var PoolManager = class {
-  constructor(dockerAdapter, rocketRepository, refurbishUnit, router) {
+  constructor(dockerAdapter, rocketRepository, refurbishUnit, router, config) {
     this.dockerAdapter = dockerAdapter;
     this.rocketRepository = rocketRepository;
     this.refurbishUnit = refurbishUnit;
     this.router = router;
+    this.config = { ...DEFAULT_POOL_CONFIG, ...config };
+    this.missionQueue = new MissionQueue(this.config.maxQueueSize, this.config.queueTimeoutMs);
+  }
+  config;
+  missionQueue;
+  dynamicRocketCount = 0;
+  /**
+   * 取得當前 Pool 狀態
+   */
+  async getPoolStatus() {
+    const rockets = await this.rocketRepository.findAll();
+    const statusCounts = {
+      total: rockets.length,
+      idle: 0,
+      orbiting: 0,
+      refurbishing: 0,
+      decommissioned: 0
+    };
+    for (const rocket of rockets) {
+      switch (rocket.status) {
+        case "IDLE" /* IDLE */:
+          statusCounts.idle++;
+          break;
+        case "PREPARING" /* PREPARING */:
+        case "ORBITING" /* ORBITING */:
+          statusCounts.orbiting++;
+          break;
+        case "REFURBISHING" /* REFURBISHING */:
+          statusCounts.refurbishing++;
+          break;
+        case "DECOMMISSIONED" /* DECOMMISSIONED */:
+          statusCounts.decommissioned++;
+          break;
+      }
+    }
+    return {
+      ...statusCounts,
+      dynamicCount: this.dynamicRocketCount,
+      maxRockets: this.config.maxRockets,
+      queueLength: this.missionQueue.length
+    };
   }
   /**
    * 初始化發射場：預先準備指定數量的火箭
    */
   async warmup(count) {
+    const targetCount = count ?? this.config.warmupCount;
     const currentRockets = await this.rocketRepository.findAll();
-    const needed = count - currentRockets.length;
+    const activeRockets = currentRockets.filter((r) => r.status !== "DECOMMISSIONED" /* DECOMMISSIONED */);
+    const needed = Math.min(
+      targetCount - activeRockets.length,
+      this.config.maxRockets - activeRockets.length
+    );
     if (needed <= 0) {
+      console.log(`[PoolManager] \u7121\u9700\u71B1\u6A5F\uFF0C\u7576\u524D\u5DF2\u6709 ${activeRockets.length} \u67B6\u706B\u7BAD`);
       return;
     }
-    console.log(`[LaunchPad] \u6B63\u5728\u71B1\u6A5F\uFF0C\u6E96\u5099\u767C\u5C04 ${needed} \u67B6\u65B0\u706B\u7BAD...`);
+    console.log(`[PoolManager] \u6B63\u5728\u71B1\u6A5F\uFF0C\u6E96\u5099\u767C\u5C04 ${needed} \u67B6\u65B0\u706B\u7BAD...`);
     for (let i = 0; i < needed; i++) {
       const containerId = await this.dockerAdapter.createBaseContainer();
-      const rocketId = `rocket-${Math.random().toString(36).substring(2, 9)}`;
+      const rocketId = `rocket-${crypto.randomUUID()}`;
       const rocket = new Rocket(rocketId, containerId);
       await this.rocketRepository.save(rocket);
     }
+    console.log(`[PoolManager] \u71B1\u6A5F\u5B8C\u6210\uFF0CPool \u7576\u524D\u5171 ${activeRockets.length + needed} \u67B6\u706B\u7BAD`);
   }
   /**
    * 獲取一架可用的火箭並分配任務
+   *
+   * @throws {PoolExhaustedException} 當 Pool 耗盡且無法處理請求時
    */
   async assignMission(mission) {
     let rocket = await this.rocketRepository.findIdle();
-    if (!rocket) {
-      console.log(`[LaunchPad] \u8CC7\u6E90\u5403\u7DCA\uFF0C\u6B63\u5728\u7DCA\u6025\u547C\u53EB\u5F8C\u63F4\u706B\u7BAD...`);
-      const containerId = await this.dockerAdapter.createBaseContainer();
-      rocket = new Rocket(`rocket-dynamic-${Date.now()}`, containerId);
+    if (rocket) {
+      rocket.assignMission(mission);
+      await this.rocketRepository.save(rocket);
+      return rocket;
+    }
+    const poolStatus = await this.getPoolStatus();
+    const activeCount = poolStatus.total - poolStatus.decommissioned;
+    console.log(
+      `[PoolManager] \u7121\u53EF\u7528\u706B\u7BAD\uFF0C\u7576\u524D\u72C0\u614B: \u7E3D\u6578=${activeCount}/${this.config.maxRockets}, \u968A\u5217=${this.missionQueue.length}/${this.config.maxQueueSize}`
+    );
+    switch (this.config.exhaustionStrategy) {
+      case "reject":
+        throw new PoolExhaustedException(`Rocket Pool \u5DF2\u8017\u76E1\uFF0C\u7121\u6CD5\u8655\u7406\u4EFB\u52D9 ${mission.id}`);
+      case "dynamic": {
+        if (activeCount < this.config.maxRockets && this.dynamicRocketCount < (this.config.dynamicLimit ?? 5)) {
+          console.log(`[PoolManager] \u52D5\u614B\u5EFA\u7ACB\u5F8C\u63F4\u706B\u7BAD...`);
+          const containerId = await this.dockerAdapter.createBaseContainer();
+          rocket = new Rocket(`rocket-dynamic-${Date.now()}`, containerId);
+          this.dynamicRocketCount++;
+          rocket.assignMission(mission);
+          await this.rocketRepository.save(rocket);
+          return rocket;
+        }
+        if (this.missionQueue.isFull) {
+          throw new PoolExhaustedException(`Rocket Pool \u8207\u968A\u5217\u5747\u5DF2\u6EFF\uFF0C\u7121\u6CD5\u8655\u7406\u4EFB\u52D9 ${mission.id}`);
+        }
+        console.log(`[PoolManager] \u4EFB\u52D9 ${mission.id} \u9032\u5165\u7B49\u5F85\u968A\u5217`);
+        return this.missionQueue.enqueue(mission);
+      }
+      case "queue":
+      default:
+        if (this.missionQueue.isFull) {
+          throw new PoolExhaustedException(`Rocket Pool \u8207\u968A\u5217\u5747\u5DF2\u6EFF\uFF0C\u7121\u6CD5\u8655\u7406\u4EFB\u52D9 ${mission.id}`);
+        }
+        console.log(`[PoolManager] \u4EFB\u52D9 ${mission.id} \u9032\u5165\u7B49\u5F85\u968A\u5217`);
+        return this.missionQueue.enqueue(mission);
     }
-    rocket.assignMission(mission);
-    await this.rocketRepository.save(rocket);
-    return rocket;
   }
   /**
    * 回收指定任務的火箭
@@ -292,7 +536,7 @@ var PoolManager = class {
     const allRockets = await this.rocketRepository.findAll();
     const rocket = allRockets.find((r) => r.currentMission?.id === missionId);
     if (!rocket) {
-      console.warn(`[LaunchPad] \u627E\u4E0D\u5230\u5C6C\u65BC\u4EFB\u52D9 ${missionId} \u7684\u706B\u7BAD`);
+      console.warn(`[PoolManager] \u627E\u4E0D\u5230\u5C6C\u65BC\u4EFB\u52D9 ${missionId} \u7684\u706B\u7BAD`);
       return;
     }
     if (this.router && rocket.assignedDomain) {
@@ -305,30 +549,67 @@ var PoolManager = class {
       rocket.finishRefurbishment();
     }
     await this.rocketRepository.save(rocket);
+    await this.processQueue();
+  }
+  /**
+   * 處理等待隊列中的任務
+   */
+  async processQueue() {
+    const queuedItem = this.missionQueue.dequeue();
+    if (!queuedItem) {
+      return;
+    }
+    try {
+      const rocket = await this.rocketRepository.findIdle();
+      if (rocket) {
+        rocket.assignMission(queuedItem.mission);
+        await this.rocketRepository.save(rocket);
+        queuedItem.resolve(rocket);
+        console.log(`[PoolManager] \u968A\u5217\u4EFB\u52D9 ${queuedItem.mission.id} \u5DF2\u5206\u914D\u706B\u7BAD ${rocket.id}`);
+      } else {
+        console.warn(`[PoolManager] \u8655\u7406\u968A\u5217\u6642\u4ECD\u7121\u53EF\u7528\u706B\u7BAD\uFF0C\u4EFB\u52D9\u91CD\u65B0\u5165\u968A`);
+        this.missionQueue.enqueue(queuedItem.mission).then(queuedItem.resolve).catch(queuedItem.reject);
+      }
+    } catch (error) {
+      queuedItem.reject(error);
+    }
+  }
+  /**
+   * 取得隊列統計資訊
+   */
+  getQueueStats() {
+    return this.missionQueue.getStats();
   }
 };
 
 // src/Application/RefurbishUnit.ts
 var RefurbishUnit = class {
-  constructor(docker) {
+  constructor(docker, config) {
     this.docker = docker;
+    this.config = { ...DEFAULT_REFURBISH_CONFIG, ...config };
   }
+  config;
   /**
    * 執行火箭翻新邏輯
    */
   async refurbish(rocket) {
-    console.log(`[RefurbishUnit] \u6B63\u5728\u7FFB\u65B0\u706B\u7BAD: ${rocket.id} (\u5BB9\u5668: ${rocket.containerId})`);
+    console.log(
+      `[RefurbishUnit] \u6B63\u5728\u7FFB\u65B0\u706B\u7BAD: ${rocket.id} (\u7B56\u7565: ${this.config.strategy}, \u5BB9\u5668: ${rocket.containerId})`
+    );
     rocket.splashDown();
     try {
-      const cleanupCommands = ["sh", "-c", "rm -rf /app/* && pkill -f bun || true && rm -rf /tmp/*"];
-      const result = await this.docker.executeCommand(rocket.containerId, cleanupCommands);
+      const commands = this.config.cleanupCommands ?? [];
+      const fullCommand = commands.join(" && ");
+      const result = await this.docker.executeCommand(rocket.containerId, ["sh", "-c", fullCommand]);
       if (result.exitCode !== 0) {
         console.error(`[RefurbishUnit] \u6E05\u7406\u5931\u6557: ${result.stderr}`);
-        rocket.decommission();
-        return;
+        if (this.config.failureAction === "decommission") {
+          rocket.decommission();
+          return;
+        }
       }
       rocket.finishRefurbishment();
-      console.log(`[RefurbishUnit] \u706B\u7BAD ${rocket.id} \u7FFB\u65B0\u5B8C\u6210\uFF0C\u5DF2\u9032\u5165 IDLE \u72C0\u614B\u3002`);
+      console.log(`[RefurbishUnit] \u706B\u7BAD ${rocket.id} \u7FFB\u65B0\u5B8C\u6210\uFF0C\u5DF2\u9032\u5165 IDLE \u72C0\u614B`);
     } catch (error) {
       console.error(`[RefurbishUnit] \u56DE\u6536\u904E\u7A0B\u767C\u751F\u7570\u5E38:`, error);
       rocket.decommission();
@@ -361,8 +642,15 @@ import { getRuntimeAdapter } from "@gravito/core";
 var DockerAdapter = class {
   baseImage = "oven/bun:1.0-slim";
   runtime = getRuntimeAdapter();
+  // 快取目錄配置
+  cacheConfig = {
+    hostCachePath: process.env.BUN_CACHE_PATH || `${process.env.HOME}/.bun/install/cache`,
+    containerCachePathRoot: "/root/.bun/install/cache",
+    containerCachePathBun: "/home/bun/.bun/install/cache"
+  };
   async createBaseContainer() {
-    const rocketId = `rocket-${Math.random().toString(36).substring(2, 9)}`;
+    const rocketId = `rocket-${crypto.randomUUID()}`;
+    await this.ensureCacheDirectory();
     const proc = this.runtime.spawn([
       "docker",
       "run",
@@ -374,10 +662,39 @@ var DockerAdapter = class {
       "-p",
       "3000",
       // 讓 Docker 分配隨機宿主機埠
+      // === 快取掛載（關鍵） ===
       "-v",
-      `${process.env.HOME}/.bun/install/cache:/root/.bun/install/cache`,
+      `${this.cacheConfig.hostCachePath}:${this.cacheConfig.containerCachePathRoot}:rw`,
       "-v",
-      `${process.env.HOME}/.bun/install/cache:/home/bun/.bun/install/cache`,
+      `${this.cacheConfig.hostCachePath}:${this.cacheConfig.containerCachePathBun}:rw`,
+      // === 環境變數配置（確保 bun 使用快取） ===
+      "-e",
+      `BUN_INSTALL_CACHE_DIR=${this.cacheConfig.containerCachePathBun}`,
+      "-e",
+      "BUN_INSTALL_CACHE=shared",
+      "-e",
+      "BUN_INSTALL_PREFER_OFFLINE=true",
+      // === 效能相關環境變數 ===
+      "-e",
+      "NODE_ENV=development",
+      // === 資源限制（防止單一容器占用過多資源） ===
+      "--memory",
+      "1g",
+      "--memory-swap",
+      "1g",
+      "--cpus",
+      "1.0",
+      // === 安全設定 ===
+      "--security-opt",
+      "no-new-privileges:true",
+      "--cap-drop",
+      "ALL",
+      "--cap-add",
+      "CHOWN",
+      "--cap-add",
+      "SETUID",
+      "--cap-add",
+      "SETGID",
       this.baseImage,
       "tail",
       "-f",
@@ -387,6 +704,7 @@ var DockerAdapter = class {
     const containerId = stdout.trim();
     const exitCode = await proc.exited;
     if (containerId.length === 64 && /^[0-9a-f]+$/.test(containerId)) {
+      await this.verifyCacheMount(containerId);
       return containerId;
     }
     if (exitCode !== 0) {
@@ -395,6 +713,37 @@ var DockerAdapter = class {
     }
     return containerId;
   }
+  /**
+   * 確保快取目錄存在
+   *
+   * @private
+   * @since 1.3.0
+   */
+  async ensureCacheDirectory() {
+    const cachePath = this.cacheConfig.hostCachePath;
+    const proc = this.runtime.spawn(["mkdir", "-p", cachePath]);
+    await proc.exited;
+    const chmodProc = this.runtime.spawn(["chmod", "777", cachePath]);
+    await chmodProc.exited;
+  }
+  /**
+   * 驗證快取是否正確掛載
+   *
+   * @private
+   * @since 1.3.0
+   */
+  async verifyCacheMount(containerId) {
+    const result = await this.executeCommand(containerId, [
+      "sh",
+      "-c",
+      `ls -la ${this.cacheConfig.containerCachePathBun} 2>/dev/null || echo 'NOT_MOUNTED'`
+    ]);
+    if (result.stdout.includes("NOT_MOUNTED")) {
+      console.warn(`[DockerAdapter] \u8B66\u544A: \u5BB9\u5668 ${containerId} \u7684\u5FEB\u53D6\u76EE\u9304\u53EF\u80FD\u672A\u6B63\u78BA\u639B\u8F09`);
+    } else {
+      console.log(`[DockerAdapter] \u5FEB\u53D6\u76EE\u9304\u5DF2\u78BA\u8A8D\u639B\u8F09: ${containerId}`);
+    }
+  }
   async getExposedPort(containerId, containerPort = 3e3) {
     const proc = this.runtime.spawn(["docker", "port", containerId, containerPort.toString()]);
     const stdout = await new Response(proc.stdout ?? null).text();
@@ -477,7 +826,7 @@ import { getRuntimeAdapter as getRuntimeAdapter2 } from "@gravito/core";
 var ShellGitAdapter = class {
   baseDir = "/tmp/gravito-launchpad-git";
   async clone(repoUrl, branch) {
-    const dirName = `${Date.now()}-${Math.random().toString(36).slice(2)}`;
+    const dirName = `${Date.now()}-${crypto.randomUUID()}`;
     const targetDir = `${this.baseDir}/${dirName}`;
     await mkdir(this.baseDir, { recursive: true });
     const runtime = getRuntimeAdapter2();
@@ -672,9 +1021,19 @@ var LaunchpadServiceProvider = class extends ServiceProvider {
   }
 };
 var LaunchpadOrbit = class {
+  /**
+   * Create a new LaunchpadOrbit instance.
+   * @param ripple - Ripple instance for real-time telemetry communication.
+   */
   constructor(ripple) {
     this.ripple = ripple;
   }
+  /**
+   * Install the Launchpad orbit into PlanetCore.
+   * Registers the service provider and sets up webhook routes for deployment.
+   *
+   * @param core - The PlanetCore instance.
+   */
   async install(core) {
     core.register(new LaunchpadServiceProvider());
     core.router.post("/launch", async (c) => {
@@ -748,12 +1107,7 @@ async function bootstrapLaunchpad() {
       PORT: 4e3,
       CACHE_DRIVER: "file"
     },
-    orbits: [
-      new OrbitCache(),
-      ripple,
-      new LaunchpadOrbit(ripple)
-      // 傳入實例
-    ]
+    orbits: [new OrbitCache(), ripple, new LaunchpadOrbit(ripple)]
   });
   await core.bootstrap();
   const liftoffConfig = core.liftoff();
@@ -769,13 +1123,25 @@ async function bootstrapLaunchpad() {
   };
 }
 export {
+  DEFAULT_POOL_CONFIG,
+  DEFAULT_REFURBISH_CONFIG,
   LaunchpadOrbit,
   Mission,
+  MissionAssigned,
   MissionControl,
+  MissionQueue,
+  MissionQueueTimeout,
+  MissionQueued,
   PayloadInjector,
+  PoolExhausted,
+  PoolExhaustedException,
   PoolManager,
+  QueueTimeoutException,
   RefurbishUnit,
+  RefurbishmentCompleted,
   Rocket,
+  RocketIgnited,
+  RocketSplashedDown,
   RocketStatus,
   bootstrapLaunchpad
 };

package/package.json

@@ -1,16 +1,18 @@
 {
   "name": "@gravito/launchpad",
-  "version": "1.2.1",
+  "version": "1.3.1",
   "description": "Container lifecycle management system for flash deployments",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsup src/index.ts --format cjs,esm --dts",
-    "test": "bun test",
-    "test:coverage": "bun test --coverage --coverage-threshold=80",
-    "test:ci": "bun test --coverage --coverage-threshold=80",
-    "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck"
+    "test": "bun test --timeout=10000",
+    "test:coverage": "bun test --timeout=10000 --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run --bun scripts/check-coverage.ts",
+    "test:ci": "bun test --timeout=10000 --coverage --coverage-reporter=lcov --coverage-dir coverage && bun run --bun scripts/check-coverage.ts",
+    "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck",
+    "test:unit": "bun test tests/ --timeout=10000",
+    "test:integration": "test $(find tests -name '*.integration.test.ts' 2>/dev/null | wc -l) -gt 0 && find tests -name '*.integration.test.ts' -print0 | xargs -0 bun test --timeout=10000 || echo 'No integration tests found'"
   },
   "dependencies": {
     "@gravito/enterprise": "workspace:*",

package/scripts/check-coverage.ts

@@ -0,0 +1,64 @@
+import { existsSync, readFileSync } from 'node:fs'
+import { resolve } from 'node:path'
+
+const lcovPath = process.argv[2] ?? 'coverage/lcov.info'
+const threshold = Number.parseFloat(process.env.COVERAGE_THRESHOLD ?? '80')
+
+const root = resolve(process.cwd())
+const srcRoot = `${resolve(root, 'src')}/`
+
+// 檢查 lcov.info 是否存在
+if (!existsSync(lcovPath)) {
+  console.error(`Coverage file not found: ${lcovPath}`)
+  process.exit(1)
+}
+
+let content: string
+try {
+  content = readFileSync(lcovPath, 'utf-8')
+} catch (error) {
+  console.error(`Failed to read coverage file: ${error}`)
+  process.exit(1)
+}
+
+const lines = content.split('\n')
+
+let currentFile: string | null = null
+let total = 0
+let hit = 0
+
+for (const line of lines) {
+  if (line.startsWith('SF:')) {
+    const filePath = line.slice(3).trim()
+    const abs = resolve(root, filePath)
+    currentFile = abs.startsWith(srcRoot) ? abs : null
+    continue
+  }
+
+  if (!currentFile) {
+    continue
+  }
+
+  if (line.startsWith('DA:')) {
+    const parts = line.slice(3).split(',')
+    if (parts.length >= 2) {
+      total += 1
+      const count = Number.parseInt(parts[1] ?? '0', 10)
+      if (count > 0) {
+        hit += 1
+      }
+    }
+  }
+}
+
+const percent = total === 0 ? 0 : (hit / total) * 100
+const rounded = Math.round(percent * 100) / 100
+
+if (rounded < threshold) {
+  console.error(
+    `launchpad coverage ${rounded}% is below threshold ${threshold}%. Covered lines: ${hit}/${total}.`
+  )
+  process.exit(1)
+}
+
+console.log(`launchpad coverage ${rounded}% (${hit}/${total}) meets threshold ${threshold}%.`)