@builder.io/ai-utils 0.84.0 → 0.85.0

package/package.json

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

package/src/events.d.ts

@@ -1300,7 +1300,34 @@ export declare const McpPrototypePulledV1: {
     eventName: "mcp.prototype.pulled";
     version: "1";
 };
-export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | ClientDevtoolsBuildMigratedV1 | ClientDevtoolsBuildCompletedV1 | ClientDevtoolsBuildUploadedV1 | ClientDevtoolsBuildFailedV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | TimelineRecordingReadyV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionGitHubExternalPrV1 | BotMentionGitHubInternalPrV1 | BotMentionGitLabPrV1 | BotMentionBitbucketPrV1 | BotMentionAzurePrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | FigmaDecodeJobV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1 | McpPrototypePulledV1;
+export type HostingCustomDomainCertCheckV1 = FusionEventVariant<"hosting.custom-domain.cert-check", {
+    domain: string;
+    projectId: string;
+    certId: string;
+    attemptId: string;
+    startedAtMs: number;
+    timeoutMs: number;
+}, {
+    projectId: string;
+}, 1>;
+export declare const HostingCustomDomainCertCheckV1: {
+    eventName: "hosting.custom-domain.cert-check";
+    version: "1";
+};
+export type HostingCustomDomainDelegationCheckV1 = FusionEventVariant<"hosting.custom-domain.delegation-check", {
+    domain: string;
+    projectId: string;
+    attemptId: string;
+    startedAtMs: number;
+    timeoutMs: number;
+}, {
+    projectId: string;
+}, 1>;
+export declare const HostingCustomDomainDelegationCheckV1: {
+    eventName: "hosting.custom-domain.delegation-check";
+    version: "1";
+};
+export type FusionEvent = ClientDevtoolsSessionStartedEvent | ClientDevtoolsSessionIdleEventV1 | ClientDevtoolsToolCallRequestV1 | ClientDevtoolsToolCallV1 | ClientDevtoolsToolResultV1 | ClientDevtoolsBuildMigratedV1 | ClientDevtoolsBuildCompletedV1 | ClientDevtoolsBuildUploadedV1 | ClientDevtoolsBuildFailedV1 | FusionProjectCreatedV1 | SetupAgentCompletedV1 | GitPrMergedV1 | GitPrCreatedV1 | GitPrClosedV1 | ForceSetupAgentV1 | ClawMessageSentV1 | CodegenCompletionV1 | CodegenUserPromptV1 | GitWebhooksRegisterV1 | FusionProjectSettingsUpdatedV1 | VideoRecordingCompletedV1 | TimelineRecordingReadyV1 | FusionBranchCreatedV1 | FusionContainerStartedV1 | FusionContainerFailedV1 | FusionBranchFailedV1 | BotMentionGitHubExternalPrV1 | BotMentionGitHubInternalPrV1 | BotMentionGitLabPrV1 | BotMentionBitbucketPrV1 | BotMentionAzurePrV1 | ReviewSubmittedV1 | PrReviewRequestedV1 | FigmaDecodeJobV1 | ProjectSnapshotRefreshV1 | ProjectSnapshotCapturedV1 | ProjectSnapshotCreatedV1 | ProjectSnapshotFailedV1 | ProjectSnapshotReadyCheckV1 | ProjectSnapshotPodWatchV1 | McpPrototypePulledV1 | HostingCustomDomainCertCheckV1 | HostingCustomDomainDelegationCheckV1;
 export interface ModelPermissionRequiredEvent {
     type: "assistant.model.permission.required";
     data: {

package/src/events.js

@@ -162,3 +162,11 @@ export const McpPrototypePulledV1 = {
     eventName: "mcp.prototype.pulled",
     version: "1",
 };
+export const HostingCustomDomainCertCheckV1 = {
+    eventName: "hosting.custom-domain.cert-check",
+    version: "1",
+};
+export const HostingCustomDomainDelegationCheckV1 = {
+    eventName: "hosting.custom-domain.delegation-check",
+    version: "1",
+};

package/src/projects.d.ts

@@ -1490,9 +1490,8 @@ export declare const ProjectHostingSchema: z.ZodObject<{
         uploading: "uploading";
     }>>;
     publishedCommit: z.ZodOptional<z.ZodString>;
-    customDomain: z.ZodOptional<z.ZodString>;
-    customDomainVerified: z.ZodOptional<z.ZodBoolean>;
     autoDeploy: z.ZodOptional<z.ZodBoolean>;
+    domainIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
 export type ProjectHosting = z.infer<typeof ProjectHostingSchema>;
 /**
@@ -1711,6 +1710,125 @@ export declare const GetDeploysResponseSchema: z.ZodObject<{
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type GetDeploysResponse = z.infer<typeof GetDeploysResponseSchema>;
+export declare const HostingDomainStatusSchema: z.ZodEnum<{
+    active: "active";
+    failed: "failed";
+    pending: "pending";
+    provisioning: "provisioning";
+    verifying: "verifying";
+}>;
+export type HostingDomainStatus = z.infer<typeof HostingDomainStatusSchema>;
+export declare const HostingDomainKindSchema: z.ZodEnum<{
+    apex: "apex";
+    subdomain: "subdomain";
+}>;
+export type HostingDomainKind = z.infer<typeof HostingDomainKindSchema>;
+/**
+ * Custom domain record. The same shape backs two Firestore collections:
+ *
+ * - Lock doc `hosting-domains/{domain}` is the single exclusive owner. It
+ *   exists only once a project reaches `provisioning`/`active` (cert + route
+ *   created, DNS ownership proven) and is the cross-project serialization
+ *   point serving/deploy/unpublish read to answer "is this verified?".
+ *   `certId`/`certMapEntryName`/`httpRouteName`/`verifiedAt` are only ever
+ *   populated here.
+ * - Claim subdoc `hosting-domains/{domain}/claims/{projectId}` is a
+ *   non-exclusive, per-project verification attempt (`pending`/`verifying`/
+ *   `failed`). Multiple projects can hold a claim on the same domain at once;
+ *   whoever proves DNS ownership first wins the lock and the losers are swept
+ *   to `failed`.
+ *
+ * The normalized domain is the doc key — global uniqueness comes for free.
+ */
+export declare const HostingDomainSchema: z.ZodObject<{
+    domain: z.ZodString;
+    kind: z.ZodEnum<{
+        apex: "apex";
+        subdomain: "subdomain";
+    }>;
+    projectId: z.ZodString;
+    ownerId: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        failed: "failed";
+        pending: "pending";
+        provisioning: "provisioning";
+        verifying: "verifying";
+    }>;
+    dnsAuthId: z.ZodString;
+    delegationTarget: z.ZodString;
+    trafficTarget: z.ZodOptional<z.ZodString>;
+    certId: z.ZodOptional<z.ZodString>;
+    certMapEntryName: z.ZodOptional<z.ZodString>;
+    httpRouteName: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNumber;
+    pendingSince: z.ZodNumber;
+    verifyingSince: z.ZodOptional<z.ZodNumber>;
+    attemptId: z.ZodOptional<z.ZodString>;
+    verifiedAt: z.ZodOptional<z.ZodNumber>;
+    error: z.ZodOptional<z.ZodString>;
+    failedStep: z.ZodOptional<z.ZodEnum<{
+        dns: "dns";
+        https: "https";
+    }>>;
+    createdBy: z.ZodString;
+}, z.core.$strip>;
+export type HostingDomain = z.infer<typeof HostingDomainSchema>;
+export declare const AddDomainRequestSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    domain: z.ZodString;
+}, z.core.$strip>;
+export type AddDomainRequest = z.infer<typeof AddDomainRequestSchema>;
+export declare const AddDomainResponseSchema: z.ZodObject<{
+    domain: z.ZodString;
+    kind: z.ZodEnum<{
+        apex: "apex";
+        subdomain: "subdomain";
+    }>;
+    records: z.ZodObject<{
+        traffic: z.ZodObject<{
+            recordType: z.ZodEnum<{
+                A: "A";
+                CNAME: "CNAME";
+            }>;
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>;
+        validation: z.ZodObject<{
+            recordType: z.ZodEnum<{
+                A: "A";
+                CNAME: "CNAME";
+            }>;
+            name: z.ZodString;
+            value: z.ZodString;
+        }, z.core.$strip>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type AddDomainResponse = z.infer<typeof AddDomainResponseSchema>;
+export declare const VerifyDomainRequestSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    domain: z.ZodString;
+}, z.core.$strip>;
+export type VerifyDomainRequest = z.infer<typeof VerifyDomainRequestSchema>;
+export declare const VerifyDomainResponseSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        active: "active";
+        failed: "failed";
+        pending: "pending";
+        provisioning: "provisioning";
+        verifying: "verifying";
+    }>;
+}, z.core.$strip>;
+export type VerifyDomainResponse = z.infer<typeof VerifyDomainResponseSchema>;
+export declare const RemoveDomainRequestSchema: z.ZodObject<{
+    projectId: z.ZodString;
+    domain: z.ZodString;
+}, z.core.$strip>;
+export type RemoveDomainRequest = z.infer<typeof RemoveDomainRequestSchema>;
+export declare const RemoveDomainResponseSchema: z.ZodObject<{
+    success: z.ZodLiteral<true>;
+}, z.core.$strip>;
+export type RemoveDomainResponse = z.infer<typeof RemoveDomainResponseSchema>;
 export declare const CloneProjectOptionsSchema: z.ZodObject<{
     sourceProjectId: z.ZodString;
     sourceBranchName: z.ZodDefault<z.ZodString>;

package/src/projects.js

@@ -324,12 +324,13 @@ export const ProjectHostingSchema = z.object({
     lastDeployStatus: DeployStatusSchema.optional(),
     /** Git commit currently live at the project's hosting URL (set on go-live). */
     publishedCommit: z.string().optional(),
-    customDomain: z.string().optional(),
-    customDomainVerified: z.boolean().optional(),
     autoDeploy: z
         .boolean()
         .optional()
         .meta({ description: "auto-deploy on push/merge" }),
+    domainIds: z.array(z.string()).optional().meta({
+        description: "Doc keys (normalized domains) in `hosting-domains` attached to this project. The domain docs are the source of truth; this is only the back-pointer.",
+    }),
 });
 /**
  * Canonical "is this project hostable" predicate. Keys off the explicit
@@ -615,6 +616,102 @@ export const GetDeploysRequestSchema = z.object({
 export const GetDeploysResponseSchema = z.object({
     deploys: z.array(DeployListItemSchema),
 });
+export const HostingDomainStatusSchema = z.enum([
+    "pending",
+    "verifying",
+    "provisioning",
+    "active",
+    "failed",
+]);
+export const HostingDomainKindSchema = z.enum(["apex", "subdomain"]);
+/**
+ * Custom domain record. The same shape backs two Firestore collections:
+ *
+ * - Lock doc `hosting-domains/{domain}` is the single exclusive owner. It
+ *   exists only once a project reaches `provisioning`/`active` (cert + route
+ *   created, DNS ownership proven) and is the cross-project serialization
+ *   point serving/deploy/unpublish read to answer "is this verified?".
+ *   `certId`/`certMapEntryName`/`httpRouteName`/`verifiedAt` are only ever
+ *   populated here.
+ * - Claim subdoc `hosting-domains/{domain}/claims/{projectId}` is a
+ *   non-exclusive, per-project verification attempt (`pending`/`verifying`/
+ *   `failed`). Multiple projects can hold a claim on the same domain at once;
+ *   whoever proves DNS ownership first wins the lock and the losers are swept
+ *   to `failed`.
+ *
+ * The normalized domain is the doc key — global uniqueness comes for free.
+ */
+export const HostingDomainSchema = z.object({
+    domain: z
+        .string()
+        .meta({ description: "Doc key — normalized (punycode) domain." }),
+    kind: HostingDomainKindSchema,
+    projectId: z.string(),
+    ownerId: z.string(),
+    status: HostingDomainStatusSchema,
+    dnsAuthId: z
+        .string()
+        .meta({ description: "GCP DNS authorization resource name." }),
+    delegationTarget: z.string().meta({
+        description: "_acme-challenge CNAME value the customer must add.",
+    }),
+    trafficTarget: z.string().optional().meta({
+        description: "The traffic record value: ALB anycast IP for apex domains, `cname.builder.cloud` for subdomains. Persisted so the UI can reconstruct both DNS records after page reload.",
+    }),
+    certId: z
+        .string()
+        .optional()
+        .meta({ description: "Certificate Manager cert resource name." }),
+    certMapEntryName: z.string().optional(),
+    httpRouteName: z.string().optional(),
+    createdAt: z.number(),
+    pendingSince: z.number().meta({
+        description: "TTL anchor: set on entering `pending`, re-stamped on `failed`→`pending`.",
+    }),
+    verifyingSince: z.number().optional().meta({
+        description: "Set when the delegation-check poll loop starts (on entering `verifying`). Used for the poll timeout and UI. Cleared on promotion to `provisioning` or on failure.",
+    }),
+    attemptId: z.string().optional().meta({
+        description: "Per-verify-attempt nonce, set on entering `verifying`. Delegation-check polls whose attemptId no longer matches are stale (a newer retry superseded them) and stop early.",
+    }),
+    verifiedAt: z.number().optional(),
+    error: z.string().optional(),
+    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.",
+    }),
+    createdBy: z.string(),
+});
+export const AddDomainRequestSchema = z.object({
+    projectId: z.string(),
+    domain: z.string(),
+});
+const DnsRecordSchema = z.object({
+    recordType: z.enum(["A", "CNAME"]),
+    name: z.string(),
+    value: z.string(),
+});
+export const AddDomainResponseSchema = z.object({
+    domain: z.string(),
+    kind: HostingDomainKindSchema,
+    records: z.object({
+        traffic: DnsRecordSchema,
+        validation: DnsRecordSchema,
+    }),
+});
+export const VerifyDomainRequestSchema = z.object({
+    projectId: z.string(),
+    domain: z.string(),
+});
+export const VerifyDomainResponseSchema = z.object({
+    status: HostingDomainStatusSchema,
+});
+export const RemoveDomainRequestSchema = z.object({
+    projectId: z.string(),
+    domain: z.string(),
+});
+export const RemoveDomainResponseSchema = z.object({
+    success: z.literal(true),
+});
 export const CloneProjectOptionsSchema = z.object({
     sourceProjectId: z.string().min(1).meta({
         description: "Project to clone from.",