@gravito/launchpad 1.0.0-beta.1 → 1.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/launchpad",
-  "version": "1.0.0-beta.1",
+  "version": "1.1.0",
   "description": "Container lifecycle management system for flash deployments",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -10,17 +10,26 @@
     "test": "bun test",
     "test:coverage": "bun test --coverage --coverage-threshold=80",
     "test:ci": "bun test --coverage --coverage-threshold=80",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "bun tsc -p tsconfig.json --noEmit --skipLibCheck"
   },
   "dependencies": {
     "@gravito/enterprise": "workspace:*",
     "@gravito/ripple": "workspace:*",
     "@gravito/stasis": "workspace:*",
     "@octokit/rest": "^22.0.1",
-    "gravito-core": "workspace:*"
+    "@gravito/core": "workspace:*"
   },
   "devDependencies": {
+    "bun-types": "^1.3.5",
     "tsup": "^8.0.0",
-    "typescript": "^5.0.0"
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gravito-framework/gravito.git",
+    "directory": "packages/launchpad"
   }
 }

package/server.ts

@@ -1,7 +1,9 @@
+import { getRuntimeAdapter } from '@gravito/core'
 import { bootstrapLaunchpad } from './src/index'
 
 const config = await bootstrapLaunchpad()
-Bun.serve(config)
+const runtime = getRuntimeAdapter()
+runtime.serve(config)
 
 console.log(`🚀 Launchpad Command Center active at: http://localhost:${config.port}`)
 console.log(`📡 Telemetry WebSocket channel: ws://localhost:${config.port}/ws`)

package/src/Application/MissionControl.ts

@@ -33,6 +33,7 @@ export class MissionControl {
       this.router.register(domain, `http://localhost:${publicPort}`)
     }
 
+    // 5. 啟動即時遙測
     this.docker.streamLogs(rocket.containerId, (log) => {
       onTelemetry('log', { rocketId: rocket.id, text: log })
     })

package/src/Application/PayloadInjector.ts

@@ -23,8 +23,11 @@ export class PayloadInjector {
 
     console.log(`[PayloadInjector] 正在安裝依賴...`)
 
-    // 寫入一個強制覆蓋的 bunfig.toml
-    const bunfigContent = `[install]\nfrozenLockfile = false\n`
+    const registry = process.env.LAUNCHPAD_NPM_REGISTRY || process.env.NPM_CONFIG_REGISTRY || ''
+    const baseInstallConfig = ['[install]', 'frozenLockfile = false']
+    const bunfigContent = registry
+      ? `${baseInstallConfig.join('\n')}\nregistry = "${registry}"\n`
+      : `${baseInstallConfig.join('\n')}\n`
     await this.docker.executeCommand(containerId, [
       'sh',
       '-c',
@@ -35,7 +38,7 @@ export class PayloadInjector {
     await this.docker.executeCommand(containerId, ['rm', '-f', '/app/bun.lockb'])
 
     // 安裝 (跳過腳本以避免編譯原生模組失敗)
-    const installRes = await this.docker.executeCommand(containerId, [
+    let installRes = await this.docker.executeCommand(containerId, [
       'bun',
       'install',
       '--cwd',
@@ -44,6 +47,24 @@ export class PayloadInjector {
       '--ignore-scripts',
     ])
 
+    if (installRes.exitCode !== 0 && !registry) {
+      const fallbackRegistry = 'https://registry.npmmirror.com'
+      const fallbackBunfig = `${baseInstallConfig.join('\n')}\nregistry = "${fallbackRegistry}"\n`
+      await this.docker.executeCommand(containerId, [
+        'sh',
+        '-c',
+        `echo "${fallbackBunfig}" > /app/bunfig.toml`,
+      ])
+      installRes = await this.docker.executeCommand(containerId, [
+        'bun',
+        'install',
+        '--cwd',
+        '/app',
+        '--no-save',
+        '--ignore-scripts',
+      ])
+    }
+
     if (installRes.exitCode !== 0) {
       throw new Error(`安裝依賴失敗: ${installRes.stderr}`)
     }

package/src/Domain/Interfaces.ts

@@ -26,6 +26,26 @@ export interface IDockerAdapter {
   getStats(containerId: string): Promise<{ cpu: string; memory: string }>
 }
 
+/**
+ * 負責動態反向代理與域名路由的轉接器
+ */
+export interface IRouterAdapter {
+  /**
+   * 註冊一個域名映射到指定的目標 (URL)
+   */
+  register(domain: string, targetUrl: string): void
+
+  /**
+   * 註銷域名
+   */
+  unregister(domain: string): void
+
+  /**
+   * 啟動代理伺服器
+   */
+  start(port: number): void
+}
+
 /**
  * 負責代碼獲取
  */

package/src/Infrastructure/Docker/DockerAdapter.ts

@@ -1,12 +1,14 @@
+import { getRuntimeAdapter } from '@gravito/core'
 import type { IDockerAdapter } from '../../Domain/Interfaces'
 
 export class DockerAdapter implements IDockerAdapter {
   private baseImage = 'oven/bun:1.0-slim'
+  private runtime = getRuntimeAdapter()
 
   async createBaseContainer(): Promise<string> {
     const rocketId = `rocket-${Math.random().toString(36).substring(2, 9)}`
 
-    const proc = Bun.spawn([
+    const proc = this.runtime.spawn([
       'docker',
       'run',
       '-d',
@@ -26,15 +28,16 @@ export class DockerAdapter implements IDockerAdapter {
       '/dev/null',
     ])
 
-    const stdout = await new Response(proc.stdout).text()
+    const stdout = await new Response(proc.stdout ?? null).text()
     const containerId = stdout.trim()
+    const exitCode = await proc.exited
 
     if (containerId.length === 64 && /^[0-9a-f]+$/.test(containerId)) {
       return containerId
     }
 
-    if (proc.exitCode !== 0) {
-      const stderr = await new Response(proc.stderr).text()
+    if (exitCode !== 0) {
+      const stderr = await new Response(proc.stderr ?? null).text()
       throw new Error(`Docker 容器建立失敗: ${stderr || stdout}`)
     }
 
@@ -42,8 +45,8 @@ export class DockerAdapter implements IDockerAdapter {
   }
 
   async getExposedPort(containerId: string, containerPort = 3000): Promise<number> {
-    const proc = Bun.spawn(['docker', 'port', containerId, containerPort.toString()])
-    const stdout = await new Response(proc.stdout).text()
+    const proc = this.runtime.spawn(['docker', 'port', containerId, containerPort.toString()])
+    const stdout = await new Response(proc.stdout ?? null).text()
     // 輸出格式可能包含多行，如 0.0.0.0:32768 和 [::]:32768
     // 我們取第一行並提取端口
     const firstLine = stdout.split('\n')[0] ?? ''
@@ -58,10 +61,10 @@ export class DockerAdapter implements IDockerAdapter {
   }
 
   async copyFiles(containerId: string, sourcePath: string, targetPath: string): Promise<void> {
-    const proc = Bun.spawn(['docker', 'cp', sourcePath, `${containerId}:${targetPath}`])
-    await proc.exited
-    if (proc.exitCode && proc.exitCode !== 0) {
-      const stderr = await new Response(proc.stderr).text()
+    const proc = this.runtime.spawn(['docker', 'cp', sourcePath, `${containerId}:${targetPath}`])
+    const exitCode = await proc.exited
+    if (exitCode && exitCode !== 0) {
+      const stderr = await new Response(proc.stderr ?? null).text()
       throw new Error(stderr || 'Docker copy failed')
     }
   }
@@ -70,33 +73,36 @@ export class DockerAdapter implements IDockerAdapter {
     containerId: string,
     command: string[]
   ): Promise<{ stdout: string; stderr: string; exitCode: number }> {
-    const proc = Bun.spawn(['docker', 'exec', '-u', '0', containerId, ...command])
-    const stdout = await new Response(proc.stdout).text()
-    const stderr = await new Response(proc.stderr).text()
-    await proc.exited
-    return { stdout, stderr, exitCode: proc.exitCode ?? -1 }
+    const proc = this.runtime.spawn(['docker', 'exec', '-u', '0', containerId, ...command])
+    const stdout = await new Response(proc.stdout ?? null).text()
+    const stderr = await new Response(proc.stderr ?? null).text()
+    const exitCode = await proc.exited
+    return { stdout, stderr, exitCode }
   }
 
   async removeContainer(containerId: string): Promise<void> {
-    await Bun.spawn(['docker', 'rm', '-f', containerId]).exited
+    await this.runtime.spawn(['docker', 'rm', '-f', containerId]).exited
   }
 
   async removeContainerByLabel(label: string): Promise<void> {
-    const listProc = Bun.spawn(['docker', 'ps', '-aq', '--filter', `label=${label}`])
-    const ids = await new Response(listProc.stdout).text()
+    const listProc = this.runtime.spawn(['docker', 'ps', '-aq', '--filter', `label=${label}`])
+    const ids = await new Response(listProc.stdout ?? null).text()
 
     if (ids.trim()) {
       const idList = ids.trim().split('\n')
-      await Bun.spawn(['docker', 'rm', '-f', ...idList]).exited
+      await this.runtime.spawn(['docker', 'rm', '-f', ...idList]).exited
     }
   }
 
   streamLogs(containerId: string, onData: (data: string) => void): void {
-    const proc = Bun.spawn(['docker', 'logs', '-f', containerId], {
+    const proc = this.runtime.spawn(['docker', 'logs', '-f', containerId], {
       stdout: 'pipe',
       stderr: 'pipe',
     })
-    const read = async (stream: ReadableStream) => {
+    const read = async (stream?: ReadableStream | null) => {
+      if (!stream) {
+        return
+      }
       const reader = stream.getReader()
       const decoder = new TextDecoder()
       while (true) {
@@ -112,7 +118,7 @@ export class DockerAdapter implements IDockerAdapter {
   }
 
   async getStats(containerId: string): Promise<{ cpu: string; memory: string }> {
-    const proc = Bun.spawn([
+    const proc = this.runtime.spawn([
       'docker',
       'stats',
       containerId,
@@ -120,7 +126,7 @@ export class DockerAdapter implements IDockerAdapter {
       '--format',
       '{{.CPUPerc}},{{.MemUsage}}',
     ])
-    const stdout = await new Response(proc.stdout).text()
+    const stdout = await new Response(proc.stdout ?? null).text()
     const [cpu, memory] = stdout.trim().split(',')
     return { cpu: cpu || '0%', memory: memory || '0B / 0B' }
   }

package/src/Infrastructure/Git/ShellGitAdapter.ts

@@ -1,4 +1,5 @@
 import { mkdir } from 'node:fs/promises'
+import { getRuntimeAdapter } from '@gravito/core'
 import type { IGitAdapter } from '../../Domain/Interfaces'
 
 export class ShellGitAdapter implements IGitAdapter {
@@ -10,10 +11,20 @@ export class ShellGitAdapter implements IGitAdapter {
 
     await mkdir(this.baseDir, { recursive: true })
 
-    const proc = Bun.spawn(['git', 'clone', '--depth', '1', '--branch', branch, repoUrl, targetDir])
+    const runtime = getRuntimeAdapter()
+    const proc = runtime.spawn([
+      'git',
+      'clone',
+      '--depth',
+      '1',
+      '--branch',
+      branch,
+      repoUrl,
+      targetDir,
+    ])
 
-    await proc.exited
-    if (proc.exitCode !== 0) {
+    const exitCode = await proc.exited
+    if (exitCode !== 0) {
       throw new Error('Git Clone Failed')
     }
 

package/src/Infrastructure/Persistence/CachedRocketRepository.ts

@@ -1,4 +1,4 @@
-import type { CacheService } from 'gravito-core'
+import type { CacheService } from '@gravito/core'
 import type { IRocketRepository } from '../../Domain/Interfaces'
 import { Rocket } from '../../Domain/Rocket'
 

package/src/Infrastructure/Router/BunProxyAdapter.ts

@@ -1,3 +1,4 @@
+import { getRuntimeAdapter } from '@gravito/core'
 import type { IRouterAdapter } from '../../Domain/Interfaces'
 
 export class BunProxyAdapter implements IRouterAdapter {
@@ -15,8 +16,9 @@ export class BunProxyAdapter implements IRouterAdapter {
 
   start(port: number): void {
     const self = this
+    const runtime = getRuntimeAdapter()
 
-    Bun.serve({
+    runtime.serve({
       port,
       async fetch(request) {
         const host = request.headers.get('host')?.split(':')[0]?.toLowerCase()

package/src/index.ts

@@ -1,6 +1,6 @@
+import { type Container, type GravitoOrbit, PlanetCore, ServiceProvider } from '@gravito/core'
 import { OrbitRipple } from '@gravito/ripple'
 import { OrbitCache } from '@gravito/stasis'
-import { type Container, type GravitoOrbit, PlanetCore, ServiceProvider } from 'gravito-core'
 import { MissionControl } from './Application/MissionControl'
 import { PayloadInjector } from './Application/PayloadInjector'
 import { PoolManager } from './Application/PoolManager'

package/tests/Integration.test.ts

@@ -16,7 +16,7 @@ describe('LaunchPad 集成測試 (真實 Docker)', () => {
     }
   })
 
-  it('應該能成功熱機並在容器內執行指令', async () => {
+  it('應該能成功熱機並在容器內執行指令', { timeout: 20_000 }, async () => {
     try {
       // 1. Warmup
       await manager.warmup(1)

package/tests/Rocket.test.ts

@@ -46,4 +46,39 @@ describe('Rocket', () => {
     rocket.decommission()
     expect(rocket.status).toBe(RocketStatus.DECOMMISSIONED)
   })
+
+  test('assigns domain and serializes/deserializes', () => {
+    const mission = Mission.create({
+      id: 'mission-2',
+      repoUrl: 'https://example.com/repo.git',
+      branch: 'main',
+      commitSha: 'def456',
+    })
+    const rocket = new Rocket('rocket-3', 'container-3')
+
+    rocket.assignDomain('rocket-3.dev.local')
+    rocket.assignMission(mission)
+
+    const snapshot = rocket.toJSON()
+    const restored = Rocket.fromJSON(snapshot)
+
+    expect(rocket.containerId).toBe('container-3')
+    expect(rocket.assignedDomain).toBe('rocket-3.dev.local')
+    expect(restored.status).toBe(RocketStatus.PREPARING)
+    expect(restored.currentMission).toBe(mission)
+    expect(restored.assignedDomain).toBe('rocket-3.dev.local')
+  })
+
+  test('rejects assigning mission when not idle', () => {
+    const mission = Mission.create({
+      id: 'mission-3',
+      repoUrl: 'https://example.com/repo.git',
+      branch: 'main',
+      commitSha: 'ghi789',
+    })
+    const rocket = new Rocket('rocket-4', 'container-4')
+
+    rocket.assignMission(mission)
+    expect(() => rocket.assignMission(mission)).toThrow('非 IDLE')
+  })
 })

package/tests/docker-adapter.test.ts

@@ -8,7 +8,7 @@ function makeProcess(stdoutText: string, stderrText: string, exitCode = 0) {
     stdout: makeStream(stdoutText),
     stderr: makeStream(stderrText),
     exitCode,
-    exited: Promise.resolve(),
+    exited: Promise.resolve(exitCode),
   }
 }
 
@@ -28,6 +28,20 @@ describe('DockerAdapter', () => {
     }
   })
 
+  test('returns container id even when exit code is zero but id is invalid', async () => {
+    const adapter = new DockerAdapter()
+    const originalSpawn = Bun.spawn
+
+    Bun.spawn = () => makeProcess('short-id', '', 0) as any
+
+    try {
+      const result = await adapter.createBaseContainer()
+      expect(result).toBe('short-id')
+    } finally {
+      Bun.spawn = originalSpawn
+    }
+  })
+
   test('throws when container creation fails', async () => {
     const adapter = new DockerAdapter()
     const originalSpawn = Bun.spawn
@@ -41,6 +55,46 @@ describe('DockerAdapter', () => {
     }
   })
 
+  test('getExposedPort parses the first line', async () => {
+    const adapter = new DockerAdapter()
+    const originalSpawn = Bun.spawn
+
+    Bun.spawn = () => makeProcess('0.0.0.0:32768\n[::]:32768\n', '', 0) as any
+
+    try {
+      const port = await adapter.getExposedPort('cid')
+      expect(port).toBe(32768)
+    } finally {
+      Bun.spawn = originalSpawn
+    }
+  })
+
+  test('getExposedPort throws on empty output', async () => {
+    const adapter = new DockerAdapter()
+    const originalSpawn = Bun.spawn
+
+    Bun.spawn = () => makeProcess('', '', 0) as any
+
+    try {
+      await expect(adapter.getExposedPort('cid')).rejects.toThrow('無法獲取容器映射端口')
+    } finally {
+      Bun.spawn = originalSpawn
+    }
+  })
+
+  test('getExposedPort throws on invalid output', async () => {
+    const adapter = new DockerAdapter()
+    const originalSpawn = Bun.spawn
+
+    Bun.spawn = () => makeProcess('nonsense', '', 0) as any
+
+    try {
+      await expect(adapter.getExposedPort('cid')).rejects.toThrow('無法獲取容器映射端口')
+    } finally {
+      Bun.spawn = originalSpawn
+    }
+  })
+
   test('copyFiles throws on non-zero exit code', async () => {
     const adapter = new DockerAdapter()
     const originalSpawn = Bun.spawn
@@ -54,13 +108,37 @@ describe('DockerAdapter', () => {
     }
   })
 
-  test('executeCommand returns stdout and stderr', async () => {
+  test('removeContainerByLabel removes containers when ids exist', async () => {
     const adapter = new DockerAdapter()
     const originalSpawn = Bun.spawn
+    const calls: string[][] = []
+
+    Bun.spawn = ((args: string[]) => {
+      calls.push(args)
+      if (args[1] === 'ps') {
+        return makeProcess('id-1\nid-2\n', '', 0) as any
+      }
+      return makeProcess('', '', 0) as any
+    }) as any
+
+    try {
+      await adapter.removeContainerByLabel('gravito-origin=launchpad')
+      const rmCall = calls.find((call) => call[1] === 'rm')
+      expect(rmCall).toBeTruthy()
+      expect(rmCall).toContain('id-1')
+      expect(rmCall).toContain('id-2')
+    } finally {
+      Bun.spawn = originalSpawn
+    }
+  })
+
+  test('executeCommand returns stdout and stderr', async () => {
+    const originalSpawn = Bun.spawn
 
     Bun.spawn = () => makeProcess('ok', 'warn', 0) as any
 
     try {
+      const adapter = new DockerAdapter()
       const result = await adapter.executeCommand('cid', ['echo', 'ok'])
       expect(result.stdout).toBe('ok')
       expect(result.stderr).toBe('warn')
@@ -70,6 +148,26 @@ describe('DockerAdapter', () => {
     }
   })
 
+  test('removeContainer executes docker rm', async () => {
+    const originalSpawn = Bun.spawn
+    const calls: string[][] = []
+
+    Bun.spawn = ((args: string[]) => {
+      calls.push(args)
+      return makeProcess('', '', 0) as any
+    }) as any
+
+    try {
+      const adapter = new DockerAdapter()
+      await adapter.removeContainer('cid-1')
+      const rmCall = calls.find((call) => call[1] === 'rm')
+      expect(rmCall).toBeTruthy()
+      expect(rmCall).toContain('cid-1')
+    } finally {
+      Bun.spawn = originalSpawn
+    }
+  })
+
   test('getStats parses cpu and memory output', async () => {
     const adapter = new DockerAdapter()
     const originalSpawn = Bun.spawn

package/tests/payload-injector.test.ts

@@ -61,4 +61,77 @@ describe('PayloadInjector', () => {
     expect(docker.commands.length).toBeGreaterThanOrEqual(4)
     expect(rocket.status).toBe(RocketStatus.ORBITING)
   })
+
+  test('throws when install fails', async () => {
+    const git = new FakeGit()
+    const docker = {
+      copyCalls: [] as Array<{ containerId: string; source: string; target: string }>,
+      commands: [] as string[][],
+      async copyFiles(containerId: string, source: string, target: string) {
+        this.copyCalls.push({ containerId, source, target })
+      },
+      async executeCommand(containerId: string, command: string[]) {
+        this.commands.push([containerId, ...command])
+        if (command[0] === 'bun' && command[1] === 'install') {
+          return { stdout: '', stderr: 'boom', exitCode: 1 }
+        }
+        return { stdout: '', stderr: '', exitCode: 0 }
+      },
+    }
+
+    const injector = new PayloadInjector(docker as any, git as any)
+    const rocket = new Rocket('rocket-11', 'container-11')
+    const mission = Mission.create({
+      id: 'mission-11',
+      repoUrl: 'https://example.com/repo.git',
+      branch: 'main',
+      commitSha: 'abc999',
+    })
+    rocket.assignMission(mission)
+
+    await expect(injector.deploy(rocket)).rejects.toThrow('安裝依賴失敗')
+  })
+
+  test('logs when run command fails but still ignites', async () => {
+    const docker = {
+      copyCalls: [] as Array<{ containerId: string; source: string; target: string }>,
+      commands: [] as string[][],
+      async copyFiles(containerId: string, source: string, target: string) {
+        this.copyCalls.push({ containerId, source, target })
+      },
+      async executeCommand(containerId: string, command: string[]) {
+        this.commands.push([containerId, ...command])
+        if (command[0] === 'bun' && command[1] === 'run') {
+          throw new Error('boom')
+        }
+        return { stdout: '', stderr: '', exitCode: 0 }
+      },
+    }
+    const git = new FakeGit()
+    const injector = new PayloadInjector(docker as any, git as any)
+    const rocket = new Rocket('rocket-12', 'container-12')
+    const mission = Mission.create({
+      id: 'mission-12',
+      repoUrl: 'https://example.com/repo.git',
+      branch: 'main',
+      commitSha: 'abc888',
+    })
+    rocket.assignMission(mission)
+
+    const originalError = console.error
+    const errorCalls: string[] = []
+    console.error = (...args: any[]) => {
+      errorCalls.push(args.join(' '))
+    }
+
+    try {
+      await injector.deploy(rocket)
+      await new Promise((resolve) => setTimeout(resolve, 0))
+    } finally {
+      console.error = originalError
+    }
+
+    expect(errorCalls.join(' ')).toContain('運行異常')
+    expect(rocket.status).toBe(RocketStatus.ORBITING)
+  })
 })

package/tsconfig.json

@@ -1,8 +1,27 @@
 {
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "./dist"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist", "**/*.test.ts"]
-}
+    "extends": "../../tsconfig.json",
+    "compilerOptions": {
+        "outDir": "./dist",
+        "skipLibCheck": true,
+        "types": [
+            "bun-types"
+        ],
+        "baseUrl": ".",
+        "paths": {
+            "@gravito/core": [
+                "../../packages/core/src/index.ts"
+            ],
+            "@gravito/*": [
+                "../../packages/*/src/index.ts"
+            ]
+        }
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist",
+        "**/*.test.ts"
+    ]
+}