@vcp-dev/contracts 0.6.10 → 0.6.11

package/dist/api-response.d.ts

@@ -0,0 +1,11 @@
+import { z } from "zod";
+export type ApiResponse<T> = {
+    code: number;
+    data: T;
+    message: string;
+};
+export declare const ApiResponseSchema: <T extends z.ZodTypeAny>(dataSchema: T) => z.ZodObject<{
+    code: z.ZodNumber;
+    data: T;
+    message: z.ZodString;
+}, z.core.$strip>;

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

@@ -0,0 +1,245 @@
+import { z } from "zod";
+export declare const HOME_PAGE_URL_PATH = "/";
+export declare const CmsPageTypeSchema: z.ZodEnum<{
+    landing_page: "landing_page";
+    general_page: "general_page";
+    detail_page: "detail_page";
+}>;
+export type CmsPageType = z.infer<typeof CmsPageTypeSchema>;
+export interface CmsPageDirectoryNode {
+    readonly cms_page_id: number;
+    readonly title: string;
+    readonly url_path: string;
+    readonly url: string | null;
+    readonly page_type: CmsPageType;
+    readonly vcp_managed: boolean;
+    readonly children: readonly CmsPageDirectoryNode[];
+}
+export declare const CmsPageDirectoryNodeSchema: z.ZodType<CmsPageDirectoryNode>;
+export declare const CmsPageDirectoryGroupSchema: z.ZodObject<{
+    group_id: z.ZodString;
+    title: z.ZodString;
+    pages: z.ZodArray<z.ZodType<CmsPageDirectoryNode, unknown, z.core.$ZodTypeInternals<CmsPageDirectoryNode, unknown>>>;
+}, z.core.$strict>;
+export type CmsPageDirectoryGroup = z.infer<typeof CmsPageDirectoryGroupSchema>;
+export declare const CmsPageDirectorySchema: z.ZodObject<{
+    groups: z.ZodArray<z.ZodObject<{
+        group_id: z.ZodString;
+        title: z.ZodString;
+        pages: z.ZodArray<z.ZodType<CmsPageDirectoryNode, unknown, z.core.$ZodTypeInternals<CmsPageDirectoryNode, unknown>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type CmsPageDirectory = z.infer<typeof CmsPageDirectorySchema>;
+/** 将 CMS 当前页面目录响应归一化为 VCP 内部目录模型。 */
+export declare function parseCmsPageDirectory(input: unknown): CmsPageDirectory | null;
+export declare const DesignerPageDisabledReasonSchema: z.ZodEnum<{
+    missing_url: "missing_url";
+    not_vcp_managed: "not_vcp_managed";
+}>;
+export type DesignerPageDisabledReason = z.infer<typeof DesignerPageDisabledReasonSchema>;
+export declare const DesignerPageDeleteBlockReasonSchema: z.ZodEnum<{
+    not_vcp_managed: "not_vcp_managed";
+    home_page: "home_page";
+    not_selectable: "not_selectable";
+    page_has_children: "page_has_children";
+    last_selectable_page: "last_selectable_page";
+    cms_unbound: "cms_unbound";
+}>;
+export type DesignerPageDeleteBlockReason = z.infer<typeof DesignerPageDeleteBlockReasonSchema>;
+export interface DesignerPageNode {
+    /** Null for VCP sitemap pages when the site has no CMS binding. */
+    readonly cms_page_id: number | null;
+    readonly title: string;
+    readonly url_path: string;
+    readonly url: string | null;
+    readonly page_type: CmsPageType;
+    readonly vcp_managed: boolean;
+    readonly selectable: boolean;
+    readonly disabled_reason: DesignerPageDisabledReason | null;
+    readonly can_delete: boolean;
+    readonly delete_block_reason: DesignerPageDeleteBlockReason | null;
+    readonly has_cms_children: boolean;
+    readonly children: readonly DesignerPageNode[];
+}
+export declare const DesignerPageNodeSchema: z.ZodType<DesignerPageNode>;
+export declare const DesignerPageGroupSchema: z.ZodObject<{
+    group_id: z.ZodString;
+    title: z.ZodString;
+    pages: z.ZodArray<z.ZodType<DesignerPageNode, unknown, z.core.$ZodTypeInternals<DesignerPageNode, unknown>>>;
+}, z.core.$strict>;
+export type DesignerPageGroup = z.infer<typeof DesignerPageGroupSchema>;
+export declare const DeleteDesignerPageRequestSchema: z.ZodObject<{
+    base_snapshot_id: z.ZodUUID;
+    expected_url_path: z.ZodString;
+}, z.core.$strict>;
+export type DeleteDesignerPageRequest = z.infer<typeof DeleteDesignerPageRequestSchema>;
+export declare const PageDirectoryReconcileStatusSchema: z.ZodEnum<{
+    failed: "failed";
+    succeeded: "succeeded";
+}>;
+export declare const PageDirectoryReconcileFailedPageSchema: z.ZodObject<{
+    url_path: z.ZodString;
+    phase: z.ZodEnum<{
+        ensure: "ensure";
+        binding: "binding";
+        delete: "delete";
+    }>;
+    code: z.ZodString;
+    message: z.ZodString;
+}, z.core.$strict>;
+export declare const PageDirectoryReconcileResultSchema: z.ZodObject<{
+    status: z.ZodEnum<{
+        failed: "failed";
+        succeeded: "succeeded";
+    }>;
+    checked_count: z.ZodNumber;
+    ensured_count: z.ZodNumber;
+    deleted_count: z.ZodNumber;
+    already_absent_count: z.ZodNumber;
+    failed_pages: z.ZodArray<z.ZodObject<{
+        url_path: z.ZodString;
+        phase: z.ZodEnum<{
+            ensure: "ensure";
+            binding: "binding";
+            delete: "delete";
+        }>;
+        code: z.ZodString;
+        message: z.ZodString;
+    }, z.core.$strict>>;
+    warnings: z.ZodArray<z.ZodString>;
+}, z.core.$strict>;
+export type PageDirectoryReconcileResult = z.infer<typeof PageDirectoryReconcileResultSchema>;
+export declare const DeleteDesignerPageResultSchema: z.ZodObject<{
+    result_snapshot_id: z.ZodUUID;
+    deleted_files: z.ZodArray<z.ZodString>;
+    updated_files: z.ZodArray<z.ZodString>;
+    preserved_shared_files: z.ZodArray<z.ZodString>;
+    warnings: z.ZodArray<z.ZodString>;
+    next_url: z.ZodNullable<z.ZodURL>;
+    previous_url: z.ZodNullable<z.ZodURL>;
+    cms_reconcile_result: z.ZodObject<{
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+        }>;
+        checked_count: z.ZodNumber;
+        ensured_count: z.ZodNumber;
+        deleted_count: z.ZodNumber;
+        already_absent_count: z.ZodNumber;
+        failed_pages: z.ZodArray<z.ZodObject<{
+            url_path: z.ZodString;
+            phase: z.ZodEnum<{
+                ensure: "ensure";
+                binding: "binding";
+                delete: "delete";
+            }>;
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>>;
+        warnings: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type DeleteDesignerPageResult = z.infer<typeof DeleteDesignerPageResultSchema>;
+export declare const DeleteDesignerPageResponseSchema: z.ZodObject<{
+    code: z.ZodLiteral<0>;
+    message: z.ZodString;
+    data: z.ZodObject<{
+        result_snapshot_id: z.ZodUUID;
+        deleted_files: z.ZodArray<z.ZodString>;
+        updated_files: z.ZodArray<z.ZodString>;
+        preserved_shared_files: z.ZodArray<z.ZodString>;
+        warnings: z.ZodArray<z.ZodString>;
+        next_url: z.ZodNullable<z.ZodURL>;
+        previous_url: z.ZodNullable<z.ZodURL>;
+        cms_reconcile_result: z.ZodObject<{
+            status: z.ZodEnum<{
+                failed: "failed";
+                succeeded: "succeeded";
+            }>;
+            checked_count: z.ZodNumber;
+            ensured_count: z.ZodNumber;
+            deleted_count: z.ZodNumber;
+            already_absent_count: z.ZodNumber;
+            failed_pages: z.ZodArray<z.ZodObject<{
+                url_path: z.ZodString;
+                phase: z.ZodEnum<{
+                    ensure: "ensure";
+                    binding: "binding";
+                    delete: "delete";
+                }>;
+                code: z.ZodString;
+                message: z.ZodString;
+            }, z.core.$strict>>;
+            warnings: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type DeleteDesignerPageResponse = z.infer<typeof DeleteDesignerPageResponseSchema>;
+export declare const DeleteDesignerPageErrorDetailsSchema: z.ZodObject<{
+    source_committed: z.ZodBoolean;
+    result_snapshot_id: z.ZodOptional<z.ZodUUID>;
+    cms_reconcile_result: z.ZodOptional<z.ZodObject<{
+        status: z.ZodEnum<{
+            failed: "failed";
+            succeeded: "succeeded";
+        }>;
+        checked_count: z.ZodNumber;
+        ensured_count: z.ZodNumber;
+        deleted_count: z.ZodNumber;
+        already_absent_count: z.ZodNumber;
+        failed_pages: z.ZodArray<z.ZodObject<{
+            url_path: z.ZodString;
+            phase: z.ZodEnum<{
+                ensure: "ensure";
+                binding: "binding";
+                delete: "delete";
+            }>;
+            code: z.ZodString;
+            message: z.ZodString;
+        }, z.core.$strict>>;
+        warnings: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type DeleteDesignerPageErrorDetails = z.infer<typeof DeleteDesignerPageErrorDetailsSchema>;
+export declare const PageTargetKindSchema: z.ZodEnum<{
+    general_page: "general_page";
+    detail_page: "detail_page";
+}>;
+export declare const PageTargetSchema: z.ZodObject<{
+    url_path: z.ZodString;
+    title: z.ZodString;
+    kind: z.ZodEnum<{
+        general_page: "general_page";
+        detail_page: "detail_page";
+    }>;
+    route_file: z.ZodString;
+    collection_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type PageTarget = z.infer<typeof PageTargetSchema>;
+export declare const PageTargetSetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    complete: z.ZodLiteral<true>;
+    targets: z.ZodArray<z.ZodObject<{
+        url_path: z.ZodString;
+        title: z.ZodString;
+        kind: z.ZodEnum<{
+            general_page: "general_page";
+            detail_page: "detail_page";
+        }>;
+        route_file: z.ZodString;
+        collection_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+}, z.core.$strict>, z.ZodObject<{
+    complete: z.ZodLiteral<false>;
+    targets: z.ZodArray<z.ZodObject<{
+        url_path: z.ZodString;
+        title: z.ZodString;
+        kind: z.ZodEnum<{
+            general_page: "general_page";
+            detail_page: "detail_page";
+        }>;
+        route_file: z.ZodString;
+        collection_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    errors: z.ZodArray<z.ZodString>;
+}, z.core.$strict>], "complete">;
+export type PageTargetSet = z.infer<typeof PageTargetSetSchema>;

package/dist/cms-site-id.d.ts

@@ -0,0 +1,4 @@
+import { z } from "zod";
+/** CMS owns this identifier; VCP only persists and forwards a validated UUID. */
+export declare const CmsSiteIdSchema: z.ZodString;
+export type CmsSiteId = z.infer<typeof CmsSiteIdSchema>;

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

@@ -8,12 +8,12 @@ export declare const FieldDeclSchema: z.ZodObject<{
         number: "number";
         boolean: "boolean";
         date: "date";
+        url: "url";
         title: "title";
+        email: "email";
+        datetime: "datetime";
         text: "text";
         richtext: "richtext";
-        datetime: "datetime";
-        url: "url";
-        email: "email";
         color: "color";
         select: "select";
         multiselect: "multiselect";
@@ -46,18 +46,22 @@ export declare const ConnectDynamicCollectionInputSchema: z.ZodObject<{
     route_file_path: z.ZodString;
     target_component_path: z.ZodString;
     content_type_hint: z.ZodString;
+    collection_purpose: z.ZodOptional<z.ZodEnum<{
+        generic: "generic";
+        product: "product";
+    }>>;
     required_fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
         name: z.ZodString;
         type: z.ZodEnum<{
             number: "number";
             boolean: "boolean";
             date: "date";
+            url: "url";
             title: "title";
+            email: "email";
+            datetime: "datetime";
             text: "text";
             richtext: "richtext";
-            datetime: "datetime";
-            url: "url";
-            email: "email";
             color: "color";
             select: "select";
             multiselect: "multiselect";
@@ -81,12 +85,12 @@ export declare const ConnectDynamicCollectionInputSchema: z.ZodObject<{
             number: "number";
             boolean: "boolean";
             date: "date";
+            url: "url";
             title: "title";
+            email: "email";
+            datetime: "datetime";
             text: "text";
             richtext: "richtext";
-            datetime: "datetime";
-            url: "url";
-            email: "email";
             color: "color";
             select: "select";
             multiselect: "multiselect";

package/dist/connect-form.d.ts

@@ -4,7 +4,7 @@ import { z } from "zod";
  * 词表→CMS 表单字段类型映射在 agent 侧 `cms/forms/field-type-to-form.ts`，
  * 与 connect-dynamic-collection 的 FIELD_TYPES/field-type-to-cms 同款分层。
  */
-export declare const FORM_FIELD_TYPES: readonly ["text", "textarea", "email", "phone", "select", "radio", "multiselect", "boolean", "date", "number"];
+export declare const FORM_FIELD_TYPES: readonly ["text", "textarea", "email", "phone", "select", "radio", "multiselect", "boolean", "date", "number", "file"];
 export type FormFieldType = (typeof FORM_FIELD_TYPES)[number];
 export declare const FormFieldDeclSchema: z.ZodObject<{
     name: z.ZodString;
@@ -12,8 +12,9 @@ export declare const FormFieldDeclSchema: z.ZodObject<{
         number: "number";
         boolean: "boolean";
         date: "date";
-        text: "text";
+        file: "file";
         email: "email";
+        text: "text";
         select: "select";
         multiselect: "multiselect";
         textarea: "textarea";
@@ -40,8 +41,9 @@ export declare const ConnectFormInputSchema: z.ZodObject<{
             number: "number";
             boolean: "boolean";
             date: "date";
-            text: "text";
+            file: "file";
             email: "email";
+            text: "text";
             select: "select";
             multiselect: "multiselect";
             textarea: "textarea";