@vcp-dev/contracts 0.9.5 → 0.10.0

package/dist/cms-application-provisioning.d.ts

@@ -0,0 +1,92 @@
+import { z } from "zod";
+/**
+ * Shared CMS application core input. It deliberately contains only the CMS
+ * application definition: pages, snapshots, runs, and scaffolds belong to
+ * their callers and must not cross this boundary.
+ */
+export declare const CmsApplicationCoreInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    collection_purpose: z.ZodOptional<z.ZodEnum<{
+        generic: "generic";
+        product: "product";
+    }>>;
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            boolean: "boolean";
+            title: "title";
+            text: "text";
+            richtext: "richtext";
+            date: "date";
+            datetime: "datetime";
+            url: "url";
+            email: "email";
+            color: "color";
+            select: "select";
+            multiselect: "multiselect";
+            tag: "tag";
+        }>;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type CmsApplicationCoreInput = z.infer<typeof CmsApplicationCoreInputSchema>;
+/** CMS must tell callers whether the application was newly created or existed. */
+export declare const CmsApplicationCoreResultSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    collection_slug: z.ZodString;
+    detail_prefix: z.ZodString;
+    plugin_id: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<"created">;
+}, z.core.$strict>, z.ZodObject<{
+    collection_slug: z.ZodString;
+    detail_prefix: z.ZodString;
+    plugin_id: z.ZodOptional<z.ZodNumber>;
+    kind: z.ZodLiteral<"exists">;
+}, z.core.$strict>], "kind">;
+export type CmsApplicationCoreResult = z.infer<typeof CmsApplicationCoreResultSchema>;
+/** Inputs for the one-shot initialization write. */
+export declare const CmsApplicationSeedInputSchema: z.ZodObject<{
+    fields: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodEnum<{
+            number: "number";
+            boolean: "boolean";
+            title: "title";
+            text: "text";
+            richtext: "richtext";
+            date: "date";
+            datetime: "datetime";
+            url: "url";
+            email: "email";
+            color: "color";
+            select: "select";
+            multiselect: "multiselect";
+            tag: "tag";
+        }>;
+        label: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    seed_records: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    category_id: z.ZodNumber;
+}, z.core.$strict>;
+export type CmsApplicationSeedInput = z.infer<typeof CmsApplicationSeedInputSchema>;
+/**
+ * Real CMS write receipts. `failed` stays opaque and bounded here; consumers
+ * may project safe stable fields, but must not expose the upstream payload as
+ * logs or browser data.
+ */
+export declare const CmsApplicationSeedResultSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodNumber>;
+    urls: z.ZodRecord<z.ZodString, z.ZodNullable<z.ZodString>>;
+    failed: z.ZodArray<z.ZodUnknown>;
+}, z.core.$strict>;
+export type CmsApplicationSeedResult = z.infer<typeof CmsApplicationSeedResultSchema>;
+/**
+ * Keep this pure and dependency-free. It mirrors cms-center's Slugger
+ * normalization: remove non-ASCII alphanumerics, lowercase, then cap at 30.
+ */
+export declare function normalizeCmsApplicationSlug(slug: string): string;

package/dist/cms-collection-binding.d.ts

@@ -19,11 +19,11 @@ export declare const CmsCollectionBindingSchema: z.ZodObject<{
     collection_slug: z.ZodString;
     cms_collection_id: z.ZodNullable<z.ZodString>;
     status: z.ZodEnum<{
+        failed: "failed";
         provisioning: "provisioning";
         cms_app_created: "cms_app_created";
         seeded: "seeded";
         ready: "ready";
-        failed: "failed";
     }>;
     owned_by_vcp: z.ZodBoolean;
     run_id: z.ZodNullable<z.ZodUUID>;

package/dist/cms-page-directory.d.ts

@@ -132,8 +132,8 @@ export declare const DeleteDesignerPageRequestSchema: z.ZodObject<{
 }, z.core.$strict>;
 export type DeleteDesignerPageRequest = z.infer<typeof DeleteDesignerPageRequestSchema>;
 export declare const PageDirectoryReconcileStatusSchema: z.ZodEnum<{
-    failed: "failed";
     succeeded: "succeeded";
+    failed: "failed";
 }>;
 export declare const PageDirectoryReconcileFailedPageSchema: z.ZodObject<{
     url_path: z.ZodString;
@@ -147,8 +147,8 @@ export declare const PageDirectoryReconcileFailedPageSchema: z.ZodObject<{
 }, z.core.$strict>;
 export declare const PageDirectoryReconcileResultSchema: z.ZodObject<{
     status: z.ZodEnum<{
-        failed: "failed";
         succeeded: "succeeded";
+        failed: "failed";
     }>;
     checked_count: z.ZodNumber;
     ensured_count: z.ZodNumber;
@@ -177,8 +177,8 @@ export declare const DeleteDesignerPageResultSchema: z.ZodObject<{
     previous_url: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
     cms_reconcile_result: z.ZodObject<{
         status: z.ZodEnum<{
-            failed: "failed";
             succeeded: "succeeded";
+            failed: "failed";
         }>;
         checked_count: z.ZodNumber;
         ensured_count: z.ZodNumber;
@@ -211,8 +211,8 @@ export declare const DeleteDesignerPageResponseSchema: z.ZodObject<{
         previous_url: z.ZodNullable<z.ZodUnion<readonly [z.ZodURL, z.ZodString]>>;
         cms_reconcile_result: z.ZodObject<{
             status: z.ZodEnum<{
-                failed: "failed";
                 succeeded: "succeeded";
+                failed: "failed";
             }>;
             checked_count: z.ZodNumber;
             ensured_count: z.ZodNumber;
@@ -242,8 +242,8 @@ export declare const RecoverDesignerPageProjectionResultSchema: z.ZodObject<{
     warnings: z.ZodArray<z.ZodString>;
     cms_reconcile_result: z.ZodObject<{
         status: z.ZodEnum<{
-            failed: "failed";
             succeeded: "succeeded";
+            failed: "failed";
         }>;
         checked_count: z.ZodNumber;
         ensured_count: z.ZodNumber;
@@ -271,8 +271,8 @@ export declare const RecoverDesignerPageProjectionResponseSchema: z.ZodObject<{
         warnings: z.ZodArray<z.ZodString>;
         cms_reconcile_result: z.ZodObject<{
             status: z.ZodEnum<{
-                failed: "failed";
                 succeeded: "succeeded";
+                failed: "failed";
             }>;
             checked_count: z.ZodNumber;
             ensured_count: z.ZodNumber;
@@ -298,8 +298,8 @@ export declare const DeleteDesignerPageErrorDetailsSchema: z.ZodObject<{
     result_snapshot_id: z.ZodOptional<z.ZodUUID>;
     cms_reconcile_result: z.ZodOptional<z.ZodObject<{
         status: z.ZodEnum<{
-            failed: "failed";
             succeeded: "succeeded";
+            failed: "failed";
         }>;
         checked_count: z.ZodNumber;
         ensured_count: z.ZodNumber;

package/dist/connect-dynamic-collection.d.ts

@@ -7,12 +7,12 @@ export declare const FieldDeclSchema: z.ZodObject<{
     type: z.ZodEnum<{
         number: "number";
         boolean: "boolean";
-        date: "date";
-        url: "url";
         title: "title";
         text: "text";
         richtext: "richtext";
+        date: "date";
         datetime: "datetime";
+        url: "url";
         email: "email";
         color: "color";
         select: "select";
@@ -55,12 +55,12 @@ export declare const ConnectDynamicCollectionInputSchema: z.ZodObject<{
         type: z.ZodEnum<{
             number: "number";
             boolean: "boolean";
-            date: "date";
-            url: "url";
             title: "title";
             text: "text";
             richtext: "richtext";
+            date: "date";
             datetime: "datetime";
+            url: "url";
             email: "email";
             color: "color";
             select: "select";
@@ -84,12 +84,12 @@ export declare const ConnectDynamicCollectionInputSchema: z.ZodObject<{
         type: z.ZodEnum<{
             number: "number";
             boolean: "boolean";
-            date: "date";
-            url: "url";
             title: "title";
             text: "text";
             richtext: "richtext";
+            date: "date";
             datetime: "datetime";
+            url: "url";
             email: "email";
             color: "color";
             select: "select";

package/dist/connect-form.d.ts

@@ -26,8 +26,8 @@ export declare const FormFieldDeclSchema: z.ZodObject<{
     type: z.ZodEnum<{
         number: "number";
         boolean: "boolean";
-        date: "date";
         text: "text";
+        date: "date";
         email: "email";
         select: "select";
         multiselect: "multiselect";
@@ -54,8 +54,8 @@ export declare const ConnectFormInputSchema: z.ZodObject<{
         type: z.ZodEnum<{
             number: "number";
             boolean: "boolean";
-            date: "date";
             text: "text";
+            date: "date";
             email: "email";
             select: "select";
             multiselect: "multiselect";

package/dist/conversion-hints.d.ts

@@ -25,11 +25,11 @@ import { z } from "zod";
 export declare const CONVERSION_CTA_LABEL_MAX_LENGTH = 40;
 export declare const ConversionHintsSchema: z.ZodObject<{
     protocol: z.ZodEnum<{
+        route: "route";
         external: "external";
         phone: "phone";
         form: "form";
         download: "download";
-        route: "route";
     }>;
     ctaLabel: z.ZodString;
     ctaTarget: z.ZodOptional<z.ZodString>;

package/dist/custom-domain.d.ts

@@ -48,8 +48,8 @@ export declare const DomainOperationTypeSchema: z.ZodEnum<{
 }>;
 export type DomainOperationType = z.infer<typeof DomainOperationTypeSchema>;
 export declare const DomainOperationStatusSchema: z.ZodEnum<{
-    failed: "failed";
     succeeded: "succeeded";
+    failed: "failed";
     accepted: "accepted";
     running: "running";
 }>;
@@ -275,8 +275,8 @@ export declare const DomainOperationSchema: z.ZodObject<{
         confirm_dns_remediation: "confirm_dns_remediation";
     }>;
     status: z.ZodEnum<{
-        failed: "failed";
         succeeded: "succeeded";
+        failed: "failed";
         accepted: "accepted";
         running: "running";
     }>;

package/dist/deployment-progress.d.ts

@@ -10,8 +10,8 @@ export declare const DeploymentProgressStepCodeSchema: z.ZodEnum<{
 }>;
 export type DeploymentProgressStepCode = z.infer<typeof DeploymentProgressStepCodeSchema>;
 export declare const DeploymentProgressStepStatusSchema: z.ZodEnum<{
-    failed: "failed";
     succeeded: "succeeded";
+    failed: "failed";
     running: "running";
 }>;
 export type DeploymentProgressStepStatus = z.infer<typeof DeploymentProgressStepStatusSchema>;
@@ -25,8 +25,8 @@ export declare const DeploymentProgressStepSchema: z.ZodObject<{
         cleanup_release: "cleanup_release";
     }>;
     status: z.ZodEnum<{
-        failed: "failed";
         succeeded: "succeeded";
+        failed: "failed";
         running: "running";
     }>;
     message: z.ZodString;
@@ -42,8 +42,8 @@ export declare const DeploymentProgressStepsSchema: z.ZodArray<z.ZodObject<{
         cleanup_release: "cleanup_release";
     }>;
     status: z.ZodEnum<{
-        failed: "failed";
         succeeded: "succeeded";
+        failed: "failed";
         running: "running";
     }>;
     message: z.ZodString;

package/dist/designer-page-library.d.ts

@@ -8,15 +8,15 @@ export declare const DESIGNER_PAGE_LIBRARY_ERROR_CODES: {
     readonly incompatibleResource: "DESIGNER_PAGE_RESOURCE_INCOMPATIBLE";
 };
 export declare const DesignerPageResourceTypeSchema: z.ZodEnum<{
-    pages: "pages";
     page: "page";
+    pages: "pages";
 }>;
 export type DesignerPageResourceType = z.infer<typeof DesignerPageResourceTypeSchema>;
 export declare const DesignerPageResourceSourceSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        pages: "pages";
         page: "page";
+        pages: "pages";
     }>;
     resolved_version: z.ZodNumber;
     template_page_id: z.ZodString;
@@ -36,8 +36,8 @@ export declare const DesignerPageCategoriesDataSchema: z.ZodObject<{
 export declare const DesignerPageCatalogItemSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        pages: "pages";
         page: "page";
+        pages: "pages";
     }>;
     name: z.ZodString;
     description: z.ZodNullable<z.ZodString>;
@@ -55,8 +55,8 @@ export declare const DesignerPagesDataSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         resource_id: z.ZodString;
         resource_type: z.ZodEnum<{
-            pages: "pages";
             page: "page";
+            pages: "pages";
         }>;
         name: z.ZodString;
         description: z.ZodNullable<z.ZodString>;
@@ -106,8 +106,8 @@ export declare const PageResourceDraftPageSchema: z.ZodObject<{
     source: z.ZodOptional<z.ZodObject<{
         resource_id: z.ZodString;
         resource_type: z.ZodEnum<{
-            pages: "pages";
             page: "page";
+            pages: "pages";
         }>;
         resolved_version: z.ZodNumber;
         template_page_id: z.ZodString;
@@ -135,8 +135,8 @@ export type PageResourceDraftPage = z.infer<typeof PageResourceDraftPageSchema>;
 export declare const PageResourceDraftSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        pages: "pages";
         page: "page";
+        pages: "pages";
     }>;
     resolved_version: z.ZodNumber;
     pages: z.ZodArray<z.ZodObject<{
@@ -145,8 +145,8 @@ export declare const PageResourceDraftSchema: z.ZodObject<{
         source: z.ZodOptional<z.ZodObject<{
             resource_id: z.ZodString;
             resource_type: z.ZodEnum<{
-                pages: "pages";
                 page: "page";
+                pages: "pages";
             }>;
             resolved_version: z.ZodNumber;
             template_page_id: z.ZodString;
@@ -174,8 +174,8 @@ export declare const PageResourceDraftSchema: z.ZodObject<{
 export type PageResourceDraft = z.infer<typeof PageResourceDraftSchema>;
 export declare const InstallDesignerPageBodySchema: z.ZodObject<{
     resource_type: z.ZodEnum<{
-        pages: "pages";
         page: "page";
+        pages: "pages";
     }>;
     version: z.ZodNumber;
     pages: z.ZodArray<z.ZodObject<{
@@ -243,8 +243,8 @@ export type PageResourcePage = z.infer<typeof PageResourcePageSchema>;
 export declare const PageResourceArtifactSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        pages: "pages";
         page: "page";
+        pages: "pages";
     }>;
     resolved_version: z.ZodNumber;
     revision_id: z.ZodOptional<z.ZodString>;
@@ -303,8 +303,8 @@ export type PageResourceArtifact = z.infer<typeof PageResourceArtifactSchema>;
 export declare const DesignerPageInstallDataSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        pages: "pages";
         page: "page";
+        pages: "pages";
     }>;
     resolved_version: z.ZodNumber;
     revision_id: z.ZodOptional<z.ZodString>;
@@ -381,8 +381,8 @@ export type DesignerPageResourceTemplate = z.infer<typeof DesignerPageResourceTe
 export declare const DesignerPageResourcePreparationDataSchema: z.ZodObject<{
     resource_id: z.ZodString;
     resource_type: z.ZodEnum<{
-        pages: "pages";
         page: "page";
+        pages: "pages";
     }>;
     resolved_version: z.ZodNumber;
     pages: z.ZodArray<z.ZodObject<{
@@ -399,8 +399,8 @@ export declare const DesignerPageResourcePreparationDataSchema: z.ZodObject<{
 export type DesignerPageResourcePreparationData = z.infer<typeof DesignerPageResourcePreparationDataSchema>;
 export declare const PrepareDesignerPageBodySchema: z.ZodObject<{
     resource_type: z.ZodEnum<{
-        pages: "pages";
         page: "page";
+        pages: "pages";
     }>;
     version: z.ZodNumber;
 }, z.core.$strict>;
@@ -409,8 +409,8 @@ export declare const ComposeDesignerPageResourceBodySchema: z.ZodObject<{
     draft: z.ZodObject<{
         resource_id: z.ZodString;
         resource_type: z.ZodEnum<{
-            pages: "pages";
             page: "page";
+            pages: "pages";
         }>;
         resolved_version: z.ZodNumber;
         pages: z.ZodArray<z.ZodObject<{
@@ -419,8 +419,8 @@ export declare const ComposeDesignerPageResourceBodySchema: z.ZodObject<{
             source: z.ZodOptional<z.ZodObject<{
                 resource_id: z.ZodString;
                 resource_type: z.ZodEnum<{
-                    pages: "pages";
                     page: "page";
+                    pages: "pages";
                 }>;
                 resolved_version: z.ZodNumber;
                 template_page_id: z.ZodString;

package/dist/external-site-edit.d.ts

@@ -14,8 +14,8 @@ export declare const EXTERNAL_SITE_EDIT_PROMPT_MAX_LENGTH = 4000;
  * 详见设计 §9.3——运行记录会在「站已改好但收口失败」时呈现为失败。
  */
 export declare const ExternalSiteEditOutcomeSchema: z.ZodEnum<{
-    failed: "failed";
     succeeded: "succeeded";
+    failed: "failed";
     degraded: "degraded";
     no_changes: "no_changes";
 }>;
@@ -52,8 +52,8 @@ export declare const ExternalSiteEditCallbackStatusSchema: z.ZodEnum<{
 export type ExternalSiteEditCallbackStatus = z.infer<typeof ExternalSiteEditCallbackStatusSchema>;
 /** 任务状态：进行中，或四态终态之一。 */
 export declare const ExternalSiteEditTaskStatusSchema: z.ZodEnum<{
-    failed: "failed";
     succeeded: "succeeded";
+    failed: "failed";
     running: "running";
     degraded: "degraded";
     no_changes: "no_changes";
@@ -79,15 +79,15 @@ export declare const ExternalSiteEditTaskSchema: z.ZodObject<{
     external_run_id: z.ZodString;
     external_thread_id: z.ZodString;
     status: z.ZodEnum<{
-        failed: "failed";
         succeeded: "succeeded";
+        failed: "failed";
         running: "running";
         degraded: "degraded";
         no_changes: "no_changes";
     }>;
     outcome: z.ZodNullable<z.ZodEnum<{
-        failed: "failed";
         succeeded: "succeeded";
+        failed: "failed";
         degraded: "degraded";
         no_changes: "no_changes";
     }>>;
@@ -129,15 +129,15 @@ export declare const CreateExternalSiteEditResponseSchema: z.ZodObject<{
         external_run_id: z.ZodString;
         external_thread_id: z.ZodString;
         status: z.ZodEnum<{
-            failed: "failed";
             succeeded: "succeeded";
+            failed: "failed";
             running: "running";
             degraded: "degraded";
             no_changes: "no_changes";
         }>;
         outcome: z.ZodNullable<z.ZodEnum<{
-            failed: "failed";
             succeeded: "succeeded";
+            failed: "failed";
             degraded: "degraded";
             no_changes: "no_changes";
         }>>;
@@ -180,15 +180,15 @@ export declare const GetExternalSiteEditResponseSchema: z.ZodObject<{
         external_run_id: z.ZodString;
         external_thread_id: z.ZodString;
         status: z.ZodEnum<{
-            failed: "failed";
             succeeded: "succeeded";
+            failed: "failed";
             running: "running";
             degraded: "degraded";
             no_changes: "no_changes";
         }>;
         outcome: z.ZodNullable<z.ZodEnum<{
-            failed: "failed";
             succeeded: "succeeded";
+            failed: "failed";
             degraded: "degraded";
             no_changes: "no_changes";
         }>>;
@@ -238,8 +238,8 @@ export declare const ExternalSiteEditCallbackPayloadSchema: z.ZodObject<{
     site_id: z.ZodUUID;
     vcp_run_id: z.ZodNullable<z.ZodUUID>;
     outcome: z.ZodEnum<{
-        failed: "failed";
         succeeded: "succeeded";
+        failed: "failed";
         degraded: "degraded";
         no_changes: "no_changes";
     }>;