@builder.io/dev-tools 1.19.14 → 1.20.0

package/types/cli/launch/InitStateMachine.d.ts

@@ -28,7 +28,7 @@ export declare class InitStateMachine {
     constructor(config: InitConfig);
     checkout(branchName: string, ref: string, repoPath: string): Promise<boolean>;
     execAsync(exec: string, args: string[], cwd?: string, retry?: number): Promise<string>;
-    git(args: string[], cwd?: string, retry?: number, timeout?: number): Promise<string>;
+    git(args: string[], cwd: string, retry?: number, timeout?: number): Promise<string>;
     performBackup({ sys, credentials, fusionConfig, volumePath, repositories, isConnectedToProvider, forcedFullBackup, }: {
         sys: DevToolsSys;
         credentials: Credentials;
@@ -67,6 +67,11 @@ export declare class InitStateMachine {
     private checkHostConnectivity;
     private checkConnectivityDirect;
     private checkConnectivityViaProxy;
+    /**
+     * Ensures the parent directory of the given path exists.
+     * Handles nested repo.path like "subdir/myproject".
+     */
+    private ensureParentDirExists;
     private cleanupLockFiles;
     validateGitRepo(repoPath: string): Promise<void>;
     /**

package/types/cli/launch/server.d.ts

@@ -11,6 +11,7 @@ export declare const NON_AUTHENTICATED_ENDPOINTS: {
     readonly PROXY_STATUS: "/proxy-status";
     readonly STATUS_V2: "/status-v2";
     readonly INIT_LOGS: "/init-logs";
+    readonly TUNNEL_STATUS: "/tunnel/status";
 };
 export declare const configureServer: ({ sys, app, validBuilderPrivateKey, authenticateProxy, isLocal, sharedState, }: {
     sys: DevToolsSys;

package/types/cli/launch/vscode-tunnel-manager.d.ts

@@ -0,0 +1,107 @@
+import { EventEmitter } from "events";
+/**
+ * VS Code Tunnel status
+ */
+export type TunnelStatus = "stopped" | "starting" | "running" | "error";
+/**
+ * VS Code Tunnel information
+ */
+export interface TunnelInfo {
+    status: TunnelStatus;
+    name: string | null;
+    url: string | null;
+    vscodeUri: string | null;
+    cursorUri: string | null;
+    webUrl: string | null;
+    error: string | null;
+    workspacePath: string;
+}
+/**
+ * Options for starting a VS Code tunnel
+ */
+export interface TunnelOptions {
+    name: string;
+    workspacePath?: string;
+    acceptLicense?: boolean;
+    autoRestart?: boolean;
+}
+/**
+ * VS Code Tunnel Manager
+ *
+ * Manages the lifecycle of a VS Code tunnel process, providing:
+ * - Start/stop functionality
+ * - URL parsing from CLI output
+ * - Health monitoring
+ * - Automatic restart on failure
+ * - Cleanup on shutdown
+ */
+export declare class VSCodeTunnelManager extends EventEmitter {
+    private process;
+    private status;
+    private tunnelName;
+    private tunnelUrl;
+    private error;
+    private workspacePath;
+    private autoRestart;
+    private restartAttempts;
+    private maxRestartAttempts;
+    private restartDelay;
+    private isShuttingDown;
+    constructor();
+    /**
+     * Start the VS Code tunnel
+     */
+    start(options: TunnelOptions): Promise<TunnelInfo>;
+    /**
+     * Spawn the tunnel process
+     */
+    private spawnTunnel;
+    /**
+     * Parse tunnel output to extract URL
+     */
+    private parseOutput;
+    /**
+     * Stop the VS Code tunnel
+     */
+    stop(): Promise<void>;
+    /**
+     * Get current tunnel information
+     */
+    getInfo(): TunnelInfo;
+    /**
+     * Get tunnel status
+     */
+    getStatus(): TunnelStatus;
+    /**
+     * Check if tunnel is enabled based on environment variables
+     */
+    static isEnabled(): boolean;
+    /**
+     * Check if auto-start is enabled
+     */
+    static isAutoStartEnabled(): boolean;
+    /**
+     * Get the configured tunnel name from environment or generate one
+     */
+    static getTunnelName(projectId?: string, branchName?: string): string;
+    /**
+     * Get the configured workspace path
+     */
+    static getWorkspacePath(): string;
+}
+/**
+ * Get the singleton tunnel manager instance
+ */
+export declare function getTunnelManager(): VSCodeTunnelManager;
+/**
+ * Generate VS Code deep link for a tunnel
+ */
+export declare function generateVSCodeDeepLink(tunnelName: string, workspacePath?: string): string;
+/**
+ * Generate Cursor deep link for a tunnel
+ */
+export declare function generateCursorDeepLink(tunnelName: string, workspacePath?: string): string;
+/**
+ * Generate web editor link for a tunnel
+ */
+export declare function generateWebEditorLink(tunnelName: string, workspacePath?: string): string;