@builder.io/ai-utils 0.12.20 → 0.12.21

package/package.json

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

package/src/projects.d.ts

@@ -276,7 +276,8 @@ export interface PartialBranchData {
         branchName: string;
     };
 }
-export interface Branch {
+export type EntityState = "active" | "deleted";
+interface BranchSharedData {
     lockedFusionEnvironment?: FusionExecutionEnvironment;
     id?: string;
     appName?: string | null;
@@ -310,13 +311,15 @@ export interface Branch {
         address: string | null;
         allocated: boolean | null;
     } | null;
-    preRecoveryData?: Partial<Branch> & {
-        recoveryDate: Date;
-    };
     backup?: BranchBackup;
     metadata?: Record<string, unknown>;
     needsCleanup?: boolean;
+    /** The state of the branch. Use `isBranchDeleted()` helper for backwards-compatible checks. */
+    state?: EntityState;
+    /** @deprecated Use `state` field instead. Kept for backwards compatibility. */
     deleted?: boolean;
+    deletedAt?: string;
+    deletedBy?: string;
     updatedAt?: string;
     commitMode?: CommitMode;
     kubePodName?: string | null;
@@ -325,6 +328,33 @@ export interface Branch {
     kubeHostname?: string | null;
     checkoutBranch?: string | null;
 }
+/**
+ * LegacyBranch represents branch data as stored in the nested project.branches field.
+ * This type does NOT include projectId or legacyId as those don't exist in the legacy format.
+ */
+export interface LegacyBranch extends BranchSharedData {
+    preRecoveryData?: Partial<LegacyBranch> & {
+        recoveryDate: Date;
+    };
+}
+/**
+ * NewBranch represents branch data as stored in the standalone branches collection.
+ * Extends LegacyBranch with required projectId, name, and optional legacyId fields.
+ */
+export interface NewBranch extends BranchSharedData {
+    /** The project this branch belongs to */
+    projectId: string;
+    /** The branch name (required in new collection) */
+    name: string;
+    /** Legacy ID for mapping to project.branches[branchName] format: ${projectId}-${branchName} */
+    legacyId: string;
+}
+/**
+ * Branch is a union type that can represent either a legacy branch or a new branch.
+ * Use this type when you need to handle branches from either source.
+ */
+export type Branch = NewBranch | LegacyBranch;
+export declare const checkIsNewBranch: (branch: Branch) => branch is NewBranch;
 export type CpuKind = "performance" | "standard" | "shared";
 export type MachineAutoStop = "stop" | "off" | "suspend";
 export interface ProjectRolePermissions {
@@ -445,7 +475,27 @@ export interface Project {
     isFromUserTemplate?: boolean;
     templateId?: string | null;
     localPath?: string | null;
+    /** The state of the project. Use `isProjectDeleted()` helper for backwards-compatible checks. */
+    state?: EntityState;
+    deletedAt?: string;
+    deletedBy?: string;
 }
+/**
+ * Get the state of a branch, checking `state` first and falling back to `deleted` for backwards compatibility.
+ */
+export declare const getBranchState: (branch: Branch) => EntityState;
+/**
+ * Get the state of a project, checking `state` first and falling back to `deleted` for backwards compatibility.
+ */
+export declare const getProjectState: (project: Project) => EntityState;
+/**
+ * Check if a branch is deleted, supporting both `state` and legacy `deleted` fields.
+ */
+export declare const isBranchDeleted: (branch: Branch) => boolean;
+/**
+ * Check if a project is deleted, supporting both `state` and legacy `deleted` fields.
+ */
+export declare const isProjectDeleted: (project: Project) => boolean;
 export interface ProjectWithBranches extends Project {
     branches: Record<string, Branch>;
 }

package/src/projects.js

@@ -10,3 +10,33 @@ export const EXAMPLE_REPOS = [
 export const STARTER_REPO = "BuilderIO/fusion-starter";
 export const EXAMPLE_OR_STARTER_REPOS = [...EXAMPLE_REPOS, STARTER_REPO];
 export const EXAMPLE_OR_STARTER_REPOS_URLS = EXAMPLE_OR_STARTER_REPOS.map((repo) => `https://github.com/${repo}`);
+export const checkIsNewBranch = (branch) => {
+    return "projectId" in branch;
+};
+/**
+ * Get the state of a branch, checking `state` first and falling back to `deleted` for backwards compatibility.
+ */
+export const getBranchState = (branch) => {
+    if (branch.state)
+        return branch.state;
+    return branch.deleted ? "deleted" : "active";
+};
+/**
+ * Get the state of a project, checking `state` first and falling back to `deleted` for backwards compatibility.
+ */
+export const getProjectState = (project) => {
+    var _a;
+    return (_a = project.state) !== null && _a !== void 0 ? _a : "active";
+};
+/**
+ * Check if a branch is deleted, supporting both `state` and legacy `deleted` fields.
+ */
+export const isBranchDeleted = (branch) => {
+    return getBranchState(branch) === "deleted";
+};
+/**
+ * Check if a project is deleted, supporting both `state` and legacy `deleted` fields.
+ */
+export const isProjectDeleted = (project) => {
+    return getProjectState(project) === "deleted";
+};