@vcp-dev/contracts 0.6.10 → 0.7.0

package/dist/custom-domain.d.ts

@@ -1,263 +1,177 @@
 import { z } from "zod";
-export declare const CUSTOM_DOMAIN_STATUSES: readonly ["pending_dns", "active"];
-export declare const CUSTOM_DOMAIN_ENTITLEMENT_REQUIRED_ERROR_CODE: "CUSTOM_DOMAIN_ENTITLEMENT_REQUIRED";
-export declare const CustomDomainStatusSchema: z.ZodEnum<{
+/** The lifecycle observed by Cloud for one configured hostname. */
+export declare const DOMAIN_OBSERVED_STATUSES: readonly ["pending_dns", "active", "failed", "removing"];
+export declare const DomainObservedStatusSchema: z.ZodEnum<{
+    failed: "failed";
     pending_dns: "pending_dns";
     active: "active";
+    removing: "removing";
 }>;
-export type CustomDomainStatus = z.infer<typeof CustomDomainStatusSchema>;
-export declare const CustomDomainDnsRecordPurposeSchema: z.ZodEnum<{
-    unknown: "unknown";
-    ownershipVerification: "ownershipVerification";
-    certificateValidation: "certificateValidation";
+export type DomainObservedStatus = z.infer<typeof DomainObservedStatusSchema>;
+/** How Cloud routes traffic for a configured hostname. */
+export declare const DOMAIN_ROUTING_MODES: readonly ["serve_site", "redirect_301"];
+export declare const DomainRoutingModeSchema: z.ZodEnum<{
+    serve_site: "serve_site";
+    redirect_301: "redirect_301";
+}>;
+export type DomainRoutingMode = z.infer<typeof DomainRoutingModeSchema>;
+/** The reason a DNS record is required by Cloud. */
+export declare const DOMAIN_DNS_PURPOSES: readonly ["traffic", "ownership", "certificate_delegation"];
+export declare const DomainDnsPurposeSchema: z.ZodEnum<{
     traffic: "traffic";
+    ownership: "ownership";
+    certificate_delegation: "certificate_delegation";
 }>;
-export type CustomDomainDnsRecordPurpose = z.infer<typeof CustomDomainDnsRecordPurposeSchema>;
-export declare const CustomDomainDnsRecordStatusSchema: z.ZodEnum<{
+export type DomainDnsPurpose = z.infer<typeof DomainDnsPurposeSchema>;
+export declare const DOMAIN_DNS_VERIFICATION_STATUSES: readonly ["pending", "verified"];
+export declare const DomainDnsVerificationStatusSchema: z.ZodEnum<{
     pending: "pending";
-    matched: "matched";
+    verified: "verified";
 }>;
-export type CustomDomainDnsRecordStatus = z.infer<typeof CustomDomainDnsRecordStatusSchema>;
-export declare const CustomDomainDnsRecordSchema: z.ZodObject<{
-    id: z.ZodString;
-    type: z.ZodString;
-    name: z.ZodString;
-    value: z.ZodString;
+export type DomainDnsVerificationStatus = z.infer<typeof DomainDnsVerificationStatusSchema>;
+export declare const DomainOperationTypeSchema: z.ZodEnum<{
+    prepare_configuration: "prepare_configuration";
+    apply_configuration: "apply_configuration";
+    verify_dns: "verify_dns";
+}>;
+export type DomainOperationType = z.infer<typeof DomainOperationTypeSchema>;
+export declare const DomainOperationStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    succeeded: "succeeded";
+    accepted: "accepted";
+    running: "running";
+}>;
+export type DomainOperationStatus = z.infer<typeof DomainOperationStatusSchema>;
+export declare const DomainOperationErrorSchema: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+export type DomainOperationError = z.infer<typeof DomainOperationErrorSchema>;
+export declare const DomainDnsRecordSchema: z.ZodObject<{
     purpose: z.ZodEnum<{
-        unknown: "unknown";
-        ownershipVerification: "ownershipVerification";
-        certificateValidation: "certificateValidation";
         traffic: "traffic";
+        ownership: "ownership";
+        certificate_delegation: "certificate_delegation";
     }>;
-    required: z.ZodBoolean;
-    status: z.ZodOptional<z.ZodEnum<{
+    type: z.ZodString;
+    name: z.ZodString;
+    value: z.ZodString;
+    verificationStatus: z.ZodEnum<{
         pending: "pending";
-        matched: "matched";
-    }>>;
+        verified: "verified";
+    }>;
 }, z.core.$strict>;
-export type CustomDomainDnsRecord = z.infer<typeof CustomDomainDnsRecordSchema>;
-export declare const SiteCustomDomainSchema: z.ZodObject<{
+export type DomainDnsRecord = z.infer<typeof DomainDnsRecordSchema>;
+export declare const DomainRecordSchema: z.ZodObject<{
     id: z.ZodString;
-    domainId: z.ZodOptional<z.ZodString>;
     hostname: z.ZodString;
-    displayHostname: z.ZodString;
-    asciiHostname: z.ZodString;
-    status: z.ZodEnum<{
+    isPrimary: z.ZodBoolean;
+    routingMode: z.ZodEnum<{
+        serve_site: "serve_site";
+        redirect_301: "redirect_301";
+    }>;
+    observedStatus: z.ZodEnum<{
+        failed: "failed";
         pending_dns: "pending_dns";
         active: "active";
+        removing: "removing";
     }>;
-    isPrimary: z.ZodBoolean;
-    deletable: z.ZodBoolean;
+    lastVerifiedAt: z.ZodNullable<z.ZodString>;
     dnsRecords: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        type: z.ZodString;
-        name: z.ZodString;
-        value: z.ZodString;
         purpose: z.ZodEnum<{
-            unknown: "unknown";
-            ownershipVerification: "ownershipVerification";
-            certificateValidation: "certificateValidation";
             traffic: "traffic";
+            ownership: "ownership";
+            certificate_delegation: "certificate_delegation";
         }>;
-        required: z.ZodBoolean;
-        status: z.ZodOptional<z.ZodEnum<{
+        type: z.ZodString;
+        name: z.ZodString;
+        value: z.ZodString;
+        verificationStatus: z.ZodEnum<{
             pending: "pending";
-            matched: "matched";
-        }>>;
+            verified: "verified";
+        }>;
     }, z.core.$strict>>;
-    createdAt: z.ZodNullable<z.ZodString>;
-    checkedAt: z.ZodNullable<z.ZodString>;
-}, z.core.$strict>;
-export type SiteCustomDomain = z.infer<typeof SiteCustomDomainSchema>;
-export declare const DefaultPublishDomainSchema: z.ZodObject<{
-    hostname: z.ZodString;
-    url: z.ZodString;
-    status: z.ZodLiteral<"ready">;
 }, z.core.$strict>;
-export type DefaultPublishDomain = z.infer<typeof DefaultPublishDomainSchema>;
-export declare const ListSiteDomainsDataSchema: z.ZodObject<{
-    defaultDomain: z.ZodObject<{
-        hostname: z.ZodString;
-        url: z.ZodString;
-        status: z.ZodLiteral<"ready">;
-    }, z.core.$strict>;
-    currentDomain: z.ZodNullable<z.ZodObject<{
+export type DomainRecord = z.infer<typeof DomainRecordSchema>;
+export declare const DomainConfigurationSchema: z.ZodObject<{
+    primaryDomain: z.ZodNullable<z.ZodObject<{
         id: z.ZodString;
-        domainId: z.ZodOptional<z.ZodString>;
         hostname: z.ZodString;
-        displayHostname: z.ZodString;
-        asciiHostname: z.ZodString;
-        status: z.ZodEnum<{
+        isPrimary: z.ZodBoolean;
+        routingMode: z.ZodEnum<{
+            serve_site: "serve_site";
+            redirect_301: "redirect_301";
+        }>;
+        observedStatus: z.ZodEnum<{
+            failed: "failed";
             pending_dns: "pending_dns";
             active: "active";
+            removing: "removing";
         }>;
-        isPrimary: z.ZodBoolean;
-        deletable: z.ZodBoolean;
+        lastVerifiedAt: z.ZodNullable<z.ZodString>;
         dnsRecords: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            type: z.ZodString;
-            name: z.ZodString;
-            value: z.ZodString;
             purpose: z.ZodEnum<{
-                unknown: "unknown";
-                ownershipVerification: "ownershipVerification";
-                certificateValidation: "certificateValidation";
                 traffic: "traffic";
+                ownership: "ownership";
+                certificate_delegation: "certificate_delegation";
             }>;
-            required: z.ZodBoolean;
-            status: z.ZodOptional<z.ZodEnum<{
-                pending: "pending";
-                matched: "matched";
-            }>>;
-        }, z.core.$strict>>;
-        createdAt: z.ZodNullable<z.ZodString>;
-        checkedAt: z.ZodNullable<z.ZodString>;
-    }, z.core.$strict>>;
-    customDomains: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        domainId: z.ZodOptional<z.ZodString>;
-        hostname: z.ZodString;
-        displayHostname: z.ZodString;
-        asciiHostname: z.ZodString;
-        status: z.ZodEnum<{
-            pending_dns: "pending_dns";
-            active: "active";
-        }>;
-        isPrimary: z.ZodBoolean;
-        deletable: z.ZodBoolean;
-        dnsRecords: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
             type: z.ZodString;
             name: z.ZodString;
             value: z.ZodString;
-            purpose: z.ZodEnum<{
-                unknown: "unknown";
-                ownershipVerification: "ownershipVerification";
-                certificateValidation: "certificateValidation";
-                traffic: "traffic";
-            }>;
-            required: z.ZodBoolean;
-            status: z.ZodOptional<z.ZodEnum<{
+            verificationStatus: z.ZodEnum<{
                 pending: "pending";
-                matched: "matched";
-            }>>;
+                verified: "verified";
+            }>;
         }, z.core.$strict>>;
-        createdAt: z.ZodNullable<z.ZodString>;
-        checkedAt: z.ZodNullable<z.ZodString>;
     }, z.core.$strict>>;
-}, z.core.$strict>;
-export type ListSiteDomainsData = z.infer<typeof ListSiteDomainsDataSchema>;
-export declare const BindSiteDomainRequestSchema: z.ZodObject<{
-    hostname: z.ZodString;
-    isPrimary: z.ZodOptional<z.ZodBoolean>;
-}, z.core.$strict>;
-export type BindSiteDomainRequest = z.infer<typeof BindSiteDomainRequestSchema>;
-export declare const BindSiteDomainDataSchema: z.ZodObject<{
-    domain: z.ZodObject<{
+    redirectDomains: z.ZodArray<z.ZodObject<{
         id: z.ZodString;
-        domainId: z.ZodOptional<z.ZodString>;
         hostname: z.ZodString;
-        displayHostname: z.ZodString;
-        asciiHostname: z.ZodString;
-        status: z.ZodEnum<{
-            pending_dns: "pending_dns";
-            active: "active";
-        }>;
         isPrimary: z.ZodBoolean;
-        deletable: z.ZodBoolean;
-        dnsRecords: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            type: z.ZodString;
-            name: z.ZodString;
-            value: z.ZodString;
-            purpose: z.ZodEnum<{
-                unknown: "unknown";
-                ownershipVerification: "ownershipVerification";
-                certificateValidation: "certificateValidation";
-                traffic: "traffic";
-            }>;
-            required: z.ZodBoolean;
-            status: z.ZodOptional<z.ZodEnum<{
-                pending: "pending";
-                matched: "matched";
-            }>>;
-        }, z.core.$strict>>;
-        createdAt: z.ZodNullable<z.ZodString>;
-        checkedAt: z.ZodNullable<z.ZodString>;
-    }, z.core.$strict>;
-}, z.core.$strict>;
-export type BindSiteDomainData = z.infer<typeof BindSiteDomainDataSchema>;
-export declare const VerifySiteDomainDataSchema: z.ZodObject<{
-    domain: z.ZodObject<{
-        id: z.ZodString;
-        domainId: z.ZodOptional<z.ZodString>;
-        hostname: z.ZodString;
-        displayHostname: z.ZodString;
-        asciiHostname: z.ZodString;
-        status: z.ZodEnum<{
+        routingMode: z.ZodEnum<{
+            serve_site: "serve_site";
+            redirect_301: "redirect_301";
+        }>;
+        observedStatus: z.ZodEnum<{
+            failed: "failed";
             pending_dns: "pending_dns";
             active: "active";
+            removing: "removing";
         }>;
-        isPrimary: z.ZodBoolean;
-        deletable: z.ZodBoolean;
+        lastVerifiedAt: z.ZodNullable<z.ZodString>;
         dnsRecords: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            type: z.ZodString;
-            name: z.ZodString;
-            value: z.ZodString;
             purpose: z.ZodEnum<{
-                unknown: "unknown";
-                ownershipVerification: "ownershipVerification";
-                certificateValidation: "certificateValidation";
                 traffic: "traffic";
+                ownership: "ownership";
+                certificate_delegation: "certificate_delegation";
             }>;
-            required: z.ZodBoolean;
-            status: z.ZodOptional<z.ZodEnum<{
-                pending: "pending";
-                matched: "matched";
-            }>>;
-        }, z.core.$strict>>;
-        createdAt: z.ZodNullable<z.ZodString>;
-        checkedAt: z.ZodNullable<z.ZodString>;
-    }, z.core.$strict>;
-}, z.core.$strict>;
-export type VerifySiteDomainData = z.infer<typeof VerifySiteDomainDataSchema>;
-export declare const GetSiteDomainDetailDataSchema: z.ZodObject<{
-    domain: z.ZodObject<{
-        id: z.ZodString;
-        domainId: z.ZodOptional<z.ZodString>;
-        hostname: z.ZodString;
-        displayHostname: z.ZodString;
-        asciiHostname: z.ZodString;
-        status: z.ZodEnum<{
-            pending_dns: "pending_dns";
-            active: "active";
-        }>;
-        isPrimary: z.ZodBoolean;
-        deletable: z.ZodBoolean;
-        dnsRecords: z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
             type: z.ZodString;
             name: z.ZodString;
             value: z.ZodString;
-            purpose: z.ZodEnum<{
-                unknown: "unknown";
-                ownershipVerification: "ownershipVerification";
-                certificateValidation: "certificateValidation";
-                traffic: "traffic";
-            }>;
-            required: z.ZodBoolean;
-            status: z.ZodOptional<z.ZodEnum<{
+            verificationStatus: z.ZodEnum<{
                 pending: "pending";
-                matched: "matched";
-            }>>;
+                verified: "verified";
+            }>;
         }, z.core.$strict>>;
-        createdAt: z.ZodNullable<z.ZodString>;
-        checkedAt: z.ZodNullable<z.ZodString>;
-    }, z.core.$strict>;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
-export type GetSiteDomainDetailData = z.infer<typeof GetSiteDomainDetailDataSchema>;
-export declare const DeleteSiteDomainDataSchema: z.ZodObject<{
-    deleted: z.ZodBoolean;
+export type DomainConfiguration = z.infer<typeof DomainConfigurationSchema>;
+export declare const DomainOperationSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        prepare_configuration: "prepare_configuration";
+        apply_configuration: "apply_configuration";
+        verify_dns: "verify_dns";
+    }>;
+    status: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        accepted: "accepted";
+        running: "running";
+    }>;
+    error: z.ZodNullable<z.ZodObject<{
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strict>>;
 }, z.core.$strict>;
-export type DeleteSiteDomainData = z.infer<typeof DeleteSiteDomainDataSchema>;
+export type DomainOperation = z.infer<typeof DomainOperationSchema>;

package/dist/customer-materials.d.ts

@@ -0,0 +1,196 @@
+import { z } from "zod";
+/** The structured facts collected by the no-website Launcher step. */
+export declare const CustomerMaterialsDraftSchema: z.ZodObject<{
+    company_name: z.ZodString;
+    brand_name: z.ZodString;
+    primary_products: z.ZodString;
+    industry: z.ZodString;
+    applications: z.ZodString;
+    business_summary: z.ZodString;
+    registered_capital: z.ZodDefault<z.ZodString>;
+    legal_representative: z.ZodDefault<z.ZodString>;
+    target_markets: z.ZodArray<z.ZodString>;
+    customer_industries: z.ZodString;
+    customer_roles: z.ZodString;
+    buying_scenarios: z.ZodString;
+    differentiators: z.ZodString;
+    competitors: z.ZodString;
+    trust_proof: z.ZodString;
+    customer_cases: z.ZodString;
+    channels: z.ZodArray<z.ZodString>;
+    expected_domain: z.ZodString;
+    brand_tone: z.ZodString;
+    contact_name: z.ZodString;
+    contact_info: z.ZodString;
+    timezone: z.ZodString;
+    launch_timing: z.ZodString;
+    input_source_ids: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type CustomerMaterialsDraft = z.infer<typeof CustomerMaterialsDraftSchema>;
+export declare const CustomerMaterialsStatusSchema: z.ZodEnum<{
+    draft: "draft";
+    submitted: "submitted";
+}>;
+export type CustomerMaterialsStatus = z.infer<typeof CustomerMaterialsStatusSchema>;
+export declare const CustomerMaterialsRecordSchema: z.ZodObject<{
+    company_name: z.ZodString;
+    brand_name: z.ZodString;
+    primary_products: z.ZodString;
+    industry: z.ZodString;
+    applications: z.ZodString;
+    business_summary: z.ZodString;
+    registered_capital: z.ZodDefault<z.ZodString>;
+    legal_representative: z.ZodDefault<z.ZodString>;
+    target_markets: z.ZodArray<z.ZodString>;
+    customer_industries: z.ZodString;
+    customer_roles: z.ZodString;
+    buying_scenarios: z.ZodString;
+    differentiators: z.ZodString;
+    competitors: z.ZodString;
+    trust_proof: z.ZodString;
+    customer_cases: z.ZodString;
+    channels: z.ZodArray<z.ZodString>;
+    expected_domain: z.ZodString;
+    brand_tone: z.ZodString;
+    contact_name: z.ZodString;
+    contact_info: z.ZodString;
+    timezone: z.ZodString;
+    launch_timing: z.ZodString;
+    input_source_ids: z.ZodArray<z.ZodString>;
+    id: z.ZodUUID;
+    tenant_id: z.ZodString;
+    site_id: z.ZodUUID;
+    workflow_id: z.ZodUUID;
+    status: z.ZodEnum<{
+        draft: "draft";
+        submitted: "submitted";
+    }>;
+    submitted_at: z.ZodNullable<z.ZodString>;
+    created_at: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strict>;
+export type CustomerMaterialsRecord = z.infer<typeof CustomerMaterialsRecordSchema>;
+export declare const CustomerMaterialsResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    data: z.ZodObject<{
+        company_name: z.ZodString;
+        brand_name: z.ZodString;
+        primary_products: z.ZodString;
+        industry: z.ZodString;
+        applications: z.ZodString;
+        business_summary: z.ZodString;
+        registered_capital: z.ZodDefault<z.ZodString>;
+        legal_representative: z.ZodDefault<z.ZodString>;
+        target_markets: z.ZodArray<z.ZodString>;
+        customer_industries: z.ZodString;
+        customer_roles: z.ZodString;
+        buying_scenarios: z.ZodString;
+        differentiators: z.ZodString;
+        competitors: z.ZodString;
+        trust_proof: z.ZodString;
+        customer_cases: z.ZodString;
+        channels: z.ZodArray<z.ZodString>;
+        expected_domain: z.ZodString;
+        brand_tone: z.ZodString;
+        contact_name: z.ZodString;
+        contact_info: z.ZodString;
+        timezone: z.ZodString;
+        launch_timing: z.ZodString;
+        input_source_ids: z.ZodArray<z.ZodString>;
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        workflow_id: z.ZodUUID;
+        status: z.ZodEnum<{
+            draft: "draft";
+            submitted: "submitted";
+        }>;
+        submitted_at: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strict>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type CustomerMaterialsResponse = z.infer<typeof CustomerMaterialsResponseSchema>;
+export declare const CustomerMaterialsDraftResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    data: z.ZodObject<{
+        company_name: z.ZodString;
+        brand_name: z.ZodString;
+        primary_products: z.ZodString;
+        industry: z.ZodString;
+        applications: z.ZodString;
+        business_summary: z.ZodString;
+        registered_capital: z.ZodDefault<z.ZodString>;
+        legal_representative: z.ZodDefault<z.ZodString>;
+        target_markets: z.ZodArray<z.ZodString>;
+        customer_industries: z.ZodString;
+        customer_roles: z.ZodString;
+        buying_scenarios: z.ZodString;
+        differentiators: z.ZodString;
+        competitors: z.ZodString;
+        trust_proof: z.ZodString;
+        customer_cases: z.ZodString;
+        channels: z.ZodArray<z.ZodString>;
+        expected_domain: z.ZodString;
+        brand_tone: z.ZodString;
+        contact_name: z.ZodString;
+        contact_info: z.ZodString;
+        timezone: z.ZodString;
+        launch_timing: z.ZodString;
+        input_source_ids: z.ZodArray<z.ZodString>;
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        workflow_id: z.ZodUUID;
+        status: z.ZodEnum<{
+            draft: "draft";
+            submitted: "submitted";
+        }>;
+        submitted_at: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strict>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export declare const CustomerMaterialsNullableResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    data: z.ZodNullable<z.ZodObject<{
+        company_name: z.ZodString;
+        brand_name: z.ZodString;
+        primary_products: z.ZodString;
+        industry: z.ZodString;
+        applications: z.ZodString;
+        business_summary: z.ZodString;
+        registered_capital: z.ZodDefault<z.ZodString>;
+        legal_representative: z.ZodDefault<z.ZodString>;
+        target_markets: z.ZodArray<z.ZodString>;
+        customer_industries: z.ZodString;
+        customer_roles: z.ZodString;
+        buying_scenarios: z.ZodString;
+        differentiators: z.ZodString;
+        competitors: z.ZodString;
+        trust_proof: z.ZodString;
+        customer_cases: z.ZodString;
+        channels: z.ZodArray<z.ZodString>;
+        expected_domain: z.ZodString;
+        brand_tone: z.ZodString;
+        contact_name: z.ZodString;
+        contact_info: z.ZodString;
+        timezone: z.ZodString;
+        launch_timing: z.ZodString;
+        input_source_ids: z.ZodArray<z.ZodString>;
+        id: z.ZodUUID;
+        tenant_id: z.ZodString;
+        site_id: z.ZodUUID;
+        workflow_id: z.ZodUUID;
+        status: z.ZodEnum<{
+            draft: "draft";
+            submitted: "submitted";
+        }>;
+        submitted_at: z.ZodNullable<z.ZodString>;
+        created_at: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strict>>;
+    message: z.ZodString;
+}, z.core.$strip>;

package/dist/deployment-lifecycle.d.ts

@@ -0,0 +1,45 @@
+import { DEPLOYMENT_STATUSES } from "./deployment-runtime.js";
+export type DeploymentLifecycleStatus = (typeof DEPLOYMENT_STATUSES)[number];
+/**
+ * The single production contract for durable deployment status transitions.
+ *
+ * `deploy_failed` is the generic terminal failure used by the executor's
+ * unexpected-error path and by the expired-lease sweeper, so every active
+ * phase may enter it. Phase-specific failures remain restricted to the phase
+ * that owns them. `cleanup_failed` is retained as a legacy terminal database
+ * value; current cleanup failures are warnings and never rewrite `released`.
+ */
+export declare const DEPLOYMENT_LIFECYCLE_TRANSITIONS: {
+    readonly queued: readonly ["preparing_source", "lock_failed", "deploy_failed"];
+    readonly preparing_source: readonly ["building", "source_prepare_failed", "deploy_failed"];
+    readonly building: readonly ["artifact_ready", "build_failed", "artifact_fetch_failed", "artifact_validation_failed", "deploy_failed"];
+    readonly artifact_ready: readonly ["deploying", "deploy_failed"];
+    readonly deploying: readonly ["released", "deploy_failed"];
+    readonly released: readonly [];
+    readonly lock_failed: readonly [];
+    readonly source_prepare_failed: readonly [];
+    readonly build_failed: readonly [];
+    readonly artifact_fetch_failed: readonly [];
+    readonly artifact_validation_failed: readonly [];
+    readonly deploy_failed: readonly [];
+    readonly cleanup_failed: readonly [];
+};
+export declare const DEPLOYMENT_ACTIVE_STATUSES: readonly DeploymentLifecycleStatus[];
+export declare const DEPLOYMENT_TERMINAL_STATUSES: readonly DeploymentLifecycleStatus[];
+export declare const DEPLOYMENT_TRANSITION_ERROR_CODE: "DEPLOYMENT_TRANSITION_INVALID";
+export declare class DeploymentTransitionError extends Error {
+    readonly currentStatus: DeploymentLifecycleStatus;
+    readonly nextStatus: DeploymentLifecycleStatus;
+    readonly code: "DEPLOYMENT_TRANSITION_INVALID";
+    constructor(currentStatus: DeploymentLifecycleStatus, nextStatus: DeploymentLifecycleStatus);
+}
+export declare function getDeploymentTransitionTargets(currentStatus: DeploymentLifecycleStatus): readonly DeploymentLifecycleStatus[];
+export declare function getDeploymentTransitionPredecessors(nextStatus: DeploymentLifecycleStatus): readonly DeploymentLifecycleStatus[];
+export declare function isDeploymentActiveStatus(status: DeploymentLifecycleStatus): boolean;
+export declare function isDeploymentTerminalStatus(status: DeploymentLifecycleStatus): boolean;
+export declare function assertDeploymentTransition(currentStatus: DeploymentLifecycleStatus, nextStatus: DeploymentLifecycleStatus): DeploymentLifecycleStatus;
+/**
+ * Returns the official transitions after `queued` for deterministic workers.
+ * Consumers must still persist each transition through the shared validator.
+ */
+export declare function getDeploymentHappyPathTransitions(): readonly DeploymentLifecycleStatus[];

package/dist/deployment-progress.d.ts

@@ -0,0 +1,51 @@
+import { z } from "zod";
+export declare const DEPLOYMENT_PROGRESS_STEP_CODES: readonly ["deployment_queued", "prepare_source", "build_artifact", "publish_site", "site_released", "cleanup_release"];
+export declare const DeploymentProgressStepCodeSchema: z.ZodEnum<{
+    deployment_queued: "deployment_queued";
+    prepare_source: "prepare_source";
+    build_artifact: "build_artifact";
+    publish_site: "publish_site";
+    site_released: "site_released";
+    cleanup_release: "cleanup_release";
+}>;
+export type DeploymentProgressStepCode = z.infer<typeof DeploymentProgressStepCodeSchema>;
+export declare const DeploymentProgressStepStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    succeeded: "succeeded";
+    running: "running";
+}>;
+export type DeploymentProgressStepStatus = z.infer<typeof DeploymentProgressStepStatusSchema>;
+export declare const DeploymentProgressStepSchema: z.ZodObject<{
+    code: z.ZodEnum<{
+        deployment_queued: "deployment_queued";
+        prepare_source: "prepare_source";
+        build_artifact: "build_artifact";
+        publish_site: "publish_site";
+        site_released: "site_released";
+        cleanup_release: "cleanup_release";
+    }>;
+    status: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        running: "running";
+    }>;
+    message: z.ZodString;
+}, z.core.$strict>;
+export type DeploymentProgressStep = z.infer<typeof DeploymentProgressStepSchema>;
+export declare const DeploymentProgressStepsSchema: z.ZodArray<z.ZodObject<{
+    code: z.ZodEnum<{
+        deployment_queued: "deployment_queued";
+        prepare_source: "prepare_source";
+        build_artifact: "build_artifact";
+        publish_site: "publish_site";
+        site_released: "site_released";
+        cleanup_release: "cleanup_release";
+    }>;
+    status: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+        running: "running";
+    }>;
+    message: z.ZodString;
+}, z.core.$strict>>;
+export type DeploymentProgressSteps = z.infer<typeof DeploymentProgressStepsSchema>;