@builder.io/ai-utils 0.11.26 → 0.11.27

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.11.26",
+  "version": "0.11.27",
   "description": "Builder.io AI utils",
   "type": "module",
   "main": "src/index.js",

package/src/codegen.d.ts

@@ -974,6 +974,18 @@ export interface EnvironmentVariable {
     value: string;
     isSecret: boolean;
 }
+export interface FileOverride {
+    /**
+     * Absolute path where the file should be written in the container.
+     * Example: "/app/.env", "/etc/config/app.conf"
+     */
+    path: string;
+    /**
+     * Content to write to the file.
+     * Can be plain text or binary content (base64 encoded if needed).
+     */
+    content: string;
+}
 export interface FusionConfig {
     devCommand?: string;
     checkCommand?: string;
@@ -1044,6 +1056,12 @@ export interface FusionConfig {
      * @default false
      */
     autoConfigureHosts?: boolean;
+    /**
+     * Array of files to inject into the container during setup.
+     * These files will be written before setupCommand or devCommand is executed.
+     * Useful for configuration files, credentials, or environment-specific overrides.
+     */
+    fileOverrides?: FileOverride[];
     /**
      * Local MCP server configurations.
      * Servers defined here will be merged with servers from mcp.json.

package/src/projects.d.ts

@@ -1,4 +1,4 @@
-import type { LaunchServerState, LaunchServerStatus } from "./codegen";
+import type { FileOverride, EnvironmentVariable, LaunchServerState, LaunchServerStatus, BranchBackup } from "./codegen";
 export interface ConfigStatus {
     isReady: boolean;
     lastUpdated: string;
@@ -255,4 +255,191 @@ export interface SetupScriptDependency {
     name: string;
     script: string;
 }
+export type FusionExecutionEnvironment = "containerized" | "container-less" | "cloud";
+export interface PartialBranchData {
+    name?: string;
+    createdBy: string;
+    friendlyName: string;
+    isDefault: boolean;
+    isPublic: boolean;
+    lockedFusionEnvironment: FusionExecutionEnvironment;
+    metadata?: Record<string, unknown>;
+    backup?: BranchBackup;
+    gitAiBranch?: string | null;
+    lastCommitHash?: string | null;
+    lastCommitDate?: number | null;
+    commitMode?: "commits" | "draft-prs" | "prs";
+    useHomeDir?: boolean;
+    cloneFrom?: {
+        projectId: string;
+        branchName: string;
+    };
+}
+export interface Branch {
+    lockedFusionEnvironment?: FusionExecutionEnvironment;
+    id?: string;
+    appName?: string | null;
+    prNumber?: number | null;
+    prUrl?: string | null;
+    machineId?: string | null;
+    lastMachineIdRemovedAt?: number | null;
+    volumeId?: string | null;
+    secondaryVolumeId?: string | null;
+    volumeName?: string | null;
+    gitAiBranch?: string | null;
+    lastCommitHash?: string | null;
+    lastCommitDate?: number | null;
+    lastServerState?: LaunchServerState | null;
+    lastServerStateDate?: number | null;
+    lastServerVersion?: string | null;
+    name?: string;
+    createdBy?: string;
+    isPublic?: boolean;
+    isDefault?: boolean;
+    sessionId?: string;
+    createdAt?: number | null;
+    friendlyName?: string;
+    useHomeDir?: boolean;
+    useCloudHomeDir?: boolean;
+    ipv4?: {
+        address: string | null;
+        allocated: boolean | null;
+    } | null;
+    ipv6?: {
+        address: string | null;
+        allocated: boolean | null;
+    } | null;
+    preRecoveryData?: Partial<Branch> & {
+        recoveryDate: Date;
+    };
+    backup?: BranchBackup;
+    metadata?: Record<string, unknown>;
+    needsCleanup?: boolean;
+    deleted?: boolean;
+    updatedAt?: string;
+    commitMode?: "commits" | "draft-prs" | "prs";
+    kubePodName?: string | null;
+    kubeNamespace?: string | null;
+    kubePvcName?: string | null;
+    kubeHostname?: string | null;
+}
+export type CpuKind = "performance" | "shared";
+export type MachineAutoStop = "stop" | "off" | "suspend";
+export interface Project {
+    id: string;
+    name: string;
+    ownerId: string;
+    repoFullName: string | undefined;
+    repoProvider: string;
+    repoProtocol: string | undefined;
+    repoDescription?: string;
+    repoPrivate: boolean;
+    repoUrl: string | undefined;
+    createdDate: string;
+    updatedAt: string;
+    pinned?: boolean;
+    archived?: boolean;
+    createdBy: string;
+    checkRunCounts?: Record<string, number>;
+    repoAddedBy?: string;
+    pipelineCounts?: Record<string, number>;
+    needSetup?: boolean;
+    domains?: string[];
+    settings: {
+        autoDetectDevServer?: boolean;
+        autoDetectDevServerPatterns?: string[];
+        fusionEnvironment?: FusionExecutionEnvironment;
+        devServerPort?: number;
+        devServerUrl?: string;
+        refreshPreview?: boolean;
+        installCommand?: string;
+        gitBranchNamingStrategy?: "ai-session" | "branch-name" | "custom";
+        setupDependencies?: SetupDependency[];
+        gitBranchNamingCustom?: string;
+        devServerCommand?: string;
+        memoryLimit?: 1024 | 2048 | 4096 | 8192 | 16384;
+        cpuKind?: CpuKind;
+        autoStop?: MachineAutoStop;
+        mainBranchName?: string;
+        minMachinesRunning?: number;
+        volumeSize?: 5 | 10 | 12 | 15 | 20;
+        includePath?: string;
+        includePatterns?: string[];
+        environmentVariables?: EnvironmentVariable[];
+        fileOverrides?: FileOverride[];
+        commitMode?: "commits" | "draft-prs" | "prs";
+        dockerImagePath?: string;
+        nodeVersion?: string;
+        designSystems?: string[];
+        useNI?: boolean;
+        folders?: Array<{
+            name: string;
+            remoteUrl: string;
+            mainBranchName?: string;
+            includePath?: string;
+            addedBy?: string;
+            repoProvider?: string;
+            repoProtocol?: string;
+        }>;
+        agentsMD?: string;
+        initializationCommand?: string;
+        repoSubpath?: string;
+        recommendedRoot?: string;
+        https?: boolean;
+        localHttpsDomain?: string;
+        httpsServerKeyPath?: string;
+        httpsServerCertPath?: string;
+        httpsServerCaPath?: string;
+        httpsServerKeyContent?: string;
+        httpsServerCertContent?: string;
+        httpsServerCaContent?: string;
+        httpsServerPfx?: string;
+        httpsServerPassphrase?: string;
+        httpsServerSecureProtocol?: string;
+        httpsServerSecureOptions?: number;
+        httpsServerCiphers?: string;
+        httpsServerHonorCipherOrder?: boolean;
+        httpsServerRequestCert?: boolean;
+        httpsServerRejectUnauthorized?: boolean;
+    };
+    screenshot: string | null;
+    isExample?: boolean;
+    isPublic?: boolean;
+    snapshotVolume?: {
+        volumeId: string;
+        appName: string;
+        createdAt: number;
+    };
+    isFromUserTemplate?: boolean;
+    templateId?: string | null;
+    localPath?: string | null;
+}
+export interface ProjectWithBranches extends Project {
+    branches: Record<string, Branch>;
+}
+export interface OrganizationPrivate {
+    ownerId: string;
+    id: string;
+    installs?: {
+        ids: number[];
+        host: string;
+    }[];
+    createdAt: number;
+    updatedAt: number;
+}
+export interface CreateProjectOptions {
+    name: string;
+    repoFullName: string;
+    repoProvider: string;
+    repoProtocol: string;
+    repoDescription?: string;
+    repoPrivate: boolean;
+    repoUrl: string;
+    needSetup: boolean;
+    domains?: string[];
+    settings?: Partial<Project["settings"]>;
+    isPublic?: boolean;
+    isExample?: boolean;
+    templateId?: string;
+}
 export {};