@builder.io/ai-utils 0.87.0 → 0.87.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.87.0",
+  "version": "0.87.1",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/codegen.d.ts

@@ -4122,6 +4122,12 @@ export interface BranchBackup {
     forced: ForcedBackup;
     commitInRepoVerified?: "verified" | "not-found" | "unverified";
     metadata?: Record<string, any>;
+    /**
+     * Paths of submodules / embedded git repos whose state the bundle cannot
+     * reproduce. When non-empty the backup is restorable for the outer repo
+     * but must not be treated as deletion-safe.
+     */
+    changedSubmodules?: string[];
 }
 export interface CheckBackupDataResultValid {
     state: "valid";
@@ -4141,15 +4147,26 @@ export interface CheckBackupDataResultStale {
     message: string;
     backup: BranchBackup;
 }
+/**
+ * The backup is otherwise valid but includes submodule changes the bundle
+ * cannot reproduce (see BranchBackup.changedSubmodules). It can still be
+ * restored, but the volume must be retained.
+ */
+export interface CheckBackupDataResultSubmoduleChanges {
+    state: "submodule-changes";
+    outcome: "submodule-changes";
+    message: string;
+    backup: BranchBackup;
+}
 export interface CheckBackupDataResultInvalid {
     state: "invalid";
     outcome: "no-backup" | "error" | "not-completed" | "no-session-id" | "no-last-commit-hash" | "no-backup-file" | "empty-full-backup" | "no-vcpCodeGenEvent" | "commits-not-in-repo" | "no-after-commit" | "no-signed-url" | "no-git-branch-name" | "repo-url-mismatch" | "branch-uninitialized" | "unexpected-partial-backup" | "unexpected-full-backup" | "no-backup-keys";
     message: string;
     backup: BranchBackup | undefined;
 }
-export type CheckBackupDataResult = CheckBackupDataResultValid | CheckBackupDataResultForcedBackup | CheckBackupDataResultStale | CheckBackupDataResultInvalid;
+export type CheckBackupDataResult = CheckBackupDataResultValid | CheckBackupDataResultForcedBackup | CheckBackupDataResultStale | CheckBackupDataResultSubmoduleChanges | CheckBackupDataResultInvalid;
 export interface BackupMetadata {
-    check: CheckBackupDataResultValid | CheckBackupDataResultStale | CheckBackupDataResultForcedBackup;
+    check: CheckBackupDataResultValid | CheckBackupDataResultStale | CheckBackupDataResultForcedBackup | CheckBackupDataResultSubmoduleChanges;
     downloadUrl: GitBackupDownloadUrlResult | undefined;
     downloadUrlError?: string;
 }

package/src/fusion-environment.d.ts

@@ -0,0 +1,5 @@
+import type { Branch, FusionExecutionEnvironment } from "./projects.js";
+/** Upgrade legacy `cloud` to `cloud-v2` when kube is enabled. */
+export declare function upgradeCloudForKube(environment: FusionExecutionEnvironment, useKube: boolean): FusionExecutionEnvironment;
+/** Work branch whose fusion environment a new sibling branch should inherit. */
+export declare function pickReferenceWorkBranch(branches: Branch[]): Branch | undefined;

package/src/fusion-environment.js

@@ -0,0 +1,16 @@
+import { getBranchState } from "./projects.js";
+/** Upgrade legacy `cloud` to `cloud-v2` when kube is enabled. */
+export function upgradeCloudForKube(environment, useKube) {
+    return environment === "cloud" && useKube ? "cloud-v2" : environment;
+}
+/** Work branch whose fusion environment a new sibling branch should inherit. */
+export function pickReferenceWorkBranch(branches) {
+    var _a, _b;
+    const activeWorkBranches = branches.filter((branch) => {
+        if (branch.type === "deploy" || branch.hidden) {
+            return false;
+        }
+        return getBranchState(branch) === "active";
+    });
+    return ((_b = (_a = activeWorkBranches.find((branch) => branch.name === "development")) !== null && _a !== void 0 ? _a : activeWorkBranches.find((branch) => branch.isDefault)) !== null && _b !== void 0 ? _b : activeWorkBranches[0]);
+}

package/src/fusion-environment.test.d.ts

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

package/src/fusion-environment.test.js

@@ -0,0 +1,40 @@
+import { describe, it, expect } from "vitest";
+import { pickReferenceWorkBranch, upgradeCloudForKube, } from "./fusion-environment.js";
+function branch(overrides) {
+    return {
+        id: `br-${overrides.name}`,
+        projectId: "project-1",
+        ownerId: "org-1",
+        isPublic: true,
+        ...overrides,
+    };
+}
+describe("upgradeCloudForKube", () => {
+    it("upgrades cloud when useKube is true", () => {
+        expect(upgradeCloudForKube("cloud", true)).toBe("cloud-v2");
+    });
+    it("leaves cloud-v2 unchanged", () => {
+        expect(upgradeCloudForKube("cloud-v2", false)).toBe("cloud-v2");
+    });
+});
+describe("pickReferenceWorkBranch", () => {
+    it("prefers development over other work branches", () => {
+        var _a;
+        expect((_a = pickReferenceWorkBranch([
+            branch({ name: "feature-a", lockedFusionEnvironment: "cloud" }),
+            branch({ name: "development", lockedFusionEnvironment: "cloud-v2" }),
+        ])) === null || _a === void 0 ? void 0 : _a.name).toBe("development");
+    });
+    it("ignores deploy and hidden branches", () => {
+        var _a;
+        expect((_a = pickReferenceWorkBranch([
+            branch({
+                name: "deploy-pod",
+                type: "deploy",
+                hidden: true,
+                lockedFusionEnvironment: "cloud",
+            }),
+            branch({ name: "development", lockedFusionEnvironment: "cloud-v2" }),
+        ])) === null || _a === void 0 ? void 0 : _a.name).toBe("development");
+    });
+});

package/src/index.d.ts

@@ -9,6 +9,7 @@ export * from "./codegen.js";
 export * from "./codegen/investigation-context.js";
 export * from "./diff-hunks.js";
 export * from "./projects.js";
+export * from "./fusion-environment.js";
 export * from "./repo-indexing.js";
 export * from "./organization.js";
 export * from "./features.js";

package/src/index.js

@@ -9,6 +9,7 @@ export * from "./codegen.js";
 export * from "./codegen/investigation-context.js";
 export * from "./diff-hunks.js";
 export * from "./projects.js";
+export * from "./fusion-environment.js";
 export * from "./repo-indexing.js";
 export * from "./organization.js";
 export * from "./features.js";

package/src/projects.d.ts

@@ -283,6 +283,14 @@ export interface GitBackupRecordOptions {
     forced: ForcedBackup;
     metadata?: Record<string, string | string[] | undefined>;
     folderName?: string;
+    /**
+     * Paths of submodules / embedded git repos whose state the bundle cannot
+     * reproduce: gitlinks changed within the backed-up range, or inner repos
+     * with commits/changes that exist only on the volume. When non-empty the
+     * backup is restorable for the outer repo but must not be treated as
+     * deletion-safe.
+     */
+    changedSubmodules?: string[];
 }
 export interface RecordScreenshotOptions {
     projectId: string;