@vcp-dev/contracts 0.6.11 → 0.7.0

package/dist/site-extra-requirement.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+/**
+ * 整站补充需求：用户在 Step5 十一张卡下面自己写的一段话。
+ *
+ * 为什么放在 Step5 底部：它要影响有哪些页面，而页面由 sitemap 决定，sitemap 在
+ * 用户落到结构规划页的那一刻就自动开始生成，中间没有任何停顿 —— 离开 Step5 就
+ * 来不及。也因此它不是卡内备注：卡内备注各限 200 字、只管那张卡的范围。
+ *
+ * 优先级：低于十一张卡已拍板的策略（那是用户逐项确认过的结论），高于单张卡的
+ * 备注。原样透传，不做任何字符串替换、截断关键词或正则规整。
+ */
+export declare const SITE_EXTRA_REQUIREMENT_MAX_LENGTH = 2000;
+export declare const SiteExtraRequirementSchema: z.ZodObject<{
+    note: z.ZodString;
+    updated_at: z.ZodString;
+}, z.core.$strict>;
+export type SiteExtraRequirement = z.infer<typeof SiteExtraRequirementSchema>;
+/** 浏览器提交：清空时发空串，服务端据此删除已存的内容。 */
+export declare const SaveSiteExtraRequirementRequestSchema: z.ZodObject<{
+    note: z.ZodString;
+}, z.core.$strict>;
+export type SaveSiteExtraRequirementRequest = z.infer<typeof SaveSiteExtraRequirementRequestSchema>;
+export declare const SiteExtraRequirementResponseSchema: z.ZodObject<{
+    code: z.ZodNumber;
+    data: z.ZodNullable<z.ZodObject<{
+        note: z.ZodString;
+        updated_at: z.ZodString;
+    }, z.core.$strict>>;
+    message: z.ZodString;
+}, z.core.$strip>;
+export type SiteExtraRequirementResponse = z.infer<typeof SiteExtraRequirementResponseSchema>;

package/dist/site-locale.d.ts

@@ -25,6 +25,26 @@ export declare const DEFAULT_SITE_LOCALE: SiteLocale;
 export declare function resolveSiteTextDirection(locale: SiteLocale): SiteTextDirection;
 export declare const ISO_639_3_TO_SITE_LOCALE: Readonly<Record<string, SiteLocale>>;
 export declare function resolveSiteLocaleFromIso6393(iso6393: string): SiteLocale;
+/**
+ * 书写系统非拉丁的 locale 闭集。用于 DesignPlan Stage A 的 SEO 关键词分流。
+ *
+ * step5 关键词强制 English ASCII（`step5-strategy.ts` 的 superRefine），而
+ * DesignPlan 有两条相反硬指令：`Never mix languages within visitor-facing copy.`
+ * 与「所有 SEO 文案须写成站点 locale」。非拉丁书写系统站点逐字注入英文关键词
+ * 即构成混语，因此这些 locale 只把关键词当语义主题信号，由模型用站点语种自行
+ * 表达。
+ *
+ * 写成显式常量清单而不是运行时推断：SiteLocale 是闭集枚举（47 selectable +
+ * 43 legacy），不是任意 BCP-47，推断只会引入不可控误判。`sr` 与 `mn-MN` 通行
+ * 西里尔，保守归入非拉丁。清单由单测锁死为 SITE_LOCALE_CODES 的子集，防止
+ * 新增 locale 时漏更新而静默按拉丁系处理。
+ */
+export declare const NON_LATIN_SITE_LOCALE_CODES: readonly ["zh-CN", "zh-HK", "zh-TW", "ja-JP", "ja", "ko-KR", "ko", "ru-RU", "ru", "uk-UA", "uk", "bg", "sr", "mn-MN", "kk-KZ", "ar-SA", "ar", "fa-IR", "fa", "he", "hi", "th-TH", "th", "el-GR", "el", "ka-GE", "bn-BD", "bn", "ta-IN", "ta", "si-LK", "my-MM", "km-KH", "lo-LA"];
+/**
+ * 判定站点产出语种是否使用非拉丁书写系统。入参用宽松的 string：调用方拿到的
+ * locale 可能来自历史持久化值，不认识的一律按拉丁系处理（不抛、不阻断）。
+ */
+export declare function isNonLatinSiteLocale(locale: string): boolean;
 export declare const SiteLocaleSchema: z.ZodEnum<{
     id: "id";
     "zh-CN": "zh-CN";

package/dist/site-localization-fields.d.ts

@@ -0,0 +1,196 @@
+import { z } from "zod";
+/**
+ * 生成站点里三种**混合结构**的可本地化字段路径清单。
+ *
+ * ## 混合结构是什么
+ *
+ * 子站本地化的作用域判据是文件白名单：`components/site/generated/**` 与 `app/**`
+ * 装的是每站自己的内容，其余是模板层。白名单解决「哪些**文件**要翻」，解决不了
+ * 「一个文件里哪些**字段**要翻」——白名单内有几处声明同时躺着访客读的文案和站点
+ * 赖以工作的机器值，整文件翻或整文件不翻都错。表单规格
+ * （`FORM_SPEC_LOCALIZABLE_FIELD_PATHS`）是第一个这样收口的，本文件是同一套范式的
+ * 另外三份：
+ *
+ * - **`PAGE_SEO`**（每个路由段一份的页面 SEO 声明）：`title` / `description` 是
+ *   浏览器标签页与搜索结果里的文案，必须翻；`path` 是页面注册到 CMS 的路由键，
+ *   被 `buildPageMetadata` 拿去做 `seo.pageSeo(decl.path)` 查询，译掉之后查询静默
+ *   落空、整页 SEO 元数据全部丢失且不报错。
+ * - **根布局 `metadata`**（平台确定性产出的站级元数据）：站名、标题模板、
+ *   OpenGraph / Twitter 的标题与描述是文案；`metadataBase`、`openGraph.type`、
+ *   `twitter.card`、各类图片地址是机器值。
+ * - **`NAV_ITEMS`**（导航静态兜底数据）：`label` 是导航上印着的字；`href` 是路由、
+ *   `targetType` 是渲染分支的判别式、`iconKey` 是图标注册表的键。
+ *
+ * ## 为什么是字段路径清单，不是字段名词表
+ *
+ * 字段名黑名单在这条路上已经被证伪过四轮：它是在**开放集合**上猜下一个生成器
+ * 字段叫什么，每漏一个都是一次无声失效。这里走的是封闭集合——每个结构的字段由
+ * 生成侧的类型钉死，清单逐条列出来，**没列到的一律不翻**。
+ *
+ * 清单同时是**形状识别**的依据：可译半边与机器半边合起来就是「这个结构长什么样」
+ * 的全集。抽取器见到已登记的声明、却在里面读到清单外的字段路径时，不是把那一个
+ * 字段跳过就算了，而是整份文件本轮不翻并记降级——否则声明一变形就静默退回旧的
+ * 宽松路径，清单等于没写。
+ *
+ * ## 通配段
+ *
+ * - `*`：数组下标（查表前把具体下标归一成这一段）。
+ * - `**`：**本段及其整棵子树**。只用在取值形状开放、无法逐字段枚举的地方
+ *   （`schema_json` 是任意 JSON-LD，`meta_tags_json` 是键由 CMS 决定的开放记录）。
+ *   这两处按机器值整体处理是**故意往漏翻倒**：真有一天生成侧往里写文案，结果是
+ *   那段不被翻译（可见、可查），而不是把结构化数据译坏（静默、难查）。
+ */
+/** 已登记的混合结构。取值与抽取器的单元 `kind` 同名，便于对读。 */
+export declare const SITE_LOCALIZATION_STRUCTURES: readonly ["page-seo", "root-layout-metadata", "nav-items"];
+export type SiteLocalizationStructure = (typeof SITE_LOCALIZATION_STRUCTURES)[number];
+/**
+ * `PAGE_SEO` 声明的形状，与生成站点 `lib/cms/metadata.ts` 的 `PageSeoDecl` 对齐。
+ *
+ * 只用于把下面两份清单钉在一份可枚举的 schema 上（穷举用例会走遍它的每个字符串
+ * 叶子）；本地化链路判定用的是清单，不是这份 schema——抽取器面对的是**源码 AST**，
+ * 手里没有可校验的取值。
+ *
+ * `meta_tags_json` 的真实类型是 `{ og?, twitter? }` 两个开放记录，这里放宽成一层
+ * 开放记录：反正整棵子树按机器值处理，放宽只会让「未知字段」判得更宽松一点，
+ * 不会让任何机器值漏出去。
+ */
+export declare const PageSeoDeclSchema: z.ZodObject<{
+    path: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodString>;
+    meta_tags_json: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>>>>;
+    schema_json: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodRecord<z.ZodString, z.ZodUnknown>, z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>, z.ZodString]>>>;
+    breadcrumbs_json: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>>>;
+}, z.core.$strip>;
+/**
+ * 根布局 `export const metadata` 的形状。
+ *
+ * 上游 `next` 的 `Metadata` 是一个极大的开放类型，这里**只**声明本仓库真正会写进
+ * 根布局的那些键：平台确定性产出的那一段（站名 / 标题模板 / 描述 / OpenGraph /
+ * Twitter）、模板自带的那一段（`metadataBase` + 扁平 `title` / `description`），
+ * 外加 `buildPageMetadata` 组装出来的 `title.absolute`、`alternates.canonical`、
+ * `keywords`、`openGraph.url` / `locale`——它们今天只出现在运行时返回值里，但形状
+ * 同源，一并登记免得哪天被内联进源码时整份文件停翻。
+ *
+ * 这里**没有**声明 `robots` / `icons` / `verification` 等其余 Next 元数据键：真出现
+ * 了就是「已登记结构长出了没登记的字段」，按设计整文件本轮不翻并记降级，由人来
+ * 决定新键是文案还是机器值。这是清单相对上游开放类型必然会漂的那一面，方向安全。
+ */
+export declare const RootLayoutMetadataSchema: z.ZodObject<{
+    metadataBase: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        default: z.ZodOptional<z.ZodString>;
+        template: z.ZodOptional<z.ZodString>;
+        absolute: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>>;
+    description: z.ZodOptional<z.ZodString>;
+    keywords: z.ZodOptional<z.ZodString>;
+    openGraph: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+        siteName: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+        locale: z.ZodOptional<z.ZodString>;
+        images: z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            url: z.ZodString;
+            alt: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>>;
+    }, z.core.$strip>>;
+    twitter: z.ZodOptional<z.ZodObject<{
+        card: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        images: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strip>>;
+    alternates: z.ZodOptional<z.ZodObject<{
+        canonical: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * `NAV_ITEMS` 的一条，与 `@vcp/sitemap` 的 `NavItem` 对齐（分组条目是同一批字段的
+ * 子集，这里合成一个可选字段的对象，不拆联合）。
+ *
+ * 只展开一层 `children`：导航是**同构树**，字段语义只取决于叶子字段名、与嵌套深度
+ * 无关，因此查表前会把下标与 `children` 层一并归一掉（见
+ * {@link isSiteStructureLocalizableFieldPath}）。展开两层只是为了让穷举用例能看到
+ * 嵌套那一层确实没有新字段。
+ */
+export declare const NavItemSchema: z.ZodObject<{
+    label: z.ZodString;
+    href: z.ZodOptional<z.ZodString>;
+    targetType: z.ZodOptional<z.ZodEnum<{
+        file: "file";
+        external: "external";
+        anchor: "anchor";
+        email: "email";
+        page: "page";
+        phone: "phone";
+        group: "group";
+    }>>;
+    role: z.ZodOptional<z.ZodEnum<{
+        link: "link";
+        cta: "cta";
+    }>>;
+    openInNewTab: z.ZodOptional<z.ZodBoolean>;
+    nofollow: z.ZodOptional<z.ZodBoolean>;
+    description: z.ZodOptional<z.ZodString>;
+    badge: z.ZodOptional<z.ZodString>;
+    iconKey: z.ZodOptional<z.ZodString>;
+    children: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        href: z.ZodOptional<z.ZodString>;
+        targetType: z.ZodOptional<z.ZodEnum<{
+            file: "file";
+            external: "external";
+            anchor: "anchor";
+            email: "email";
+            page: "page";
+            phone: "phone";
+            group: "group";
+        }>>;
+        role: z.ZodOptional<z.ZodEnum<{
+            link: "link";
+            cta: "cta";
+        }>>;
+        openInNewTab: z.ZodOptional<z.ZodBoolean>;
+        nofollow: z.ZodOptional<z.ZodBoolean>;
+        description: z.ZodOptional<z.ZodString>;
+        badge: z.ZodOptional<z.ZodString>;
+        iconKey: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+/** `PAGE_SEO` 里该翻的字段路径。 */
+export declare const PAGE_SEO_LOCALIZABLE_FIELD_PATHS: readonly ["title", "description", "keywords", "breadcrumbs_json.*.name", "breadcrumbs_json.*.text"];
+/** `PAGE_SEO` 里必须逐字节留下的字段路径。 */
+export declare const PAGE_SEO_MACHINE_FIELD_PATHS: readonly ["path", "meta_tags_json.**", "schema_json.**", "breadcrumbs_json.*.url"];
+/** 根布局 `metadata` 里该翻的字段路径。 */
+export declare const ROOT_LAYOUT_METADATA_LOCALIZABLE_FIELD_PATHS: readonly ["title", "title.default", "title.template", "title.absolute", "description", "keywords", "openGraph.title", "openGraph.description", "openGraph.siteName", "openGraph.images.*.alt", "twitter.title", "twitter.description"];
+/** 根布局 `metadata` 里必须逐字节留下的字段路径。 */
+export declare const ROOT_LAYOUT_METADATA_MACHINE_FIELD_PATHS: readonly ["metadataBase", "openGraph.type", "openGraph.url", "openGraph.locale", "openGraph.images.*", "openGraph.images.*.url", "twitter.card", "twitter.images.*", "alternates.canonical"];
+/**
+ * `NAV_ITEMS` 里该翻的字段路径。写成**叶子字段名**：查表前下标与 `children` 层会被
+ * 归一掉，`NAV_ITEMS[2].children[0].label` 与 `NAV_ITEMS[0].label` 查的是同一条。
+ */
+export declare const NAV_ITEMS_LOCALIZABLE_FIELD_PATHS: readonly ["label", "description", "badge"];
+/** `NAV_ITEMS` 里必须逐字节留下的字段路径。 */
+export declare const NAV_ITEMS_MACHINE_FIELD_PATHS: readonly ["href", "targetType", "role", "iconKey"];
+/**
+ * 这条字段路径是不是该结构里**该翻**的文案。
+ *
+ * 失败即关闭：清单没点名的一律报「不可本地化」，包括本合同不认识的结构形态。
+ */
+export declare function isSiteStructureLocalizableFieldPath(structure: SiteLocalizationStructure, path: readonly (string | number)[]): boolean;
+/**
+ * 这条字段路径是不是该结构里**认得出**的位置——命中任一清单，或者还只是通往清单
+ * 某条目的中间层（`openGraph` 通往 `openGraph.title`）。
+ *
+ * 这是「见到声明却没识别 → 整文件不译」的判据。空路径（结构自身、导航条目自身）
+ * 恒为真：那是入口，不是字段。
+ */
+export declare function isSiteStructureKnownFieldPath(structure: SiteLocalizationStructure, path: readonly (string | number)[]): boolean;

package/dist/site-localization-scope.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 生成站点里**由平台物化器确定性产出**的文件清单：子站本地化的文本阶段整份跳过
+ * 它们。
+ *
+ * ## 为什么白名单不够
+ *
+ * 文本阶段的作用域判据是目录白名单（`components/site/generated/**` 与 `app/**`：
+ * 每站自己的内容）。它挡住了模板层与配置层，挡不住白名单**内部**的另一类文件——
+ * `apps/agent` 的物化器按平台源码常量写进快照的那些。它们躺在生成目录里，长得像
+ * 每站内容，实际上每个站逐字节相同。
+ *
+ * 决定性的机制是：**物化器重跑时整份覆写**。`materializeCanonicalFormRuntime` 读到
+ * 快照里的 `FORM_RUNTIME_VERSION` 不高于平台当前版本，就把整份内容换成
+ * `VCP_FORM_RUNTIME_SOURCE`；`buildMigrationProductFiles` 的五份产物走
+ * `apply_patch_batch` 的 `full_content` 整份写入；product-search 物化器逐份比对内容，
+ * 不一致就覆写。也就是说，A2 往这些文件里写的译文会被**静默还原，且不报任何错**。
+ * 翻译它们不只是越界，是做无用功且不可见。
+ *
+ * 正确的归属是**平台按目标语言直接产出**（`migrationEmptyProductsLabel` 与表单
+ * runtime 自带的语种表已经是这个形状，只是当前只覆盖少数语种）。本清单先把它们摘
+ * 出翻译范围，语种覆盖是平台侧的后续工作。
+ *
+ * ## 收录判据（两条同时成立）
+ *
+ * 1. 文件由 `apps/agent` 的物化器写入，路径由平台固定（参数只能取自平台常量或
+ *    结构 id，不由站点内容派生）。
+ * 2. 文件内容**完全由平台源码常量或确定性生成器决定**，不含站点自己的内容。
+ *
+ * 第 2 条刻意把三类「路径归平台、内容归站点」的文件**留在**翻译范围内：
+ *
+ * - `components/site/generated/forms/form-<id>.spec.ts`：路径由物化器决定，内容是
+ *   表单设计器里用户写的字段文案。它归 `FORM_SPEC_LOCALIZABLE_FIELD_PATHS` 的
+ *   字段级清单管辖（同一目录下与它相邻的 `form-<id>.tsx` 容器则是纯平台产物，
+ *   由本清单的模式项收录）。
+ * - `components/site/generated/site-navigation.tsx` / `site-footer.tsx`：由 sitemap
+ *   派生，装的是导航文字与页脚文案。
+ * - 区块组件与静态路由页：由生成 Agent 按站点设计写。
+ *
+ * ## 与模板受保护清单（`.donttouch_files.json`）的边界
+ *
+ * 两份清单管的是**不同的人**，不要合并：
+ *
+ * - 受保护清单说的是「**模型**不许改这些文件」，权威源是模板根，覆盖的是模板层
+ *   运行时与构建配置；本地化链路把它当白名单之后的第二道校验（读不到就 fail-open）。
+ * - 本清单说的是「**A2 文本阶段**不该翻这些文件」，权威源是 `apps/agent` 的物化器
+ *   导出，覆盖的是物化器写进生成目录的产物。
+ *
+ * 两者只在少数条目上重合（如 `app/api/forms/[code]/route.ts` 两边都在），重合是
+ * 巧合不是结构。合并会让任一侧的判据被另一侧的历史包袱牵着走。
+ *
+ * ## 这就是一张硬编码表
+ *
+ * 它的正当性不来自聪明，来自两件事：**集合封闭**（只有平台自己会新增物化器）+
+ * **用例守护**（`apps/agent` 侧的
+ * `agents/workspace/generation/platform-materialized-files.contract.test.ts` 反射每个物化器
+ * 模块导出的文件路径，
+ * 逐条要求出现在本表或本文件登记的豁免里，漏登记即红）。等写盘链路有统一收口时，
+ * 应改成物化器落库时登记，本表随即退役。
+ */
+/** 已登记的平台物化器。新增物化器必须同时在这里登记并补全下方表项。 */
+export declare const PLATFORM_MATERIALIZERS: readonly ["product-search", "migration-products", "standard-form", "form-submission-infrastructure"];
+export type PlatformMaterializer = (typeof PLATFORM_MATERIALIZERS)[number];
+export interface PlatformMaterializedFile {
+    /** 快照内的相对路径，与物化器写入时逐字相同。 */
+    readonly path: string;
+    readonly materializer: PlatformMaterializer;
+}
+/**
+ * 路径参数化的表项：`prefix` 与 `suffix` 之间是**一段裸标识符**（不含 `/` 与 `.`）。
+ *
+ * 只用在参数是结构 id、无法穷举的地方。判据刻意要求中间段不含 `.`，`form-<id>.spec.ts`
+ * 因此不会被 `.tsx` 这条模式误收——它是站点数据，归字段级清单。
+ */
+export interface PlatformMaterializedPathPattern {
+    readonly prefix: string;
+    readonly suffix: string;
+    readonly materializer: PlatformMaterializer;
+}
+/**
+ * 逐条路径。含白名单之外的条目（`lib/**`、`hooks/**`）：本表是「平台物化器写了哪些
+ * 文件」的完整记账，作用域裁剪由调用侧的白名单负责，两件事不混在一张表里。
+ */
+export declare const PLATFORM_MATERIALIZED_FILES: readonly PlatformMaterializedFile[];
+/** 参数化表项。当前只有表单容器一条。 */
+export declare const PLATFORM_MATERIALIZED_FILE_PATTERNS: readonly PlatformMaterializedPathPattern[];
+/**
+ * 已知**不进本表**的物化器路径，连同不收录的理由一起登记。契约用例读它做豁免，
+ * 因此新增一个物化器导出而忘了归类时，用例会红在「既不在表里也不在豁免里」。
+ */
+export declare const PLATFORM_MATERIALIZED_EXEMPTIONS: readonly {
+    readonly path: string;
+    readonly reason: string;
+}[];
+/** 逐条路径与参数化模式的并集判据。 */
+export declare function isPlatformMaterializedFile(filePath: string): boolean;

package/dist/site-preview.d.ts

@@ -2,9 +2,14 @@ import { z } from "zod";
 export declare const SitePreviewActivateErrorCodeSchema: z.ZodEnum<{
     PREVIEW_SESSION_NOT_FOUND: "PREVIEW_SESSION_NOT_FOUND";
     PREVIEW_SESSION_INVALID: "PREVIEW_SESSION_INVALID";
+    PREVIEW_SESSION_STALE: "PREVIEW_SESSION_STALE";
     PREVIEW_SESSION_LOOKUP_FAILED: "PREVIEW_SESSION_LOOKUP_FAILED";
     PREVIEW_SANDBOX_NOT_FOUND: "PREVIEW_SANDBOX_NOT_FOUND";
     PREVIEW_SANDBOX_CONNECT_FAILED: "PREVIEW_SANDBOX_CONNECT_FAILED";
+    PREVIEW_SANDBOX_OWNERSHIP_MISMATCH: "PREVIEW_SANDBOX_OWNERSHIP_MISMATCH";
+    PREVIEW_ACTIVATION_TIMEOUT: "PREVIEW_ACTIVATION_TIMEOUT";
+    PREVIEW_PREFLIGHT_FAILED: "PREVIEW_PREFLIGHT_FAILED";
+    PREVIEW_ENV_LOOKUP_FAILED: "PREVIEW_ENV_LOOKUP_FAILED";
     PREVIEW_SERVER_START_FAILED: "PREVIEW_SERVER_START_FAILED";
     PREVIEW_HEALTH_CHECK_FAILED: "PREVIEW_HEALTH_CHECK_FAILED";
     SANDBOX_NOT_CONFIGURED: "SANDBOX_NOT_CONFIGURED";
@@ -19,9 +24,14 @@ export declare const SitePreviewActivateFailedSchema: z.ZodObject<{
     code: z.ZodEnum<{
         PREVIEW_SESSION_NOT_FOUND: "PREVIEW_SESSION_NOT_FOUND";
         PREVIEW_SESSION_INVALID: "PREVIEW_SESSION_INVALID";
+        PREVIEW_SESSION_STALE: "PREVIEW_SESSION_STALE";
         PREVIEW_SESSION_LOOKUP_FAILED: "PREVIEW_SESSION_LOOKUP_FAILED";
         PREVIEW_SANDBOX_NOT_FOUND: "PREVIEW_SANDBOX_NOT_FOUND";
         PREVIEW_SANDBOX_CONNECT_FAILED: "PREVIEW_SANDBOX_CONNECT_FAILED";
+        PREVIEW_SANDBOX_OWNERSHIP_MISMATCH: "PREVIEW_SANDBOX_OWNERSHIP_MISMATCH";
+        PREVIEW_ACTIVATION_TIMEOUT: "PREVIEW_ACTIVATION_TIMEOUT";
+        PREVIEW_PREFLIGHT_FAILED: "PREVIEW_PREFLIGHT_FAILED";
+        PREVIEW_ENV_LOOKUP_FAILED: "PREVIEW_ENV_LOOKUP_FAILED";
         PREVIEW_SERVER_START_FAILED: "PREVIEW_SERVER_START_FAILED";
         PREVIEW_HEALTH_CHECK_FAILED: "PREVIEW_HEALTH_CHECK_FAILED";
         SANDBOX_NOT_CONFIGURED: "SANDBOX_NOT_CONFIGURED";
@@ -37,9 +47,14 @@ export declare const SitePreviewActivateResponseSchema: z.ZodDiscriminatedUnion<
     code: z.ZodEnum<{
         PREVIEW_SESSION_NOT_FOUND: "PREVIEW_SESSION_NOT_FOUND";
         PREVIEW_SESSION_INVALID: "PREVIEW_SESSION_INVALID";
+        PREVIEW_SESSION_STALE: "PREVIEW_SESSION_STALE";
         PREVIEW_SESSION_LOOKUP_FAILED: "PREVIEW_SESSION_LOOKUP_FAILED";
         PREVIEW_SANDBOX_NOT_FOUND: "PREVIEW_SANDBOX_NOT_FOUND";
         PREVIEW_SANDBOX_CONNECT_FAILED: "PREVIEW_SANDBOX_CONNECT_FAILED";
+        PREVIEW_SANDBOX_OWNERSHIP_MISMATCH: "PREVIEW_SANDBOX_OWNERSHIP_MISMATCH";
+        PREVIEW_ACTIVATION_TIMEOUT: "PREVIEW_ACTIVATION_TIMEOUT";
+        PREVIEW_PREFLIGHT_FAILED: "PREVIEW_PREFLIGHT_FAILED";
+        PREVIEW_ENV_LOOKUP_FAILED: "PREVIEW_ENV_LOOKUP_FAILED";
         PREVIEW_SERVER_START_FAILED: "PREVIEW_SERVER_START_FAILED";
         PREVIEW_HEALTH_CHECK_FAILED: "PREVIEW_HEALTH_CHECK_FAILED";
         SANDBOX_NOT_CONFIGURED: "SANDBOX_NOT_CONFIGURED";