@builder.io/dev-tools 1.17.4-dev.202510291025.824fafb3d → 1.17.5-dev.202510300826.98ea03d41

package/types/cli/codegen.d.ts

@@ -69,7 +69,7 @@ export declare class CodeGenSession {
     archiveProject(): Promise<string>;
     isIdle(): boolean;
     needsBackup(): Promise<boolean>;
-    uploadBackup(): Promise<BackupGitRepoResult | {
+    uploadBackup(forcedFullBackup?: boolean): Promise<BackupGitRepoResult | {
         success: false;
         error: Error;
     }>;

package/types/cli/repo-connect/env-collector.d.ts

@@ -0,0 +1,27 @@
+import type { EnvironmentVariable } from "$/ai-utils";
+import type { DevToolsSys } from "../../types";
+interface CategorizedEnvVar {
+    key: string;
+    value: string;
+    category: string;
+    isSecret: boolean;
+    shouldPreselect: boolean;
+    fromDotEnv?: boolean;
+}
+/**
+ * Filter and categorize environment variables
+ */
+export declare function filterAndCategorizeEnvVars(dotEnvVars?: Record<string, string>): CategorizedEnvVar[];
+/**
+ * Present multiselect UI for environment variables
+ */
+export declare function selectEnvironmentVariables(sys: DevToolsSys, gitRoot: string): Promise<EnvironmentVariable[] | null>;
+/**
+ * Format environment variables summary
+ */
+export declare function formatEnvSummary(envVars: EnvironmentVariable[]): {
+    total: number;
+    secrets: number;
+    public: number;
+};
+export {};

package/types/cli/repo-connect/file-collector.d.ts

@@ -0,0 +1,33 @@
+import type { DevToolsSys } from "../../types";
+import type { FileOverride } from "$/ai-utils";
+export interface CollectedFiles {
+    projectNpmrc?: {
+        path: string;
+        content: string;
+    };
+    userNpmrc?: {
+        path: string;
+        content: string;
+    };
+    etcHosts?: {
+        path: string;
+        content: string;
+    };
+}
+/**
+ * Collect configuration files from the project and system
+ */
+export declare function collectConfigFiles(sys: DevToolsSys, gitRoot: string): Promise<CollectedFiles>;
+/**
+ * Convert collected files to FileOverride array with proper path conventions
+ *
+ * Path conventions:
+ * - ./ prefix = relative to git repository root
+ * - ~/ prefix = relative to home directory
+ * - absolute paths = only for well-known system files
+ */
+export declare function filesToFileOverrides(collected: CollectedFiles): FileOverride[];
+/**
+ * Format collected files summary
+ */
+export declare function formatFilesSummary(collected: CollectedFiles): string[];

package/types/cli/repo-connect/git-detector.d.ts

@@ -0,0 +1,21 @@
+import type { DevToolsSys } from "../../types";
+export interface GitInfo {
+    gitRoot: string;
+    recommendedRoot?: string;
+    originUrl: string;
+    repoProvider: "github" | "gitlab" | "bitbucket" | "azure" | "custom";
+    repoProtocol: "https" | "ssh";
+    repoFullName: string;
+    repoOwner: string;
+    repoName: string;
+    isPrivate: boolean;
+    projectName: string;
+}
+/**
+ * Detect git repository information
+ */
+export declare function detectGitInfo(sys: DevToolsSys): Promise<GitInfo>;
+/**
+ * Display git info in a user-friendly format
+ */
+export declare function formatGitInfo(info: GitInfo): string[];

package/types/cli/repo-connect/install-runner.d.ts

@@ -0,0 +1,10 @@
+export interface InstallResult {
+    success: boolean;
+    command: string;
+    exitCode?: number;
+    skipped: boolean;
+}
+/**
+ * Run install command with live output and retry logic
+ */
+export declare function runInstallCommand(cwd: string, initialCommand?: string): Promise<InstallResult>;

package/types/cli/repo-connect/package-detector.d.ts

@@ -0,0 +1,21 @@
+import type { SetupMiseDependency } from "$/ai-utils";
+export interface PackageVersions {
+    node?: string;
+    npm?: string;
+    pnpm?: string;
+    yarn?: string;
+    bun?: string;
+    deno?: string;
+}
+/**
+ * Detect versions of installed package managers and runtimes
+ */
+export declare function detectPackageVersions(): Promise<PackageVersions>;
+/**
+ * Convert package versions to SetupMiseDependency array
+ */
+export declare function packagesToSetupDependencies(versions: PackageVersions): SetupMiseDependency[];
+/**
+ * Format package versions for display
+ */
+export declare function formatPackageVersions(versions: PackageVersions): string;

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

@@ -0,0 +1,6 @@
+import type { DevToolsSys } from "../../types";
+import type { CLIArgs } from "../index";
+/**
+ * Main repo-connect command handler
+ */
+export declare function runRepoConnectCommand(sys: DevToolsSys, args: CLIArgs): Promise<void>;

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

@@ -0,0 +1,33 @@
+import type { DevToolsSys } from "@builder.io/dev-tools/core";
+/**
+ * Check if an environment variable key should be filtered out
+ * @param key - The environment variable key to check
+ * @returns true if the variable should be filtered out, false otherwise
+ */
+export declare function shouldFilterEnvVar(key: string): boolean;
+/**
+ * Filter out unwanted environment variables from process.env
+ * @param env - The environment object to filter (defaults to process.env)
+ * @returns Filtered environment variables
+ */
+export declare function filterEnvVars(env?: Record<string, string | undefined>): Record<string, string>;
+/**
+ * Load environment variables from .env files in the working directory.
+ * Checks multiple .env file variants in order of priority.
+ *
+ * @param sys - DevToolsSys instance for file system access
+ * @param workingDirectory - Directory to look for .env files (defaults to cwd)
+ * @param envFiles - Array of .env file names to check (defaults to standard .env files)
+ * @returns Object containing environment variables from .env files
+ */
+export declare function loadDotEnvVars(sys: DevToolsSys, workingDirectory?: string, envFiles?: string[]): Promise<Record<string, string>>;
+/**
+ * Get a combined environment object with:
+ * 1. Filtered process.env (excluding npm_*, IDE variables, etc.)
+ * 2. .env file variables (highest priority)
+ *
+ * @param sys - DevToolsSys instance
+ * @param workingDirectory - Directory to look for .env files
+ * @returns Combined and filtered environment variables
+ */
+export declare function getFilteredEnvWithDotEnv(sys: DevToolsSys, workingDirectory?: string): Promise<Record<string, string>>;

package/types/cli/utils/file-overrides-manager.d.ts

@@ -0,0 +1,77 @@
+export interface FileOverride {
+    /**
+     * Path where the file should be written.
+     * - Absolute paths: "/app/.env", "/etc/config/app.conf"
+     * - Tilde expansion: "~/.config/app.json" (expands to home directory)
+     * - Relative paths: "./file.txt", "config.json" (resolved against working directory)
+     */
+    path: string;
+    /**
+     * Content to write to the file.
+     */
+    content: string;
+}
+export interface SentryLike {
+    captureException: (error: unknown) => void;
+}
+export interface ApplyFileOverridesResult {
+    success: boolean;
+    appliedFiles: string[];
+    failedFiles: Array<{
+        path: string;
+        error: string;
+    }>;
+}
+/**
+ * Expand tilde (~) in file path to home directory
+ * @param filePath - The file path that may contain tilde
+ * @returns Expanded path with home directory
+ */
+export declare function expandTildePath(filePath: string): string;
+/**
+ * Resolve a file path to an absolute path.
+ * Handles tilde expansion, relative paths, and absolute paths.
+ * @param filePath - The file path to resolve
+ * @param workingDirectory - Optional working directory for resolving relative paths
+ * @returns Resolved absolute path
+ */
+export declare function resolveFilePath(filePath: string, workingDirectory?: string): string;
+/**
+ * Validate that a file path can be resolved to an absolute path
+ * Supports tilde (~) expansion and relative paths (when workingDirectory is provided)
+ * @param filePath - The file path to validate
+ * @param workingDirectory - Optional working directory for resolving relative paths
+ * @returns true if valid, false otherwise
+ */
+export declare function isValidFilePath(filePath: string, workingDirectory?: string): boolean;
+/**
+ * Apply multiple file overrides to the filesystem.
+ * This function will:
+ * 1. Validate each file path
+ * 2. Resolve relative paths against working directory
+ * 3. Create directories as needed
+ * 4. Write files with the provided content
+ * 5. Return detailed results for success/failure of each file
+ *
+ * @param overrides - Array of file overrides to apply
+ * @param workingDirectory - Optional working directory for resolving relative paths
+ * @param sentry - Optional Sentry instance for error logging
+ * @returns Object with overall success status and details for each file
+ */
+export declare function applyFileOverrides(overrides: FileOverride[], workingDirectory?: string, sentry?: SentryLike): ApplyFileOverridesResult;
+/**
+ * Read a file and return its content
+ * Supports tilde (~) expansion and relative paths.
+ * @param filePath - The path to the file to read
+ * @param workingDirectory - Optional working directory for resolving relative paths
+ * @returns The file content or null if it cannot be read
+ */
+export declare function readFileOverride(filePath: string, workingDirectory?: string): string | null;
+/**
+ * Check if a file exists at the given path
+ * Supports tilde (~) expansion and relative paths.
+ * @param filePath - The path to check
+ * @param workingDirectory - Optional working directory for resolving relative paths
+ * @returns true if the file exists, false otherwise
+ */
+export declare function fileOverrideExists(filePath: string, workingDirectory?: string): boolean;

package/types/cli/utils/file-overrides-manager.test.d.ts

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