@builder.io/ai-utils 0.85.0-dev.202607231533.14c8ab346 → 0.85.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@builder.io/ai-utils",
-  "version": "0.85.0-dev.202607231533.14c8ab346",
+  "version": "0.85.1",
   "description": "Builder.io AI utils",
   "files": [
     "src"

package/src/organization.d.ts

@@ -450,6 +450,7 @@ interface Role {
 export interface Organization {
     name?: string;
     id?: string;
+    "@originId"?: string;
     createdDate?: number;
     intent?: string;
     ecommerceBackend?: string;

package/src/projects.d.ts

@@ -628,6 +628,70 @@ export interface NewBranch extends BranchSharedData, RequiredBranchSharedData {
  */
 export type Branch = NewBranch | LegacyBranch;
 export declare const checkIsNewBranch: (branch: Branch) => branch is NewBranch;
+/**
+ * Request options for `GET /projects/branches/list`. Owner/org scope comes from
+ * the authenticated request context; `ownerId` here is a superuser-only override.
+ */
+export declare const ListBranchesOptionsSchema: z.ZodObject<{
+    projectId: z.ZodOptional<z.ZodString>;
+    projectIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    kanbanColumn: z.ZodOptional<z.ZodEnum<{
+        archived: "archived";
+        "awaiting-feedback": "awaiting-feedback";
+        "in-progress": "in-progress";
+        "in-review": "in-review";
+        merged: "merged";
+    }>>;
+    states: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        active: "active";
+        archived: "archived";
+        deleted: "deleted";
+    }>>>;
+    includeHidden: z.ZodOptional<z.ZodBoolean>;
+    search: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        feature: "feature";
+        fix: "fix";
+        other: "other";
+        research: "research";
+    }>>>;
+    prStatus: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        closed: "closed";
+        draft: "draft";
+        merged: "merged";
+        none: "none";
+        open: "open";
+    }>>>;
+    createdBy: z.ZodOptional<z.ZodString>;
+    assignedTo: z.ZodOptional<z.ZodString>;
+    notYetReviewed: z.ZodOptional<z.ZodBoolean>;
+    showOnlyRepoConnected: z.ZodOptional<z.ZodBoolean>;
+    sortBy: z.ZodOptional<z.ZodEnum<{
+        alphabetical: "alphabetical";
+        dateCreated: "dateCreated";
+        recentlyUpdated: "recentlyUpdated";
+    }>>;
+    sortByLastActivity: z.ZodOptional<z.ZodBoolean>;
+    sortDirection: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+    ownerId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ListBranchesOptions = z.infer<typeof ListBranchesOptionsSchema>;
+/** Response body for the paginated branches list endpoint. */
+export interface ListBranchesResult {
+    branches: Branch[];
+    /** Opaque cursor to pass as `cursor` for the next page, or null when there is no next page. */
+    nextCursor: string | null;
+    hasNextPage: boolean;
+    /** Total number of branches matching the filters, across all pages. */
+    totalCount: number;
+    /** True when `totalCount` comes from the eventually-consistent Mongo index, so it may lag reality slightly. */
+    totalCountIsApproximate?: boolean;
+}
 export type CpuKind = "performance" | "standard" | "shared";
 export type MachineAutoStop = "stop" | "off" | "suspend";
 export interface ProjectRolePermissions {
@@ -1809,8 +1873,6 @@ export declare const HostingDomainSchema: z.ZodObject<{
         dns: "dns";
         https: "https";
     }>>;
-    routeError: z.ZodOptional<z.ZodString>;
-    routeErrorAt: z.ZodOptional<z.ZodNumber>;
     createdBy: z.ZodString;
 }, z.core.$strip>;
 export type HostingDomain = z.infer<typeof HostingDomainSchema>;
@@ -1869,22 +1931,6 @@ export declare const RemoveDomainResponseSchema: z.ZodObject<{
     success: z.ZodLiteral<true>;
 }, z.core.$strip>;
 export type RemoveDomainResponse = z.infer<typeof RemoveDomainResponseSchema>;
-export declare const RepairDomainRequestSchema: z.ZodObject<{
-    projectId: z.ZodString;
-    domain: z.ZodString;
-}, z.core.$strip>;
-export type RepairDomainRequest = z.infer<typeof RepairDomainRequestSchema>;
-export declare const RepairDomainResponseSchema: z.ZodObject<{
-    status: z.ZodEnum<{
-        active: "active";
-        failed: "failed";
-        pending: "pending";
-        provisioning: "provisioning";
-        verifying: "verifying";
-    }>;
-    routeError: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type RepairDomainResponse = z.infer<typeof RepairDomainResponseSchema>;
 export declare const CloneProjectOptionsSchema: z.ZodObject<{
     sourceProjectId: z.ZodString;
     sourceBranchName: z.ZodDefault<z.ZodString>;

package/src/projects.js

@@ -49,6 +49,91 @@ export const EXAMPLE_OR_STARTER_REPOS_URLS = EXAMPLE_OR_STARTER_REPOS.map((repo)
 export const checkIsNewBranch = (branch) => {
     return "projectId" in branch;
 };
+/**
+ * Request options for `GET /projects/branches/list`. Owner/org scope comes from
+ * the authenticated request context; `ownerId` here is a superuser-only override.
+ */
+export const ListBranchesOptionsSchema = z.object({
+    projectId: z.string().optional().meta({
+        description: "Filter to a single project. Omit to list all branches in the owner's org.",
+    }),
+    projectIds: z.array(z.string()).optional().meta({
+        description: "Filter to any of these projects, unioned with projectId.",
+    }),
+    kanbanColumn: z
+        .enum([
+        "in-progress",
+        "in-review",
+        "awaiting-feedback",
+        "merged",
+        "archived",
+    ])
+        .optional()
+        .meta({
+        description: "Kanban column to scope to. Derives column membership from state, PR url/status and reviewers, and overrides `states`.",
+    }),
+    states: z
+        .array(z.enum(["active", "deleted", "archived"]))
+        .optional()
+        .meta({
+        description: 'Lifecycle states to include. Defaults to ["active"]. Ignored when kanbanColumn is set.',
+    }),
+    includeHidden: z.boolean().optional().meta({
+        description: "Superuser-only; superusers see hidden branches by default and pass false to opt out. Ignored for non-superusers.",
+    }),
+    search: z.string().optional().meta({
+        description: "Case-insensitive substring match over friendlyName, name and description.",
+    }),
+    category: z
+        .array(z.enum(["feature", "fix", "research", "other"]))
+        .optional()
+        .meta({ description: "Filter by auto-assigned work category." }),
+    prStatus: z
+        .array(z.enum(["open", "draft", "merged", "closed", "none"]))
+        .optional()
+        .meta({
+        description: "Filter by derived PR status (none = no PR opened yet).",
+    }),
+    createdBy: z
+        .string()
+        .optional()
+        .meta({ description: "Only branches created by this user id." }),
+    assignedTo: z
+        .string()
+        .optional()
+        .meta({ description: "Only branches where this user id is a reviewer." }),
+    notYetReviewed: z.boolean().optional().meta({
+        description: "With assignedTo, exclude branches whose reviews already contain that user.",
+    }),
+    showOnlyRepoConnected: z.boolean().optional().meta({
+        description: "Exclude the default main branch and commit-mode branches.",
+    }),
+    sortBy: z
+        .enum(["recentlyUpdated", "alphabetical", "dateCreated"])
+        .optional()
+        .meta({
+        description: "Sort key. recentlyUpdated (default) sorts by lastUpdatedAt.",
+    }),
+    sortByLastActivity: z.boolean().optional().meta({
+        description: "When true, recentlyUpdated keys off lastActivityAt (falling back to lastUpdatedAt). Ignored for other sort keys.",
+    }),
+    sortDirection: z.enum(["asc", "desc"]).optional().meta({
+        description: "Defaults to desc for date sorts, asc for alphabetical.",
+    }),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .meta({ description: "Page size, clamped to 1–200. Defaults to 50." }),
+    cursor: z.string().optional().meta({
+        description: "Opaque pagination cursor from a prior response's nextCursor.",
+    }),
+    ownerId: z.string().optional().meta({
+        description: "Superuser-only: list branches for a different owner/org.",
+    }),
+});
 /** Grace period before scheduled Neon deletions run (reconciler + schedule APIs). */
 export const NEON_DELETION_GRACE_PERIOD_MS = 30 * 24 * 60 * 60 * 1000;
 /**
@@ -735,12 +820,6 @@ export const HostingDomainSchema = z.object({
     failedStep: z.enum(["dns", "https"]).optional().meta({
         description: "Which setup step failed, set alongside `status: failed` so the UI can attribute the failure. `dns` = delegation verification, `https` = cert/route provisioning.",
     }),
-    routeError: z.string().optional().meta({
-        description: "Non-fatal health signal on an otherwise verified (`provisioning`/`active`) domain: set when re-creating the Envoy HTTPRoute failed on republish, so the site's cert is valid but the custom domain has no live route (bare 404). `status` stays `active`; this drives a degraded banner + Fix action. Cleared once the route is recreated.",
-    }),
-    routeErrorAt: z.number().optional().meta({
-        description: "When `routeError` was last set.",
-    }),
     createdBy: z.string(),
 });
 export const AddDomainRequestSchema = z.object({
@@ -774,14 +853,6 @@ export const RemoveDomainRequestSchema = z.object({
 export const RemoveDomainResponseSchema = z.object({
     success: z.literal(true),
 });
-export const RepairDomainRequestSchema = z.object({
-    projectId: z.string(),
-    domain: z.string(),
-});
-export const RepairDomainResponseSchema = z.object({
-    status: HostingDomainStatusSchema,
-    routeError: z.string().optional(),
-});
 export const CloneProjectOptionsSchema = z.object({
     sourceProjectId: z.string().min(1).meta({
         description: "Project to clone from.",

package/src/acl-schema.d.ts

@@ -1,88 +0,0 @@
-import { z } from "zod";
-export declare const PermissionSchema: z.ZodEnum<{
-    list: "list";
-    read: "read";
-    write: "write";
-}>;
-export type Permission = z.infer<typeof PermissionSchema>;
-export declare const AclEntrySchema: z.ZodObject<{
-    action: z.ZodEnum<{
-        allow: "allow";
-        deny: "deny";
-    }>;
-    resource: z.ZodString;
-    permissions: z.ZodArray<z.ZodEnum<{
-        list: "list";
-        read: "read";
-        write: "write";
-    }>>;
-    description: z.ZodOptional<z.ZodString>;
-    principals: z.ZodOptional<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export type AclEntry = z.infer<typeof AclEntrySchema>;
-export declare const AclPolicySchema: z.ZodObject<{
-    secrets: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    entries: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        action: z.ZodEnum<{
-            allow: "allow";
-            deny: "deny";
-        }>;
-        resource: z.ZodString;
-        permissions: z.ZodArray<z.ZodEnum<{
-            list: "list";
-            read: "read";
-            write: "write";
-        }>>;
-        description: z.ZodOptional<z.ZodString>;
-        principals: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>>;
-    denyDescription: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
-export type AclPolicy = z.infer<typeof AclPolicySchema>;
-export declare const AclDenialSchema: z.ZodObject<{
-    kind: z.ZodEnum<{
-        "command-allowlist": "command-allowlist";
-        "command-security": "command-security";
-        "file-access": "file-access";
-    }>;
-    reason: z.ZodEnum<{
-        "deny-pattern-matched": "deny-pattern-matched";
-        "no-allow-match": "no-allow-match";
-        "security-policy": "security-policy";
-        "shell-metacharacter": "shell-metacharacter";
-    }>;
-    resource: z.ZodString;
-    command: z.ZodOptional<z.ZodString>;
-    permission: z.ZodOptional<z.ZodEnum<{
-        list: "list";
-        read: "read";
-        write: "write";
-    }>>;
-    policy: z.ZodOptional<z.ZodString>;
-    matchedPattern: z.ZodOptional<z.ZodString>;
-    matchedEntry: z.ZodOptional<z.ZodObject<{
-        action: z.ZodEnum<{
-            allow: "allow";
-            deny: "deny";
-        }>;
-        resource: z.ZodString;
-        permissions: z.ZodArray<z.ZodEnum<{
-            list: "list";
-            read: "read";
-            write: "write";
-        }>>;
-        description: z.ZodOptional<z.ZodString>;
-        principals: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>>;
-    message: z.ZodString;
-}, z.core.$strip>;
-export type AclDenial = z.infer<typeof AclDenialSchema>;
-export interface AccessResult {
-    allowed: boolean;
-    message: string;
-    matchedEntry?: AclEntry;
-    matchedPattern?: string;
-    reason?: "deny-pattern-matched" | "no-allow-match";
-    requestedResource?: string;
-    requestedPermission?: Permission;
-}

package/src/acl-schema.js

@@ -1,71 +0,0 @@
-import { z } from "zod";
-export const PermissionSchema = z
-    .enum(["read", "write", "list"])
-    .meta({ title: "Permission" });
-// One ACL rule
-export const AclEntrySchema = z
-    .object({
-    action: z
-        .enum(["allow", "deny"])
-        .meta({ description: "whether this rule allows or denies access" }),
-    resource: z
-        .string()
-        .meta({ description: "what — supports glob patterns like /files/*.txt" }),
-    permissions: z
-        .array(PermissionSchema)
-        .meta({ description: "actions this rule applies to" }),
-    description: z.string().optional().meta({
-        description: "custom message, in deny case, this is the error message. This will override denyDescription on AclPolicy if defined.",
-    }),
-    principals: z.array(z.string()).optional().meta({
-        description: "array of teams/roles this rule applies to (e.g., ['developer', 'admin'])",
-    }),
-})
-    .meta({ title: "AclEntry" });
-// A full ACL policy is just a list of rules
-export const AclPolicySchema = z
-    .object({
-    secrets: z.array(z.string()).optional(),
-    entries: z.array(AclEntrySchema).optional(),
-    denyDescription: z.string().optional().meta({
-        description: "Default message to use when a resource is denied access",
-    }),
-})
-    .meta({ title: "AclPolicy" });
-// Structured description of an ACL/policy denial. Travels with the tool result
-// so internal tools can show admins exactly which rule blocked a command/file,
-// and both UIs can render a distinct "blocked, did not run" treatment.
-export const AclDenialSchema = z
-    .object({
-    kind: z
-        .enum(["command-security", "command-allowlist", "file-access"])
-        .meta({ description: "which gate produced the denial" }),
-    reason: z
-        .enum([
-        "security-policy",
-        "deny-pattern-matched",
-        "no-allow-match",
-        "shell-metacharacter",
-    ])
-        .meta({ description: "why the denial happened" }),
-    resource: z.string().meta({
-        description: "the file path or command that was blocked",
-    }),
-    command: z.string().optional().meta({
-        description: "the full command, when the denial is command-related",
-    }),
-    permission: PermissionSchema.optional().meta({
-        description: "the requested permission, for file-access denials",
-    }),
-    policy: z.string().optional().meta({
-        description: "named security policy that matched, when applicable",
-    }),
-    matchedPattern: z.string().optional().meta({
-        description: "the glob/pattern that matched the resource or command",
-    }),
-    matchedEntry: AclEntrySchema.optional().meta({
-        description: "the full ACL entry that matched, for file-access denials",
-    }),
-    message: z.string().meta({ description: "human-readable explanation" }),
-})
-    .meta({ title: "AclDenial" });

package/src/vpc-peering.d.ts

@@ -1,49 +0,0 @@
-/** Fields common to all VPC connectivity types. */
-interface VpcConnectionBase {
-    id: string;
-    ownerId: string;
-    type: string;
-    gcpRegion: string;
-    customerDnsServers: string[];
-    proxyIp: string;
-    enabled: boolean;
-    createdAt: number;
-    updatedAt: number;
-}
-/** Traditional VPC Peering via bridge VPC. */
-export interface VpcGcpPeering extends VpcConnectionBase {
-    type: "gcp-peering";
-    gcpProjectId: string;
-    gcpNetworkName: string;
-    bridgeCidr: string;
-    importCustomRoutes: boolean;
-}
-/**
- * PSC Network Attachment — customer creates the network attachment in their VPC,
- * our proxy VM connects to it via a PSC interface on nic1.
- * No bridge VPC or bridge CIDR needed on our side.
- */
-export interface VpcGcpNetworkAttachment extends VpcConnectionBase {
-    type: "gcp-network-attachment";
-    gcpProjectId: string;
-    networkAttachmentName: string;
-}
-/** Discriminated union of all VPC connectivity types. */
-export type VpcPeering = VpcGcpPeering | VpcGcpNetworkAttachment;
-export interface CreateVpcGcpPeeringParams {
-    type: "gcp-peering";
-    gcpRegion: string;
-    gcpProjectId: string;
-    gcpNetworkName: string;
-    bridgeCidr: string;
-    customerDnsServers: string[];
-    importCustomRoutes?: boolean;
-}
-export interface CreateVpcGcpNetworkAttachmentParams {
-    type: "gcp-network-attachment";
-    gcpProjectId: string;
-    networkAttachmentName: string;
-    customerDnsServers: string[];
-}
-export type CreateVpcPeeringParams = CreateVpcGcpPeeringParams | CreateVpcGcpNetworkAttachmentParams;
-export {};

package/src/vpc-peering.js

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