@builder.io/dev-tools 1.18.11-dev.202511202319.621aec6ae → 1.18.11-dev.202511210323.98709336d

package/types/_tests_/utils.d.ts

@@ -1,57 +1,44 @@
 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>;
+    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>;
+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;
-	};
+    cwd: string;
+    hashes: {
+        [file: string]: string;
+    };
 };
 export {};

package/types/cli/abort-signal-any.d.ts

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

package/types/cli/auth/auth-utils.d.ts

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

package/types/cli/auth/auth.d.ts

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

package/types/cli/backup.d.ts

@@ -1,32 +1,23 @@
 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";
+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;
+    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.
@@ -40,33 +31,18 @@ interface BackupGitRepoOptions {
  * 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;
-	  };
+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.
  *
@@ -77,96 +53,66 @@ type InitialCommitHashResult =
  * 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;
+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>;
+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 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;
+    success: true;
+    partial: boolean;
+    bundlePath: string | undefined;
+    bundleSize: number;
+    gitBranchName: string;
+    lastCommitHash: string;
 }
 export interface GitBackupDownloadResultInvalid {
-	success: false;
-	error: Error;
+    success: false;
+    error: Error;
 }
-export type GitBackupDownloadResult =
-	| GitBackupDownloadResultValid
-	| GitBackupDownloadResultInvalid;
+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>;
+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 uploadFileStream(filePath: string, signedUrl: string, size: number, contentMd5: string): Promise<Response>;
 export declare function computeMD5Hash(bundlePath: string): Promise<{
-	contentMd5: string;
-	size: number;
+    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>;
+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;
+    version: string | undefined;
+    originalRepoUrl: string | undefined;
+    commitHash: string | undefined;
 }): string | undefined;
 export {};

package/types/cli/builder-add/interface.d.ts

@@ -1,22 +1,5 @@
-import type {
-	AddCliOptions,
-	FileNode,
-	FolderNode,
-	Snippet,
-	SyncInfo,
-} from "../../types";
-export declare function addCommand(
-	opts: AddCliOptions,
-): Promise<SyncInfo | undefined>;
+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;
+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/cli/code-file-utils.d.ts

@@ -1,20 +1,12 @@
 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>;
+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/cli/code.d.ts

@@ -1,17 +1,7 @@
 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 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>;

package/types/cli/credentials.d.ts

@@ -2,77 +2,61 @@ import type { DevToolsSys } from "../types";
 import type { CLIArgs } from "./index";
 import type { Feature } from "$/ai-utils";
 export interface CredentialsOptions {
-	forceSpaceId?: string;
-	builderPublicKey?: boolean;
-	builderPrivateKey?: boolean;
-	/**
-	 * `always`: Figma auth will be required even if Figma credentials have already been set.
-	 * `if-unset`: Figma auth will be required only if Figma credentials have not been set.
-	 * `undefined` (default): Figma auth will never be required.
-	 * */
-	requireFigmaAuth?: "always" | "if-unset";
-	/**
-	 * If `true`, Builder.io auth will be required even if Builder.io credentials have
-	 * already been set.
-	 */
-	force?: boolean;
+    forceSpaceId?: string;
+    builderPublicKey?: boolean;
+    builderPrivateKey?: boolean;
+    /**
+     * `always`: Figma auth will be required even if Figma credentials have already been set.
+     * `if-unset`: Figma auth will be required only if Figma credentials have not been set.
+     * `undefined` (default): Figma auth will never be required.
+     * */
+    requireFigmaAuth?: "always" | "if-unset";
+    /**
+     * If `true`, Builder.io auth will be required even if Builder.io credentials have
+     * already been set.
+     */
+    force?: boolean;
 }
 export interface FigmaAuth {
-	access_token: string;
-	oauth: boolean;
+    access_token: string;
+    oauth: boolean;
 }
 export interface BuilderCodegenUsage {
-	total: number | undefined;
-	fast: number | undefined;
-	quality: number | undefined;
-	features?: Feature[];
-	limits?: {
-		aiGeneration: number;
-		aiGenerationContextWindow: number;
-	};
+    total: number | undefined;
+    fast: number | undefined;
+    quality: number | undefined;
+    features?: Feature[];
+    limits?: {
+        aiGeneration: number;
+        aiGenerationContextWindow: number;
+    };
 }
 export interface BuilderAuth {
-	privateKey: string;
-	spaceId: string;
-	spaceName: string;
-	userId: string;
+    privateKey: string;
+    spaceId: string;
+    spaceName: string;
+    userId: string;
 }
 export declare const isCI: (args: CLIArgs) => boolean;
 export interface Credentials {
-	figmaAuth?: FigmaAuth;
-	builderPublicKey?: string;
-	builderPrivateKey?: string;
-	spaceName?: string;
-	userId?: string;
-	timestamp?: string;
+    figmaAuth?: FigmaAuth;
+    builderPublicKey?: string;
+    builderPrivateKey?: string;
+    spaceName?: string;
+    userId?: string;
+    timestamp?: string;
 }
-export declare const readCredentials: (
-	sys: DevToolsSys,
-	args: CLIArgs,
-) => {
-	spaceName: string | undefined;
-	userId: string | undefined;
-	builderPublicKey: string | undefined;
-	builderPrivateKey: string | undefined;
-	figmaAuth: FigmaAuth | undefined;
-	timestamp: string | undefined;
+export declare const readCredentials: (sys: DevToolsSys, args: CLIArgs) => {
+    spaceName: string | undefined;
+    userId: string | undefined;
+    builderPublicKey: string | undefined;
+    builderPrivateKey: string | undefined;
+    figmaAuth: FigmaAuth | undefined;
+    timestamp: string | undefined;
 };
-export declare const getCredentials: (
-	sys: DevToolsSys,
-	args: CLIArgs,
-	opts: CredentialsOptions,
-) => Promise<Credentials>;
+export declare const getCredentials: (sys: DevToolsSys, args: CLIArgs, opts: CredentialsOptions) => Promise<Credentials>;
 export declare function getFigmaAuth(sys: DevToolsSys): Promise<FigmaAuth>;
-export declare function getBuilderCodegenUsage(
-	builderPublicKey: string,
-	builderPrivateKey: string,
-): Promise<BuilderCodegenUsage>;
-export declare function getBuilderAuth(
-	sys: DevToolsSys,
-	preferSpaceId?: string,
-): Promise<BuilderAuth>;
-export declare function storeCredentials(
-	sys: DevToolsSys,
-	credentials: Credentials,
-): void;
+export declare function getBuilderCodegenUsage(builderPublicKey: string, builderPrivateKey: string): Promise<BuilderCodegenUsage>;
+export declare function getBuilderAuth(sys: DevToolsSys, preferSpaceId?: string): Promise<BuilderAuth>;
+export declare function storeCredentials(sys: DevToolsSys, credentials: Credentials): void;
 export declare function clearCredentials(sys: DevToolsSys): boolean;

package/types/cli/download.d.ts

@@ -2,14 +2,9 @@ import type { CLIArgs } from "./index";
 import type { DevToolsSys } from "../types";
 import type { FigmaBuilderLink } from "$/ai-utils";
 interface KVGetRequest {
-	privateKey: string;
-	spaceId: string;
+    privateKey: string;
+    spaceId: string;
 }
-export declare const runFigmaMigrate: (
-	sys: DevToolsSys,
-	args: CLIArgs,
-) => Promise<undefined>;
-export declare function getBuilderSpaceFigmaLinks(
-	kvReq: KVGetRequest,
-): Promise<FigmaBuilderLink[]>;
+export declare const runFigmaMigrate: (sys: DevToolsSys, args: CLIArgs) => Promise<undefined>;
+export declare function getBuilderSpaceFigmaLinks(kvReq: KVGetRequest): Promise<FigmaBuilderLink[]>;
 export {};

package/types/cli/figma-publish.d.ts

@@ -2,40 +2,23 @@ import ts from "typescript";
 import type { DevTools, DevToolsSys } from "../types";
 import type { CLIArgs } from "./index";
 import type { FigmaBuilderLink, FigmaMapperFile } from "$/ai-utils";
-export declare const runFigmaPublish: (
-	sys: DevToolsSys,
-	args: CLIArgs,
-) => Promise<undefined>;
+export declare const runFigmaPublish: (sys: DevToolsSys, args: CLIArgs) => Promise<undefined>;
 export declare const FIGMA_CONNECT_CALL = "figmaMapping";
-export declare function findAllMappingFiles(
-	sys: DevToolsSys,
-): Promise<string[]>;
-export declare function setPublicKey(
-	sys: DevToolsSys,
-	publicKey: string,
-	devTools: DevTools | undefined,
-	ensureFigmaImportPage?: boolean,
-): Promise<
-	| {
-			success: boolean;
-			error: string;
-	  }
-	| {
-			success: boolean;
-			error?: undefined;
-	  }
->;
-export declare function findMappingsFromFiles({
-	sys,
-	mappingFiles,
-	typeCheck,
-}: {
-	mappingFiles: string[];
-	sys: DevToolsSys;
-	typeCheck?: boolean;
+export declare function findAllMappingFiles(sys: DevToolsSys): Promise<string[]>;
+export declare function setPublicKey(sys: DevToolsSys, publicKey: string, devTools: DevTools | undefined, ensureFigmaImportPage?: boolean): Promise<{
+    success: boolean;
+    error: string;
+} | {
+    success: boolean;
+    error?: undefined;
+}>;
+export declare function findMappingsFromFiles({ sys, mappingFiles, typeCheck, }: {
+    mappingFiles: string[];
+    sys: DevToolsSys;
+    typeCheck?: boolean;
 }): Promise<{
-	mapperFiles: FigmaMapperFile[];
-	figmaBuilderLinks: FigmaBuilderLink[];
-	diagnostics: ts.Diagnostic[];
-	figmaLinksToResolve: string[];
+    mapperFiles: FigmaMapperFile[];
+    figmaBuilderLinks: FigmaBuilderLink[];
+    diagnostics: ts.Diagnostic[];
+    figmaLinksToResolve: string[];
 }>;