@gravito/launchpad 1.0.0-beta.1 → 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# @gravito/launchpad
+
+## 1.0.0
+
+### Patch Changes
+
+- Updated dependencies
+  - @gravito/core@1.0.0
+  - @gravito/enterprise@1.0.0
+  - @gravito/ripple@1.0.0
+  - @gravito/stasis@1.0.0

package/debug-launch.ts

@@ -1,3 +1,4 @@
+import { getRuntimeAdapter } from '@gravito/core'
 import { DockerAdapter } from './src/Infrastructure/Docker/DockerAdapter'
 import { bootstrapLaunchpad } from './src/index'
 
@@ -6,23 +7,25 @@ async function run() {
 
   // 1. Cleanup
   const _docker = new DockerAdapter()
+  const runtime = getRuntimeAdapter()
   try {
-    const containers = await Bun.spawn([
+    const listProc = runtime.spawn([
       'docker',
       'ps',
       '-aq',
       '--filter',
       'label=gravito-origin=launchpad',
-    ]).text()
+    ])
+    const containers = await new Response(listProc.stdout ?? null).text()
     if (containers.trim()) {
       console.log('🧹 Cleaning up old containers...')
-      await Bun.spawn(['docker', 'rm', '-f', ...containers.trim().split('\n')]).exited
+      await runtime.spawn(['docker', 'rm', '-f', ...containers.trim().split('\n')]).exited
     }
   } catch (_e) {}
 
   // 2. Start Server
   const config = await bootstrapLaunchpad()
-  const server = Bun.serve(config)
+  const server = runtime.serve(config)
   console.log(`🚀 Server started at http://localhost:${config.port}`)
 
   // 3. Launch Mission

package/dist/index.d.mts

@@ -0,0 +1,188 @@
+import * as _gravito_ripple from '@gravito/ripple';
+import { OrbitRipple } from '@gravito/ripple';
+import { GravitoOrbit, PlanetCore } from '@gravito/core';
+import { ValueObject, AggregateRoot } from '@gravito/enterprise';
+
+interface MissionProps {
+    id: string;
+    repoUrl: string;
+    branch: string;
+    commitSha: string;
+}
+declare class Mission extends ValueObject<MissionProps> {
+    get id(): string;
+    get repoUrl(): string;
+    get branch(): string;
+    get commitSha(): string;
+    static create(props: MissionProps): Mission;
+}
+
+/**
+ * 火箭生命週期狀態
+ */
+declare enum RocketStatus {
+    IDLE = "IDLE",// 待命：容器運行中，無任務
+    PREPARING = "PREPARING",// 裝填：正在注入代碼 (Locked)
+    ORBITING = "ORBITING",// 運行：應用服務中
+    REFURBISHING = "REFURBISHING",// 翻新：正在清理環境
+    DECOMMISSIONED = "DECOMMISSIONED"
+}
+
+declare class Rocket extends AggregateRoot<string> {
+    private _status;
+    private _currentMission;
+    private _containerId;
+    private _assignedDomain;
+    constructor(id: string, containerId: string);
+    get status(): RocketStatus;
+    get currentMission(): Mission | null;
+    get containerId(): string;
+    get assignedDomain(): string | null;
+    /**
+     * 分配域名
+     */
+    assignDomain(domain: string): void;
+    /**
+     * 分配任務 (指派任務給 IDLE 的火箭)
+     */
+    assignMission(mission: Mission): void;
+    /**
+     * 點火啟動 (應用程式啟動成功)
+     */
+    ignite(): void;
+    /**
+     * 任務降落 (PR 合併或關閉，暫停服務)
+     */
+    splashDown(): void;
+    /**
+     * 翻新完成 (清理完畢，回歸池中)
+     */
+    finishRefurbishment(): void;
+    /**
+     * 火箭除役 (移除容器)
+     */
+    decommission(): void;
+    toJSON(): {
+        id: string;
+        containerId: string;
+        status: RocketStatus;
+        currentMission: Mission | null;
+        assignedDomain: string | null;
+    };
+    static fromJSON(data: any): Rocket;
+}
+
+/**
+ * 負責與底層容器引擎（如 Docker）溝通的轉接器介面
+ */
+interface IDockerAdapter {
+    createBaseContainer(): Promise<string>;
+    copyFiles(containerId: string, sourcePath: string, targetPath: string): Promise<void>;
+    executeCommand(containerId: string, command: string[]): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    /**
+     * 獲取容器映射到宿主機的真實端口
+     */
+    getExposedPort(containerId: string, containerPort?: number): Promise<number>;
+    removeContainer(containerId: string): Promise<void>;
+    /**
+     * 根據 Label 批量移除容器
+     */
+    removeContainerByLabel(label: string): Promise<void>;
+    streamLogs(containerId: string, onData: (data: string) => void): void;
+    getStats(containerId: string): Promise<{
+        cpu: string;
+        memory: string;
+    }>;
+}
+/**
+ * 負責代碼獲取
+ */
+interface IGitAdapter {
+    clone(repoUrl: string, branch: string): Promise<string>;
+}
+/**
+ * 負責動態反向代理與域名路由的轉接器
+ */
+interface IRouterAdapter {
+    register(domain: string, targetUrl: string): void;
+    unregister(domain: string): void;
+    start(port: number): void;
+}
+/**
+ * 負責持久化火箭狀態的儲存庫介面
+ */
+interface IRocketRepository {
+    save(rocket: Rocket): Promise<void>;
+    findById(id: string): Promise<Rocket | null>;
+    findIdle(): Promise<Rocket | null>;
+    findAll(): Promise<Rocket[]>;
+    delete(id: string): Promise<void>;
+}
+
+declare class PayloadInjector {
+    private docker;
+    private git;
+    constructor(docker: IDockerAdapter, git: IGitAdapter);
+    deploy(rocket: Rocket): Promise<void>;
+}
+
+declare class RefurbishUnit {
+    private docker;
+    constructor(docker: IDockerAdapter);
+    /**
+     * 執行火箭翻新邏輯
+     */
+    refurbish(rocket: Rocket): Promise<void>;
+}
+
+declare class PoolManager {
+    private dockerAdapter;
+    private rocketRepository;
+    private refurbishUnit?;
+    private router?;
+    constructor(dockerAdapter: IDockerAdapter, rocketRepository: IRocketRepository, refurbishUnit?: RefurbishUnit | undefined, router?: IRouterAdapter | undefined);
+    /**
+     * 初始化發射場：預先準備指定數量的火箭
+     */
+    warmup(count: number): Promise<void>;
+    /**
+     * 獲取一架可用的火箭並分配任務
+     */
+    assignMission(mission: Mission): Promise<Rocket>;
+    /**
+     * 回收指定任務的火箭
+     */
+    recycle(missionId: string): Promise<void>;
+}
+
+declare class MissionControl {
+    private poolManager;
+    private injector;
+    private docker;
+    private router?;
+    constructor(poolManager: PoolManager, injector: PayloadInjector, docker: IDockerAdapter, router?: IRouterAdapter | undefined);
+    launch(mission: Mission, onTelemetry: (type: string, data: any) => void): Promise<string>;
+}
+
+/**
+ * Gravito Launchpad Orbit
+ */
+declare class LaunchpadOrbit implements GravitoOrbit {
+    private ripple;
+    constructor(ripple: OrbitRipple);
+    install(core: PlanetCore): Promise<void>;
+}
+/**
+ * 一鍵啟動 Launchpad 應用程式
+ */
+declare function bootstrapLaunchpad(): Promise<{
+    port: number;
+    websocket: _gravito_ripple.WebSocketHandlerConfig;
+    fetch: (req: Request, server: any) => Response | Promise<Response> | undefined;
+}>;
+
+export { LaunchpadOrbit, Mission, MissionControl, PayloadInjector, PoolManager, RefurbishUnit, Rocket, RocketStatus, bootstrapLaunchpad };

package/dist/index.d.ts

@@ -0,0 +1,188 @@
+import * as _gravito_ripple from '@gravito/ripple';
+import { OrbitRipple } from '@gravito/ripple';
+import { GravitoOrbit, PlanetCore } from '@gravito/core';
+import { ValueObject, AggregateRoot } from '@gravito/enterprise';
+
+interface MissionProps {
+    id: string;
+    repoUrl: string;
+    branch: string;
+    commitSha: string;
+}
+declare class Mission extends ValueObject<MissionProps> {
+    get id(): string;
+    get repoUrl(): string;
+    get branch(): string;
+    get commitSha(): string;
+    static create(props: MissionProps): Mission;
+}
+
+/**
+ * 火箭生命週期狀態
+ */
+declare enum RocketStatus {
+    IDLE = "IDLE",// 待命：容器運行中，無任務
+    PREPARING = "PREPARING",// 裝填：正在注入代碼 (Locked)
+    ORBITING = "ORBITING",// 運行：應用服務中
+    REFURBISHING = "REFURBISHING",// 翻新：正在清理環境
+    DECOMMISSIONED = "DECOMMISSIONED"
+}
+
+declare class Rocket extends AggregateRoot<string> {
+    private _status;
+    private _currentMission;
+    private _containerId;
+    private _assignedDomain;
+    constructor(id: string, containerId: string);
+    get status(): RocketStatus;
+    get currentMission(): Mission | null;
+    get containerId(): string;
+    get assignedDomain(): string | null;
+    /**
+     * 分配域名
+     */
+    assignDomain(domain: string): void;
+    /**
+     * 分配任務 (指派任務給 IDLE 的火箭)
+     */
+    assignMission(mission: Mission): void;
+    /**
+     * 點火啟動 (應用程式啟動成功)
+     */
+    ignite(): void;
+    /**
+     * 任務降落 (PR 合併或關閉，暫停服務)
+     */
+    splashDown(): void;
+    /**
+     * 翻新完成 (清理完畢，回歸池中)
+     */
+    finishRefurbishment(): void;
+    /**
+     * 火箭除役 (移除容器)
+     */
+    decommission(): void;
+    toJSON(): {
+        id: string;
+        containerId: string;
+        status: RocketStatus;
+        currentMission: Mission | null;
+        assignedDomain: string | null;
+    };
+    static fromJSON(data: any): Rocket;
+}
+
+/**
+ * 負責與底層容器引擎（如 Docker）溝通的轉接器介面
+ */
+interface IDockerAdapter {
+    createBaseContainer(): Promise<string>;
+    copyFiles(containerId: string, sourcePath: string, targetPath: string): Promise<void>;
+    executeCommand(containerId: string, command: string[]): Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+    /**
+     * 獲取容器映射到宿主機的真實端口
+     */
+    getExposedPort(containerId: string, containerPort?: number): Promise<number>;
+    removeContainer(containerId: string): Promise<void>;
+    /**
+     * 根據 Label 批量移除容器
+     */
+    removeContainerByLabel(label: string): Promise<void>;
+    streamLogs(containerId: string, onData: (data: string) => void): void;
+    getStats(containerId: string): Promise<{
+        cpu: string;
+        memory: string;
+    }>;
+}
+/**
+ * 負責代碼獲取
+ */
+interface IGitAdapter {
+    clone(repoUrl: string, branch: string): Promise<string>;
+}
+/**
+ * 負責動態反向代理與域名路由的轉接器
+ */
+interface IRouterAdapter {
+    register(domain: string, targetUrl: string): void;
+    unregister(domain: string): void;
+    start(port: number): void;
+}
+/**
+ * 負責持久化火箭狀態的儲存庫介面
+ */
+interface IRocketRepository {
+    save(rocket: Rocket): Promise<void>;
+    findById(id: string): Promise<Rocket | null>;
+    findIdle(): Promise<Rocket | null>;
+    findAll(): Promise<Rocket[]>;
+    delete(id: string): Promise<void>;
+}
+
+declare class PayloadInjector {
+    private docker;
+    private git;
+    constructor(docker: IDockerAdapter, git: IGitAdapter);
+    deploy(rocket: Rocket): Promise<void>;
+}
+
+declare class RefurbishUnit {
+    private docker;
+    constructor(docker: IDockerAdapter);
+    /**
+     * 執行火箭翻新邏輯
+     */
+    refurbish(rocket: Rocket): Promise<void>;
+}
+
+declare class PoolManager {
+    private dockerAdapter;
+    private rocketRepository;
+    private refurbishUnit?;
+    private router?;
+    constructor(dockerAdapter: IDockerAdapter, rocketRepository: IRocketRepository, refurbishUnit?: RefurbishUnit | undefined, router?: IRouterAdapter | undefined);
+    /**
+     * 初始化發射場：預先準備指定數量的火箭
+     */
+    warmup(count: number): Promise<void>;
+    /**
+     * 獲取一架可用的火箭並分配任務
+     */
+    assignMission(mission: Mission): Promise<Rocket>;
+    /**
+     * 回收指定任務的火箭
+     */
+    recycle(missionId: string): Promise<void>;
+}
+
+declare class MissionControl {
+    private poolManager;
+    private injector;
+    private docker;
+    private router?;
+    constructor(poolManager: PoolManager, injector: PayloadInjector, docker: IDockerAdapter, router?: IRouterAdapter | undefined);
+    launch(mission: Mission, onTelemetry: (type: string, data: any) => void): Promise<string>;
+}
+
+/**
+ * Gravito Launchpad Orbit
+ */
+declare class LaunchpadOrbit implements GravitoOrbit {
+    private ripple;
+    constructor(ripple: OrbitRipple);
+    install(core: PlanetCore): Promise<void>;
+}
+/**
+ * 一鍵啟動 Launchpad 應用程式
+ */
+declare function bootstrapLaunchpad(): Promise<{
+    port: number;
+    websocket: _gravito_ripple.WebSocketHandlerConfig;
+    fetch: (req: Request, server: any) => Response | Promise<Response> | undefined;
+}>;
+
+export { LaunchpadOrbit, Mission, MissionControl, PayloadInjector, PoolManager, RefurbishUnit, Rocket, RocketStatus, bootstrapLaunchpad };