@builder.io/dev-tools 1.7.8 → 1.7.9-dev.202507220502.f46b7a282

package/types/cli/backup.d.ts

@@ -13,18 +13,20 @@ export declare function requestSignedDownloadUrl(credentials: Credentials, body:
  * Records a successful git backup in Firebase
  */
 export declare function recordBackupSuccess(credentials: Credentials, body: GitBackupRecordOptions): Promise<GitBackupRecordResult>;
-/**
- * Downloads a git backup bundle
- * @returns The path to the downloaded bundle file, or null if no backup exists
- */
-export declare function downloadGitBackup(sys: DevToolsSys, credentials: Credentials, options: GitBackupDownloadUrlOptions): Promise<{
+export type GitBackupDownloadResult = {
     success: boolean;
+    partial?: boolean;
     exists?: boolean;
     bundlePath?: string;
     bundleSize?: number;
     error?: Error;
     message?: string;
-}>;
+};
+/**
+ * Downloads a git backup bundle
+ * @returns The path to the downloaded bundle file, or null if no backup exists
+ */
+export declare function downloadGitBackup(sys: DevToolsSys, credentials: Credentials, options: GitBackupDownloadUrlOptions): Promise<GitBackupDownloadResult>;
 /**
  * Uploads a file stream to a signed URL
  */

package/types/cli/codegen.d.ts

@@ -1,6 +1,6 @@
 import type { DevToolsSys } from "../types";
 import { type Credentials } from "./credentials";
-import type { CodegenFeedback, CodeGenToolMap, CodegenTurn, CommitMode, CustomInstruction, FusionConfig, GenerateCompletionState, GenerateCompletionStep, GenerateCompletionStepGit, GenerateUserMessage, UserContext, WorkspaceConfiguration, WorkspaceFolder, LoadWholeSessionOptions, LoadWholeSessionResult, LoadHistoryResult, CodeGenMode } from "$/ai-utils";
+import { type CodegenFeedback, type CodeGenToolMap, type CodegenTurn, type CommitMode, type CustomInstruction, type FusionConfig, type GenerateCompletionState, type GenerateCompletionStep, type GenerateCompletionStepGit, type GenerateUserMessage, type UserContext, type WorkspaceConfiguration, type WorkspaceFolder, type LoadWholeSessionOptions, type LoadWholeSessionResult, type LoadHistoryResult, type CodeGenMode } from "$/ai-utils";
 import prettier from "prettier";
 import { type FusionContext } from "./code-tools";
 import EventEmitter from "node:events";
@@ -56,33 +56,13 @@ export declare class CodeGenSession {
     getRepoUrl(): string | undefined;
     setPrUrl(prUrl: string): void;
     prExists(): boolean;
-    pushRepoV2({ repoFullName, remoteUrl, }: {
+    pushRepoV2({ repoFullName }: {
         repoFullName: string;
-        remoteUrl: string;
     }): Promise<{
-        output: string;
-        upToDate: boolean;
-        createdBranch: boolean;
-        setUpToStream: boolean;
-        status: GenerateCompletionStepGit | null;
-        success: boolean;
-        error?: undefined;
-        details?: undefined;
-    } | {
         success: boolean;
         error: string;
-        details: string;
+        details?: undefined;
     } | {
-        success: boolean;
-        error: string;
-    }>;
-    pushRepo(...args: [
-        {
-            repoFullName: string;
-            githubToken: string;
-            githubBaseUrl?: string;
-        }
-    ] | [string, string, string?]): Promise<{
         output: string;
         upToDate: boolean;
         createdBranch: boolean;
@@ -95,9 +75,6 @@ export declare class CodeGenSession {
         success: boolean;
         error: string;
         details: string;
-    } | {
-        success: boolean;
-        error: string;
     }>;
     archiveProject(): Promise<string>;
     isIdle(): Promise<boolean>;

package/types/cli/io-service.d.ts

@@ -0,0 +1,86 @@
+import { type SelectOptions, type ConfirmOptions, type TextOptions } from "@clack/prompts";
+import { spinner } from "./spinner";
+import type { WebSocket } from "ws";
+export interface IOService {
+    log(str: string): void;
+    info(str: string): void;
+    warn(str: string): void;
+    error(str: string): void;
+    write(text: string): void;
+    writeMetadata(metadata: Record<string, any>): void;
+    confirm(options: ConfirmOptions): Promise<boolean | symbol>;
+    text(options: TextOptions): Promise<string | symbol>;
+    select<Value>(options: SelectOptions<Value>): Promise<Value | symbol>;
+    createSpinner(): ReturnType<typeof spinner>;
+    isInteractive(): boolean;
+    isTTY(): boolean;
+    exit(code: number): Promise<void>;
+}
+export declare class ConsoleIOService implements IOService {
+    log(str: string): void;
+    info(str: string): void;
+    warn(str: string): void;
+    error(str: string): void;
+    write(text: string): void;
+    writeMetadata(_: Record<string, any>): void;
+    confirm(options: ConfirmOptions): Promise<boolean | symbol>;
+    text(options: TextOptions): Promise<string | symbol>;
+    select<Value>(options: SelectOptions<Value>): Promise<Value | symbol>;
+    createSpinner(): ReturnType<typeof spinner>;
+    isInteractive(): boolean;
+    isTTY(): boolean;
+    exit(code: number): Promise<void>;
+}
+export interface BaseMessage {
+    type: string;
+    [key: string]: any;
+}
+export interface LogMessage extends BaseMessage {
+    type: "log";
+    level: "info" | "warn" | "error";
+    message: string;
+}
+export interface WriteMessage extends BaseMessage {
+    type: "write";
+    text: string;
+}
+export interface SpinnerMessage extends BaseMessage {
+    type: "spinner";
+    status: "start" | "stop";
+    message: string;
+    code?: number;
+}
+export interface PromptRequest extends BaseMessage {
+    type: "prompt";
+    promptType: "text" | "confirm" | "select";
+    options: any;
+    requestId: string;
+}
+export interface PromptResponse extends BaseMessage {
+    type: "prompt_response";
+    requestId: string;
+    value: any;
+    cancelled?: boolean;
+}
+export declare class WebSocketIOService implements IOService {
+    private ws;
+    private promptCallbacks;
+    private messageQueue;
+    private isProcessing;
+    constructor(ws: WebSocket);
+    private sendMessage;
+    private prompt;
+    log(...args: any[]): void;
+    info(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+    write(text: string): void;
+    writeMetadata(metadata: Record<string, any>): void;
+    confirm(options: ConfirmOptions): Promise<boolean | symbol>;
+    text(options: TextOptions): Promise<string | symbol>;
+    select<Value>(options: SelectOptions<Value>): Promise<Value | symbol>;
+    createSpinner(): ReturnType<typeof spinner>;
+    isInteractive(): boolean;
+    isTTY(): boolean;
+    exit(code: number): Promise<void>;
+}

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

@@ -1,6 +1,7 @@
 import type { DevToolsSys } from "@builder.io/dev-tools/core";
 import { type FusionConfig, type WorkspaceFolder, type InitState, type InitStateStep, type InitStatusLog } from "$/ai-utils";
 import type { Credentials } from "../credentials";
+import { type GitBackupDownloadResult } from "../backup";
 export interface InitConfig {
     fusionConfig: FusionConfig;
     credentials: Credentials;
@@ -30,5 +31,15 @@ export declare class InitStateMachine {
     private isGitConfigured;
     private getGitRemoteUrl;
     private sanitizeGitRemoteUrl;
-    cloneRepository(repo: Required<WorkspaceFolder>, repoPath: string, signal?: AbortSignal): Promise<boolean>;
+    /**
+     * If a backup is available, perform a backup recovery (and throw if it fails and cannot be recovered from).
+     * If no backup is available, do nothing.
+     */
+    private restoreFromPartialBackup;
+    cloneRepository({ repo, repoPath, signal, backupResult, }: {
+        repo: Required<WorkspaceFolder>;
+        repoPath: string;
+        signal?: AbortSignal;
+        backupResult: GitBackupDownloadResult | undefined;
+    }): Promise<boolean>;
 }

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

@@ -1,12 +1 @@
-/**
- * Get the GitHub remote URL for a given repository
- * @param repoFullName - The full name of the repository (e.g. "BuilderIO/fusion-starter")
- * @param githubToken - The GitHub token to use for the remote URL
- * @returns The GitHub remote URL
- */
-export declare const getGitHubRemoteUrl: ({ repoFullName, githubToken, githubHost, }: {
-    repoFullName: string;
-    githubToken: string | undefined;
-    githubHost: string;
-}) => string;
 export declare const getCommandWithShellArgs: (command: string, shell: string) => string[];

package/types/cli/launch/install-jsx-plugin.d.ts

@@ -0,0 +1,7 @@
+import type { DevToolsSys } from "@builder.io/dev-tools/core";
+import { type InstallOutcome } from "./helpers";
+export declare const installJsxPlugin: (sys: DevToolsSys) => Promise<{
+    timestamp: string;
+    installOutcome: InstallOutcome;
+    error: string | undefined;
+}>;

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

@@ -0,0 +1,38 @@
+/**
+ * Initialize logging by wrapping all console methods to write to logs file
+ */
+export declare function initializeLogging(): void;
+/**
+ * Reset console methods to their original state
+ */
+export declare function resetLogging(): void;
+/**
+ * Display intro message with logging
+ */
+export declare const intro: (message: string) => void;
+/**
+ * Wrapped clack logging methods with file logging
+ */
+export declare const log: {
+    info: (message: string) => void;
+    success: (message: string) => void;
+    error: (message: string) => void;
+    warn: (message: string) => void;
+    step: (message: string) => void;
+    message: (message?: string, { symbol }?: import("@clack/prompts").LogMessageOptions) => void;
+    warning: (message: string) => void;
+};
+/**
+ * Display outro message with logging
+ */
+export declare const outro: (message: string) => void;
+/**
+ * Reads logs with pagination
+ * @param nextToken Line number to start reading from (0-indexed)
+ * @param limit Number of lines to read
+ * @returns Object containing logs array and next token
+ */
+export declare const readLogs: (nextToken?: number, limit?: number) => {
+    logs: string[];
+    nextToken: number | null;
+};

package/types/cli/launch-init-v2.d.ts

@@ -0,0 +1,13 @@
+import type { DevToolsSys } from "@builder.io/dev-tools/core";
+import type { CLIArgs } from "./index";
+export interface InitArgs extends CLIArgs {
+    repoFullName?: string;
+    branchName?: string;
+    githubToken?: string;
+    installCommand?: string;
+    dockerImageType?: "fusion-starter" | "node";
+}
+export declare function runLaunchInitCommandV2({ args, sys, }: {
+    sys: DevToolsSys;
+    args: InitArgs;
+}): Promise<number>;

package/types/cli/launch-init.d.ts

@@ -0,0 +1,19 @@
+import type { DevToolsSys } from "@builder.io/dev-tools/core";
+import type { CLIArgs } from "./index";
+export interface InitArgs extends CLIArgs {
+    repoFullName?: string;
+    branchName?: string;
+    githubToken?: string;
+    installCommand?: string;
+    volumePath?: string;
+    /**
+     * Indicates the type of docker image the CLI is running on.
+     *
+     * @default "node"
+     */
+    dockerImageType?: "fusion-starter" | "node";
+}
+export declare function runLaunchInitCommand({ args, sys, }: {
+    sys: DevToolsSys;
+    args: InitArgs;
+}): Promise<number>;

package/types/cli/repo-indexing-utils.d.ts

@@ -0,0 +1,2 @@
+import type { DevToolsSys } from "../core";
+export declare const parseDesignSystemVersion: (sys: DevToolsSys, designSystemPackage: string) => Promise<string | null | undefined>;

package/types/cli/repo-indexing.d.ts

@@ -0,0 +1,17 @@
+import type { DevToolsSys } from "../types";
+import type { CLIArgs } from "./index";
+export interface RepoIndexingDoc {
+    name: string;
+    content: string | {
+        name: string;
+        description: string;
+        components: string[];
+        relevantFiles: string[];
+    }[];
+    createdDate: string;
+    description: string;
+    id: string;
+    ownerId: string;
+    userId: string;
+}
+export declare const runRepoIndexing: (sys: DevToolsSys, args: CLIArgs) => Promise<void>;

package/types/cli/repo-indexing.mock.d.ts

@@ -0,0 +1,5 @@
+export declare const mockDeps: {
+    getStoredComponentDocs: () => Promise<never[]>;
+    storeComponentDocs: () => Promise<{}>;
+    runCodeGen: () => Promise<string>;
+};

package/types/cli/utils/repo-indexing-group-prompts.d.ts

@@ -0,0 +1 @@
+export declare const REPO_INDEXING_GROUP_PROMPT: string;

package/types/common/ast/component-input-types.d.ts

@@ -17,7 +17,7 @@ export declare const NUMBER_TYPES: string[];
 export declare const BOOLEAN_TYPES: string[];
 export declare const ARRAY_TYPES: string[];
 export declare const OBJECT_TYPES: string[];
-export declare function getPrimitiveType(t: string): "number" | "string" | "boolean" | "object" | "array";
+export declare function getPrimitiveType(t: string): "string" | "object" | "number" | "boolean" | "array";
 export declare function removeQuotes(text: string): string;
 export declare const resolveType: (sys: DevToolsSys, checker: ts.TypeChecker, type: ts.Type) => string[] | undefined;
 export declare const typeToString: (sys: DevToolsSys, checker: ts.TypeChecker, type: ts.Type) => string;

package/types/common/utils.d.ts

@@ -19,7 +19,7 @@ export declare function clone<T>(obj: T): T;
 export declare function shouldSkipFolder(sys: DevToolsSys, skipFolders: Set<string>, fileName: string): boolean;
 export declare function getPackageManager(): string;
 export declare function isWindows(): boolean;
-export declare function builderNpxPackage(): "\"@builder.io/dev-tools\"" | "builder.io";
+export declare function builderNpxPackage(): "builder.io" | "\"@builder.io/dev-tools\"";
 /**
  * Sanitizes a component name for use in filesystem paths by replacing invalid characters with underscores
  * @param name The component name to sanitize

package/types/core/adapters/vite/ensure-remix-config.d.ts

@@ -0,0 +1,6 @@
+import type { DevToolsSys } from "../..";
+import type { EnsureConfigResult } from "../../../types";
+/**
+ * Ensure the Remix Vite config has the necessary plugins and settings
+ */
+export declare function ensureRemixConfig(sys: DevToolsSys, configFilePath: string, configContent: string): Promise<EnsureConfigResult>;

package/types/core/adapters/vite/remix-utils.d.ts

@@ -0,0 +1,10 @@
+import type { DevToolsSys } from "../..";
+import type ts from "typescript";
+/**
+ * Check if the current project is using Remix framework
+ */
+export declare function isRemixFramework(sys: DevToolsSys): boolean;
+/**
+ * Update an object literal to include the external dependencies for Remix
+ */
+export declare function updateCommonJsLibrary(sys: DevToolsSys, config: ts.ObjectLiteralExpression): ts.ObjectLiteralExpression | null;

package/types/core/adapters/vite/vite-config-helpers.d.ts

@@ -0,0 +1,6 @@
+import type { DevToolsSys } from "../..";
+import type { EnsureConfigResult } from "../../../types";
+/**
+ * Update a Vite config file to include a plugin
+ */
+export declare function updateViteConfig(sys: DevToolsSys, configFilePath: string, configContent: string, pluginName: string, importPath: string): Promise<EnsureConfigResult>;