builder.io 1.17.3 → 1.17.4

package/types/cli/codegen.d.ts

@@ -78,7 +78,11 @@ export declare class CodeGenSession {
     pullLatestFromRemote(): Promise<CodegenApiResult>;
     abortMerge(emitStatus?: boolean): Promise<CodegenApiResult>;
     syncChangesFromRemote(opts?: {
+        remoteBranches?: "both" | "main" | "ai";
         fastForward?: "never" | "required" | "auto";
+        canPush?: boolean;
+        uncommittedChanges?: "stash" | "commit" | "fail";
+        allowUnrelatedHistory?: boolean;
     }): Promise<CodegenApiResult>;
     /**
      * Get the current commit hash

package/types/cli/credentials.d.ts

@@ -5,7 +5,16 @@ export interface CredentialsOptions {
     forceSpaceId?: string;
     builderPublicKey?: boolean;
     builderPrivateKey?: boolean;
-    figmaAuth?: 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 {

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

@@ -0,0 +1,89 @@
+/**
+ * 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

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

package/types/cli/utils/process-tracker.d.ts

@@ -76,6 +76,7 @@ export declare const isMultiLineCommand: (command: string) => boolean;
  * Creates a temporary script file for multi-line commands
  */
 export declare const createTempScript: (command: string, shell: string) => string;
+export declare const getTempScriptPath: (extension: string) => string;
 /**
  * Cleans up a temporary script file
  */