@builder.io/dev-tools 1.17.2-dev.202510281637.65b31df66 → 1.17.3-dev.202510281822.f967e53db

package/types/cli/utils/env-capture.d.ts

@@ -1,89 +0,0 @@
-/**
- * Options for capturing environment variables from a setup command
- */
-export interface EnvCaptureOptions {
-    /** The command to wrap with env capture */
-    command: string;
-}
-/**
- * Result of environment capture
- */
-export interface EnvCaptureResult {
-    /** The modified command that includes env capture */
-    command: string;
-    /** Path to the temporary file where env will be captured */
-    envFilePath: string;
-    /**
-     * Function to get the captured environment variables.
-     * This will read, parse, and cleanup the env file in one call.
-     * Returns undefined if the env file couldn't be read.
-     */
-    getCapturedEnv: () => Promise<Record<string, string> | undefined>;
-}
-/**
- * Wraps a command with environment variable capture at the end.
- * The environment is captured to a temporary file that can be parsed later.
- *
- * @param options - Configuration for env capture
- * @returns The modified command and a function to retrieve the captured env
- *
- * @example
- * ```typescript
- * const { command, getCapturedEnv } = wrapCommandWithEnvCapture({
- *   command: 'npm install',
- * });
- *
- * // Execute command...
- * // Later, get the captured environment (reads, parses, and cleans up automatically):
- * const env = await getCapturedEnv();
- * ```
- */
-export declare function wrapCommandWithEnvCapture(options: EnvCaptureOptions): EnvCaptureResult;
-/**
- * Parses an environment file into a key-value object.
- * Handles multi-line values and empty lines.
- *
- * @param filePath - Path to the environment file
- * @returns A promise that resolves to the parsed environment variables
- *
- * @example
- * ```typescript
- * const env = await parseEnvFile('/tmp/env.txt');
- * console.log(env.PATH); // "/usr/bin:/bin"
- * ```
- */
-export declare function parseEnvFile(filePath: string): Promise<Record<string, string>>;
-/**
- * Parses environment variable content into a key-value object.
- * This is the core parsing logic extracted for easier testing.
- *
- * Environment format is: KEY=VALUE
- * Each line represents one variable.
- *
- * @param content - The raw content from an env file
- * @returns The parsed environment variables
- *
- * @example
- * ```typescript
- * const env = parseEnvContent('PATH=/usr/bin\nHOME=/home/user');
- * // { PATH: '/usr/bin', HOME: '/home/user' }
- * ```
- */
-export declare function parseEnvContent(content: string): Record<string, string>;
-/**
- * Cleans up the environment capture file.
- * Call this after parsing to remove temporary files.
- *
- * @param filePath - Path to the environment file to clean up
- *
- * @example
- * ```typescript
- * try {
- *   const env = await parseEnvFile(envFilePath);
- *   // Use env...
- * } finally {
- *   await cleanupEnvFile(envFilePath);
- * }
- * ```
- */
-export declare function cleanupEnvFile(filePath: string): Promise<void>;

package/types/cli/utils/env-capture.test.d.ts

@@ -1 +0,0 @@
-export {};

package/types/cli/utils/lock-file-example.d.ts

@@ -1,30 +0,0 @@
-/**
- * Example demonstrating the lock file conflict behaviors
- *
- * This script demonstrates three different conflict behaviors:
- * - 'exit': Exits with code -10 if lock exists (default)
- * - 'replace': Overwrites existing lock file
- * - 'kill': Kills the existing process and overwrites lock file
- *
- * Usage:
- * ```bash
- * # Example 1: Exit behavior (default)
- * # First run - creates lock file and waits
- * ts-node lock-file-example.ts exit
- * # Second run (in another terminal) - exits with code -10
- * ts-node lock-file-example.ts exit
- *
- * # Example 2: Replace behavior
- * # First run - creates lock file and waits
- * ts-node lock-file-example.ts replace
- * # Second run - replaces the lock file (first process still runs)
- * ts-node lock-file-example.ts replace
- *
- * # Example 3: Kill behavior
- * # First run - creates lock file and waits
- * ts-node lock-file-example.ts kill
- * # Second run - kills the first process and takes over
- * ts-node lock-file-example.ts kill
- * ```
- */
-export {};

package/types/cli/utils/sudo-helper.d.ts

@@ -1,18 +0,0 @@
-import type { DevToolsSys } from "@builder.io/dev-tools/core";
-/**
- * Detects if a command contains "sudo"
- * @param command The command string to check
- * @returns true if the command contains "sudo", false otherwise
- */
-export declare function detectSudoInCommand(command: string): boolean;
-/**
- * Executes a command with sudo using sudo-prompt
- * @param command The command to execute
- * @param sys DevToolsSys instance for logging
- * @returns Promise with the execution result
- */
-export declare function executeSudoCommand(command: string, sys: DevToolsSys): Promise<{
-    stdout: string;
-    stderr: string;
-    error?: Error;
-}>;

package/types/packages/dev-tools/_tests_/code.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/create-builder.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/dev-tools.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/figma-generate.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/figma-publish.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/fusionInit.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/help.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/launch.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/repo-indexing.test.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/sync-utils.test.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/_tests_/utils.d.ts

@@ -1,44 +0,0 @@
-import { type ExpectStatic } from "vitest";
-interface CLI {
-    output(): string;
-    consumeOutput(): string;
-    inputText(text: string): Promise<void>;
-    inputEnter(text?: string): Promise<void>;
-    inputArrowUp(): Promise<void>;
-    inputArrowDown(): Promise<void>;
-    inputArrowRight(): Promise<void>;
-    inputArrowLeft(): Promise<void>;
-    inputCtrlC(): Promise<void>;
-    inputSpace(): Promise<void>;
-    waitUntilText(text: string, timeout?: number): Promise<void>;
-    waitUntilExit(): Promise<number>;
-    wait(ms: number): Promise<void>;
-    getProjectPath(): string;
-    writeFile(path: string, content: string): Promise<void>;
-    readFile(path: string): string;
-    exists(path: string): boolean;
-    readdir(path: string): string[];
-    fsSnapshot(path: string): Promise<Snapshot>;
-    fsDiff(oldSnap: Snapshot): Promise<{
-        added: string[];
-        removed: string[];
-        modified: string[];
-    }>;
-    npm(...args: string[]): Promise<number>;
-    spawn(command: string, args: string[]): Promise<number>;
-}
-export declare function testCLI(name: string, template: string | undefined, handler: (cli: Handler, expect: ExpectStatic) => Promise<void>, timeout?: number, skip?: boolean): void;
-type Handler = (cmd: "builderio" | "create-builderio", args: string[], options?: {
-    debug?: boolean;
-}) => CLI;
-export declare function createCLI(template: string | undefined, handler: (cli: Handler) => Promise<void>): Promise<void>;
-/**
- * A snapshot maps a file's relative path to its hash.
- */
-type Snapshot = {
-    cwd: string;
-    hashes: {
-        [file: string]: string;
-    };
-};
-export {};

package/types/packages/dev-tools/_tests_/vitest.config.d.ts

@@ -1,2 +0,0 @@
-declare const _default: import("vitest/config").UserConfigFnObject;
-export default _default;

package/types/packages/dev-tools/_tests_/workspace.e2e.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/angular/index.d.ts

@@ -1 +0,0 @@
-export declare function builderDevTools(): Promise<void>;

package/types/packages/dev-tools/cli/__tests__/isLikelyFixedString.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/cli/__tests__/parseGitDiffToApplyActions.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/cli/abort-signal-any.d.ts

@@ -1 +0,0 @@
-export declare function abortSignalAny(input: (AbortSignal | undefined)[]): AbortSignal;

package/types/packages/dev-tools/cli/auth/auth-utils.d.ts

@@ -1,2 +0,0 @@
-import type { Credentials } from "../credentials";
-export declare function getUserSettingsByUserId(credentials: Credentials): Promise<any>;

package/types/packages/dev-tools/cli/auth/auth.d.ts

@@ -1,3 +0,0 @@
-import type { DevToolsSys } from "../../types";
-import type { CLIArgs } from "../index";
-export declare const runAuthCommand: (sys: DevToolsSys, subCommand: string, args: CLIArgs) => Promise<void>;

package/types/packages/dev-tools/cli/auth/status.d.ts

@@ -1,3 +0,0 @@
-import type { DevToolsSys } from "../../types";
-import type { CLIArgs } from "../index";
-export declare const runAuthStatus: (sys: DevToolsSys, args: CLIArgs) => void;

package/types/packages/dev-tools/cli/backup.d.ts

@@ -1,118 +0,0 @@
-import type { DevToolsSys } from "../types";
-import type { Credentials } from "./credentials";
-import { type GitBackupUploadUrlResult, type GitBackupUploadUrlOptions, type GitBackupRecordOptions, type GitBackupRecordResult, type BackupMetadata, type WorkspaceConfiguration, type CodegenRuntimeStatus, type BackupGitRepoResult } from "$/ai-utils";
-interface BackupGitRepoOptions {
-    sys: DevToolsSys;
-    credentials: Credentials;
-    projectId: string;
-    branchName: string;
-    repoPath: string;
-    aiBranch: string;
-    featureBranch: string;
-    workspace: WorkspaceConfiguration | undefined;
-    /**
-     * If true, the system is connected to the git provider.
-     * If false, the system is offline and will not fetch any branches from origin.
-     */
-    isConnectedToProvider: boolean;
-    debug: boolean;
-    forcedFullBackup: boolean;
-    canAbortMerge: boolean;
-}
-/**
- * Creates a backup of git repository changes made by the AI system.
- *
- * This function handles both partial and full backups:
- * - Partial backups: Only include commits created locally (on aiBranch) that aren't in upstream.
- *   This keeps backups small and doesn't store the entire repo's code. Requires a clone from
- *   upstream plus applying the backup to restore.
- * - Full backups: Complete repo backup that can be directly cloned from.
- *
- * The aiBranch is where the AI creates commits as work progresses, while featureBranch
- * is the base branch where work started (usually "main").
- */
-export declare function backupGitRepo({ sys, credentials, projectId, branchName, repoPath, aiBranch, featureBranch, workspace, isConnectedToProvider, debug, forcedFullBackup, canAbortMerge }: BackupGitRepoOptions): Promise<BackupGitRepoResult>;
-type InitialCommitHashResult = {
-    initialBranch: string;
-    initialCommitHash: string | undefined;
-    partial: false;
-    forcedFullBackup: true;
-} | {
-    initialBranch: string;
-    initialCommitHash: string;
-    partial: boolean;
-    forcedFullBackup: false;
-};
-/**
- * Determines the initial commit hash and whether to create a partial or full backup.
- *
- * Partial backups are preferred to keep backup sizes small, but full backups are needed when:
- * - The repo is an example/starter template (users can't push to origin, need to fork)
- * - There's no origin remote configured
- *
- * For partial backups, we fetch the latest state of the chosen upstream branch from origin
- * to ensure the backup has the correct commit range reference.
- */
-export declare function getInitialCommitHash({ sys, repoPath, featureBranch, debug, workspace, isConnectedToProvider, forcedFullBackup, credentials, projectId }: {
-    sys: DevToolsSys;
-    repoPath: string;
-    featureBranch: string;
-    debug: boolean;
-    workspace: WorkspaceConfiguration | undefined;
-    isConnectedToProvider: boolean;
-    forcedFullBackup: boolean;
-    credentials: Credentials;
-    projectId: string;
-}): Promise<InitialCommitHashResult>;
-/**
- * Requests a signed upload URL for git backup
- */
-export declare function requestSignedUploadUrl(credentials: Credentials, body: GitBackupUploadUrlOptions): Promise<GitBackupUploadUrlResult | null>;
-/**
- * Records a successful git backup in Firebase
- */
-export declare function recordBackup(credentials: Credentials, body: GitBackupRecordOptions): Promise<GitBackupRecordResult>;
-export interface GitBackupDownloadResultValid {
-    success: true;
-    partial: boolean;
-    bundlePath: string | undefined;
-    bundleSize: number;
-    gitBranchName: string;
-    lastCommitHash: string;
-}
-export interface GitBackupDownloadResultInvalid {
-    success: false;
-    error: Error;
-}
-export type GitBackupDownloadResult = GitBackupDownloadResultValid | GitBackupDownloadResultInvalid;
-/**
- * Downloads a git backup bundle from remote storage.
- * Handles both empty backups (no bundle file) and regular backups with bundle files.
- * @returns The path to the downloaded bundle file, or undefined if it's an empty backup
- */
-export declare function downloadGitBackup(sys: DevToolsSys, response: BackupMetadata): Promise<GitBackupDownloadResult>;
-/**
- * Uploads a file stream to a signed URL (Google Cloud Storage).
- * Uses MD5 hash for content verification as required by GCS.
- */
-export declare function uploadFileStream(filePath: string, signedUrl: string, size: number, contentMd5: string): Promise<Response>;
-export declare function computeMD5Hash(bundlePath: string): Promise<{
-    contentMd5: string;
-    size: number;
-}>;
-/**
- * Updates the last commit hash in the database for tracking purposes.
- * This is called frequently throughout the codebase (after every commit creation)
- * to track the current state and determine if backups are up-to-date.
- */
-export declare function setRuntimeStatus(sys: DevToolsSys, credentials: Credentials, data: CodegenRuntimeStatus): Promise<any>;
-/**
- * Computes a unique backup reference string that combines version, repo URL, and commit hash.
- * This reference can be used to identify and retrieve specific backups.
- */
-export declare function computeBackupRef(input: {
-    version: string | undefined;
-    originalRepoUrl: string | undefined;
-    commitHash: string | undefined;
-}): string | undefined;
-export {};

package/types/packages/dev-tools/cli/builder-add/interface.d.ts

@@ -1,5 +0,0 @@
-import type { AddCliOptions, FileNode, FolderNode, Snippet, SyncInfo } from "../../types";
-export declare function addCommand(opts: AddCliOptions): Promise<SyncInfo | undefined>;
-export declare function fetchSnippet(id: string): Promise<Snippet | null>;
-export declare function writeFiles(appRootDir: string, snippet: Snippet, files: Array<FileNode | FolderNode>, rootPath: string, addSessionLink: boolean): Promise<FileNode[]>;
-export declare function suggestRootPath(appRootDir: string, framework: string): string;

package/types/packages/dev-tools/cli/builder-add/options.d.ts

@@ -1,2 +0,0 @@
-import type { AddCliOptions } from "../../types";
-export declare function getOptions(cwd: string, args: string[]): AddCliOptions;

package/types/packages/dev-tools/cli/code-file-utils.d.ts

@@ -1,12 +0,0 @@
-import type { DevToolsSys } from "../types";
-import type { Credentials } from "./credentials";
-import type { CodebaseSearchOptions, CodebaseSearchResponse } from "$/ai-utils";
-export declare function shouldIncludeFile(inputFile: string, ctx: {
-    foundFiles: string[];
-    allFiles: string[];
-    selectedFilePaths: Map<string, number>;
-    cwd: string;
-    appRootDir: string;
-    fallbackImportance: number | 0;
-}): number | 0;
-export declare function searchCodeBase(sys: DevToolsSys, credentials: Credentials, signal: AbortSignal | undefined, body: CodebaseSearchOptions): Promise<CodebaseSearchResponse | null>;

package/types/packages/dev-tools/cli/code-file-utils.unit.d.ts

@@ -1 +0,0 @@
-export {};

package/types/packages/dev-tools/cli/code-tools.d.ts

@@ -1,99 +0,0 @@
-import type { AccessResult, CodeGenPosition, CodeGenTools, CodegenTurn, ContentMessageItemToolResult, FusionConfig, GenerateCompletionStep, Permission, ProjectFile, UserSource, WorkspaceFolder } from "$/ai-utils";
-import type { DevToolsSys } from "../core";
-import { type DevServerOrchestrator } from "./launch/dev-server-orchestrator";
-import type { CodeGenEventEmitter } from "./codegen";
-import type { Credentials } from "./credentials";
-export interface LLMToolCalls {
-    name: CodeGenTools;
-    input: Record<string, any>;
-    id: string;
-    abortController: AbortController;
-}
-export interface ToolResolution {
-    toolResult: string;
-    isError: boolean;
-    title?: string;
-}
-export interface FusionContext {
-    devServerOrchestrator?: DevServerOrchestrator;
-    git: boolean;
-    gitRemote?: string;
-    gitAutoInit?: boolean;
-}
-export interface ToolContext extends Partial<FusionContext> {
-    sys: DevToolsSys;
-    credentials: Credentials;
-    files: ProjectFile[];
-    user: UserSource;
-    position: CodeGenPosition;
-    emitter: CodeGenEventEmitter;
-    fusionConfig: FusionConfig | undefined;
-    canCollapseWorkspace: boolean;
-    signal: AbortSignal;
-    workingDirectory: string;
-    allowedCommands: RegExp[];
-    getAllFiles: (options: {
-        getDotFiles?: boolean;
-        pattern?: string;
-    }) => Promise<string[]>;
-    restore: (options: {
-        location: "before" | "after";
-        predicate: (turn: CodegenTurn | null, index: number) => boolean;
-        dryRun?: boolean;
-        revert?: boolean;
-        forceReplay?: boolean;
-        debug?: string;
-    }) => Promise<{
-        undone: string[] | null;
-        message: string;
-    }>;
-    bashWorkingDirectory: string;
-    filterText: (text: string) => string;
-    resolveWorkspacePath: (path: string, forceWorkspace: boolean) => {
-        resolvedPath: string;
-        workspaceFolder?: WorkspaceFolder;
-    };
-    absolutePathToWorkspaceUrl: (absolutePath: string) => string | undefined;
-    workspaceFolders: Array<{
-        path: string;
-        name?: string;
-    }>;
-    patchFusionConfig: (patch: Partial<FusionConfig>) => void;
-    passThrough: (toolCall: LLMToolCalls, signal: AbortSignal) => Promise<ToolResolution>;
-    readFile: (filePath: string) => Promise<string | null>;
-    writeFile: (filePath: string, content: string | Uint8Array) => Promise<string | null>;
-    deleteFile: (filePath: string) => Promise<string | null>;
-    fileExists: (filePath: string) => Promise<{
-        absolutePath: string | undefined;
-        recommendedPath: string | undefined;
-        workspaceFolder: WorkspaceFolder | undefined;
-        virtual: boolean;
-    }>;
-    listDir: (dirPath: string) => Promise<string[]>;
-    evaluateAccess: (resource: string, permission: Permission) => AccessResult;
-    stat: (filePath: string) => Promise<{
-        isDirectory: () => boolean;
-        isFile: () => boolean;
-        size: number;
-    } | null>;
-}
-export declare function resolveToolCalls(toolContext: ToolContext, toolCalls: LLMToolCalls[], existingToolResults: ContentMessageItemToolResult[] | undefined, onStep: (step: GenerateCompletionStep) => void): Promise<ContentMessageItemToolResult[]>;
-interface RipgrepMatch {
-    path: string;
-    lineNumber: number;
-    lineContent: string;
-}
-interface RipgrepResult {
-    matches: RipgrepMatch[];
-}
-export declare function runRipgrep(sys: DevToolsSys, bashWorkingDirectory: string, pattern: string, includeGlob?: string, excludeGlob?: string): Promise<RipgrepResult>;
-/**
- * Returns true if query is likely a string literal rather than a regex.
- * Returns false otherwise.
- * This is intended to ensure that queries such as "import {" do not get
- * interpreted as invalid regex values by ripgrep.
- * @param query - The query to check
- */
-export declare const isLikelyFixedString: (query: string) => boolean;
-export declare function newAbortError(): Error;
-export {};

package/types/packages/dev-tools/cli/code.d.ts

@@ -1,7 +0,0 @@
-import type { DevToolsSys } from "../types";
-import type { CLIArgs } from "./index";
-import { type UserContext } from "$/ai-utils";
-export declare const runCodeCommand: (sys: DevToolsSys, subCommand: string, args: CLIArgs) => Promise<void>;
-export declare const runCodeGen: (sys: DevToolsSys, args: CLIArgs) => Promise<undefined>;
-export declare function checkProjectRoot(sys: DevToolsSys, interactive: boolean): Promise<void>;
-export declare function getUserContext(sys: DevToolsSys): Promise<UserContext>;