@tbox.cn/app-contracts-mall 0.1.1 → 0.9.0

package/dist/member/cards.d.ts

@@ -0,0 +1,940 @@
+/**
+ * 会员域卡片数据契约（011 K2：member 卡 zod schema，TIER1；券面 0.4.0 净删——promotion 承接）。
+ */
+import { z } from 'zod';
+export declare const memberAuthStateSchema: z.ZodEnum<["authenticated", "unauthenticated"]>;
+export declare const memberStateSchema: z.ZodEnum<["unknown", "active", "not_enrolled", "closed"]>;
+/** PRD 6.6 首批会员偏好问题；卡片展示、意图路由与记忆写入共用同一真源。 */
+export declare const MEMBER_PREFERENCE_VALUES: readonly ["我常来买衣服", "我常带娃来玩", "我常来吃美食"];
+export declare const memberPreferenceValueSchema: z.ZodEnum<["我常来买衣服", "我常带娃来玩", "我常来吃美食"]>;
+export type MemberPreferenceValue = z.infer<typeof memberPreferenceValueSchema>;
+export declare const MEMBER_PREFERENCE_PROMPTS: ReadonlyArray<{
+    value: MemberPreferenceValue;
+    query: string;
+}>;
+/** 按偏好触发导购能力时使用的检索语句；与用户可见按钮文案解耦。 */
+export declare const MEMBER_PREFERENCE_RECOMMENDATION_QUERIES: Readonly<Record<MemberPreferenceValue, string>>;
+/** member-info：账户 + 资料摘要 */
+export declare const memberInfoCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    authState: z.ZodEnum<["authenticated", "unauthenticated"]>;
+    state: z.ZodEnum<["unknown", "active", "not_enrolled", "closed"]>;
+    displayName: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+    contactDisplay: z.ZodOptional<z.ZodString>;
+    memberRef: z.ZodOptional<z.ZodString>;
+    registeredAt: z.ZodOptional<z.ZodString>;
+    labels: z.ZodArray<z.ZodObject<{
+        labelRef: z.ZodString;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        labelRef: string;
+    }, {
+        name: string;
+        labelRef: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    authState: "authenticated" | "unauthenticated";
+    state: "unknown" | "active" | "not_enrolled" | "closed";
+    labels: {
+        name: string;
+        labelRef: string;
+    }[];
+    displayName?: string | undefined;
+    avatarUrl?: string | undefined;
+    contactDisplay?: string | undefined;
+    memberRef?: string | undefined;
+    registeredAt?: string | undefined;
+}, {
+    userId: string;
+    authState: "authenticated" | "unauthenticated";
+    state: "unknown" | "active" | "not_enrolled" | "closed";
+    labels: {
+        name: string;
+        labelRef: string;
+    }[];
+    displayName?: string | undefined;
+    avatarUrl?: string | undefined;
+    contactDisplay?: string | undefined;
+    memberRef?: string | undefined;
+    registeredAt?: string | undefined;
+}>;
+export type MemberInfoCardData = z.infer<typeof memberInfoCardDataSchema>;
+/** member-card-summary：会员卡面（真实卡名、卡图与积分摘要） */
+export declare const memberCardSummaryCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    cardRef: z.ZodString;
+    cardDisplay: z.ZodString;
+    status: z.ZodEnum<["active", "inactive", "frozen", "expired", "unknown"]>;
+    levelName: z.ZodOptional<z.ZodString>;
+    availablePoints: z.ZodNumber;
+    cardImageUrl: z.ZodOptional<z.ZodString>;
+    pointsRuleImageUrl: z.ZodOptional<z.ZodString>;
+    pointsRuleContent: z.ZodOptional<z.ZodString>;
+    pointsUrl: z.ZodOptional<z.ZodString>;
+    presentation: z.ZodOptional<z.ZodObject<{
+        variant: z.ZodEnum<["blue", "silver", "gold", "black"]>;
+        labelsEmbedded: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        variant: "silver" | "gold" | "blue" | "black";
+        labelsEmbedded?: boolean | undefined;
+    }, {
+        variant: "silver" | "gold" | "blue" | "black";
+        labelsEmbedded?: boolean | undefined;
+    }>>;
+    progress: z.ZodOptional<z.ZodObject<{
+        daySpentCents: z.ZodNumber;
+        yearSpentCents: z.ZodNumber;
+        percent: z.ZodNumber;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        daySpentCents: number;
+        yearSpentCents: number;
+        percent: number;
+    }, {
+        message: string;
+        daySpentCents: number;
+        yearSpentCents: number;
+        percent: number;
+    }>>;
+    benefits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        benefitRef: z.ZodString;
+        name: z.ZodString;
+        iconUrl: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        action: z.ZodOptional<z.ZodObject<{
+            kind: z.ZodEnum<["miniapp", "dialog", "toast"]>;
+            url: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            kind: "toast" | "miniapp" | "dialog";
+            url?: string | undefined;
+            text?: string | undefined;
+            title?: string | undefined;
+        }, {
+            kind: "toast" | "miniapp" | "dialog";
+            url?: string | undefined;
+            text?: string | undefined;
+            title?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        benefitRef: string;
+        description?: string | undefined;
+        iconUrl?: string | undefined;
+        action?: {
+            kind: "toast" | "miniapp" | "dialog";
+            url?: string | undefined;
+            text?: string | undefined;
+            title?: string | undefined;
+        } | undefined;
+    }, {
+        name: string;
+        benefitRef: string;
+        description?: string | undefined;
+        iconUrl?: string | undefined;
+        action?: {
+            kind: "toast" | "miniapp" | "dialog";
+            url?: string | undefined;
+            text?: string | undefined;
+            title?: string | undefined;
+        } | undefined;
+    }>, "many">>;
+    /** 入会后偏好引导；首批固定三项，保留数组形态便于后续扩展。 */
+    preferencePrompts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodEnum<["我常来买衣服", "我常带娃来玩", "我常来吃美食"]>;
+        query: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+        query: string;
+    }, {
+        value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+        query: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    status: "unknown" | "active" | "inactive" | "frozen" | "expired";
+    userId: string;
+    cardRef: string;
+    cardDisplay: string;
+    availablePoints: number;
+    levelName?: string | undefined;
+    cardImageUrl?: string | undefined;
+    pointsRuleImageUrl?: string | undefined;
+    pointsRuleContent?: string | undefined;
+    pointsUrl?: string | undefined;
+    presentation?: {
+        variant: "silver" | "gold" | "blue" | "black";
+        labelsEmbedded?: boolean | undefined;
+    } | undefined;
+    progress?: {
+        message: string;
+        daySpentCents: number;
+        yearSpentCents: number;
+        percent: number;
+    } | undefined;
+    benefits?: {
+        name: string;
+        benefitRef: string;
+        description?: string | undefined;
+        iconUrl?: string | undefined;
+        action?: {
+            kind: "toast" | "miniapp" | "dialog";
+            url?: string | undefined;
+            text?: string | undefined;
+            title?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    preferencePrompts?: {
+        value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+        query: string;
+    }[] | undefined;
+}, {
+    status: "unknown" | "active" | "inactive" | "frozen" | "expired";
+    userId: string;
+    cardRef: string;
+    cardDisplay: string;
+    availablePoints: number;
+    levelName?: string | undefined;
+    cardImageUrl?: string | undefined;
+    pointsRuleImageUrl?: string | undefined;
+    pointsRuleContent?: string | undefined;
+    pointsUrl?: string | undefined;
+    presentation?: {
+        variant: "silver" | "gold" | "blue" | "black";
+        labelsEmbedded?: boolean | undefined;
+    } | undefined;
+    progress?: {
+        message: string;
+        daySpentCents: number;
+        yearSpentCents: number;
+        percent: number;
+    } | undefined;
+    benefits?: {
+        name: string;
+        benefitRef: string;
+        description?: string | undefined;
+        iconUrl?: string | undefined;
+        action?: {
+            kind: "toast" | "miniapp" | "dialog";
+            url?: string | undefined;
+            text?: string | undefined;
+            title?: string | undefined;
+        } | undefined;
+    }[] | undefined;
+    preferencePrompts?: {
+        value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+        query: string;
+    }[] | undefined;
+}>;
+export type MemberCardSummaryCardData = z.infer<typeof memberCardSummaryCardDataSchema>;
+/**
+ * member-point-usage-list（011 K3：余额、厂商会员标签与积分流水）。
+ */
+export declare const memberPointUsageListCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    balance: z.ZodNumber;
+    membershipLabel: z.ZodOptional<z.ZodString>;
+    items: z.ZodArray<z.ZodObject<{
+        usageRecordRef: z.ZodString;
+        title: z.ZodString;
+        amount: z.ZodString;
+        usedAt: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        usageRecordRef: string;
+        amount: string;
+        description?: string | undefined;
+        usedAt?: string | undefined;
+    }, {
+        title: string;
+        usageRecordRef: string;
+        amount: string;
+        description?: string | undefined;
+        usedAt?: string | undefined;
+    }>, "many">;
+    total: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    total: number;
+    items: {
+        title: string;
+        usageRecordRef: string;
+        amount: string;
+        description?: string | undefined;
+        usedAt?: string | undefined;
+    }[];
+    balance: number;
+    membershipLabel?: string | undefined;
+}, {
+    userId: string;
+    total: number;
+    items: {
+        title: string;
+        usageRecordRef: string;
+        amount: string;
+        description?: string | undefined;
+        usedAt?: string | undefined;
+    }[];
+    balance: number;
+    membershipLabel?: string | undefined;
+}>;
+export type MemberPointUsageListCardData = z.infer<typeof memberPointUsageListCardDataSchema>;
+/** member-enrollment-form（入会表单；015 升级：授权预填 + consent + formVersion） */
+export declare const memberEnrollmentFormCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    state: z.ZodEnum<["unknown", "active", "not_enrolled", "closed"]>;
+    /** 表单版本（幂等键组成部分） */
+    formVersion: z.ZodString;
+    /** 表单字段（readOnly = 授权预填锁定；prefill = 预填值） */
+    fields: z.ZodArray<z.ZodObject<{
+        fieldId: z.ZodString;
+        label: z.ZodString;
+        type: z.ZodEnum<["text", "tel", "select", "date"]>;
+        required: z.ZodBoolean;
+        readOnly: z.ZodOptional<z.ZodBoolean>;
+        prefill: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        type: "date" | "text" | "tel" | "select";
+        required: boolean;
+        label: string;
+        fieldId: string;
+        options?: string[] | undefined;
+        readOnly?: boolean | undefined;
+        prefill?: string | undefined;
+        placeholder?: string | undefined;
+    }, {
+        type: "date" | "text" | "tel" | "select";
+        required: boolean;
+        label: string;
+        fieldId: string;
+        options?: string[] | undefined;
+        readOnly?: boolean | undefined;
+        prefill?: string | undefined;
+        placeholder?: string | undefined;
+    }>, "many">;
+    /** 隐私/条款同意项（required 必勾） */
+    consents: z.ZodArray<z.ZodObject<{
+        consentId: z.ZodString;
+        version: z.ZodString;
+        title: z.ZodString;
+        required: z.ZodBoolean;
+        url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        required: boolean;
+        title: string;
+        consentId: string;
+        version: string;
+        url?: string | undefined;
+    }, {
+        required: boolean;
+        title: string;
+        consentId: string;
+        version: string;
+        url?: string | undefined;
+    }>, "many">;
+    /** 支付宝授权状态（required → 渲染授权按钮；authorized → mobile 预填 readOnly） */
+    authorization: z.ZodObject<{
+        status: z.ZodEnum<["required", "authorized", "unavailable"]>;
+        mobileMasked: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "required" | "unavailable" | "authorized";
+        mobileMasked?: string | undefined;
+    }, {
+        status: "required" | "unavailable" | "authorized";
+        mobileMasked?: string | undefined;
+    }>;
+    /** 手动填写模式提示（授权不可用降级） */
+    manualNotice: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    state: "unknown" | "active" | "not_enrolled" | "closed";
+    formVersion: string;
+    fields: {
+        type: "date" | "text" | "tel" | "select";
+        required: boolean;
+        label: string;
+        fieldId: string;
+        options?: string[] | undefined;
+        readOnly?: boolean | undefined;
+        prefill?: string | undefined;
+        placeholder?: string | undefined;
+    }[];
+    consents: {
+        required: boolean;
+        title: string;
+        consentId: string;
+        version: string;
+        url?: string | undefined;
+    }[];
+    authorization: {
+        status: "required" | "unavailable" | "authorized";
+        mobileMasked?: string | undefined;
+    };
+    manualNotice?: string | undefined;
+}, {
+    userId: string;
+    state: "unknown" | "active" | "not_enrolled" | "closed";
+    formVersion: string;
+    fields: {
+        type: "date" | "text" | "tel" | "select";
+        required: boolean;
+        label: string;
+        fieldId: string;
+        options?: string[] | undefined;
+        readOnly?: boolean | undefined;
+        prefill?: string | undefined;
+        placeholder?: string | undefined;
+    }[];
+    consents: {
+        required: boolean;
+        title: string;
+        consentId: string;
+        version: string;
+        url?: string | undefined;
+    }[];
+    authorization: {
+        status: "required" | "unavailable" | "authorized";
+        mobileMasked?: string | undefined;
+    };
+    manualNotice?: string | undefined;
+}>;
+export type MemberEnrollmentFormCardData = z.infer<typeof memberEnrollmentFormCardDataSchema>;
+/** member-enrollment-status（入会结果状态卡；pending 态附显式刷新按钮，R4） */
+export declare const memberEnrollmentStatusCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    attemptRef: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<["pending_confirmation", "confirmation_timeout", "active", "failed"]>;
+    memberRef: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    state: "active" | "pending_confirmation" | "confirmation_timeout" | "failed";
+    message?: string | undefined;
+    memberRef?: string | undefined;
+    attemptRef?: string | undefined;
+}, {
+    userId: string;
+    state: "active" | "pending_confirmation" | "confirmation_timeout" | "failed";
+    message?: string | undefined;
+    memberRef?: string | undefined;
+    attemptRef?: string | undefined;
+}>;
+export type MemberEnrollmentStatusCardData = z.infer<typeof memberEnrollmentStatusCardDataSchema>;
+/** member-enrollment-cta：开卡入会引导卡（点击跳转 alipays 链接） */
+export declare const memberEnrollmentCtaCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    authState: z.ZodLiteral<"authenticated">;
+    state: z.ZodEnum<["not_enrolled", "closed"]>;
+    /**
+     * alipays:// 深链，由部署配置注入；**可选透传素材**——出卡不依赖它，
+     * 壳能力（getLoginState/openGate）缺席时兜底 openLink 用，未配置恒出卡（无此字段）
+     */
+    enrollUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    title: z.ZodOptional<z.ZodString>;
+    subtitle: z.ZodOptional<z.ZodString>;
+    /**
+     * 入会权益提示列表（工具层注入通用文案；不得包含折扣/免费停车等未经系统确认的承诺）。
+     * 缺省不展示，由渲染层按有无决定是否渲染区块。
+     */
+    perks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    authState: "authenticated";
+    state: "not_enrolled" | "closed";
+    enrollUrl?: string | undefined;
+    title?: string | undefined;
+    subtitle?: string | undefined;
+    perks?: string[] | undefined;
+}, {
+    userId: string;
+    authState: "authenticated";
+    state: "not_enrolled" | "closed";
+    enrollUrl?: string | undefined;
+    title?: string | undefined;
+    subtitle?: string | undefined;
+    perks?: string[] | undefined;
+}>;
+export type MemberEnrollmentCtaCardData = z.infer<typeof memberEnrollmentCtaCardDataSchema>;
+/**
+ * member-login-cta：未登录引导卡（点击跳转商场小程序登录页，登录后回到智能体）。
+ *
+ * 与 member-enrollment-cta 的分界：**登录 ≠ 入会**。这张卡的前提是「还没有身份」，
+ * 故不带 userId / authState——那两个字段此刻根本拿不到。开卡入会是登录之后的下一步。
+ *
+ * 说明文案由组件写死（「登录后可解锁全部功能」）：曾按触发场景分别注入，实测各处理由
+ * 大同小异，留一个 optional 字段只会变成没人写的死字段。真要分场景再加回来。
+ */
+export declare const memberLoginCtaCardDataSchema: z.ZodObject<{
+    /**
+     * 商场小程序登录页深链，由部署配置注入；**可选透传素材**——出卡不依赖它，
+     * 壳能力（getLoginState）缺席时兜底 openLink 用，未配置恒出卡（无此字段）
+     */
+    loginUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    title: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    loginUrl?: string | undefined;
+    title?: string | undefined;
+}, {
+    loginUrl?: string | undefined;
+    title?: string | undefined;
+}>;
+export type MemberLoginCtaCardData = z.infer<typeof memberLoginCtaCardDataSchema>;
+/** 7 卡 schema map（cardType → dataSchema；券面 0.4.0 净删——promotion 承接） */
+export declare const memberCardDataSchemas: {
+    readonly 'member-info': z.ZodObject<{
+        userId: z.ZodString;
+        authState: z.ZodEnum<["authenticated", "unauthenticated"]>;
+        state: z.ZodEnum<["unknown", "active", "not_enrolled", "closed"]>;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        contactDisplay: z.ZodOptional<z.ZodString>;
+        memberRef: z.ZodOptional<z.ZodString>;
+        registeredAt: z.ZodOptional<z.ZodString>;
+        labels: z.ZodArray<z.ZodObject<{
+            labelRef: z.ZodString;
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            labelRef: string;
+        }, {
+            name: string;
+            labelRef: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        userId: string;
+        authState: "authenticated" | "unauthenticated";
+        state: "unknown" | "active" | "not_enrolled" | "closed";
+        labels: {
+            name: string;
+            labelRef: string;
+        }[];
+        displayName?: string | undefined;
+        avatarUrl?: string | undefined;
+        contactDisplay?: string | undefined;
+        memberRef?: string | undefined;
+        registeredAt?: string | undefined;
+    }, {
+        userId: string;
+        authState: "authenticated" | "unauthenticated";
+        state: "unknown" | "active" | "not_enrolled" | "closed";
+        labels: {
+            name: string;
+            labelRef: string;
+        }[];
+        displayName?: string | undefined;
+        avatarUrl?: string | undefined;
+        contactDisplay?: string | undefined;
+        memberRef?: string | undefined;
+        registeredAt?: string | undefined;
+    }>;
+    readonly 'member-card-summary': z.ZodObject<{
+        userId: z.ZodString;
+        cardRef: z.ZodString;
+        cardDisplay: z.ZodString;
+        status: z.ZodEnum<["active", "inactive", "frozen", "expired", "unknown"]>;
+        levelName: z.ZodOptional<z.ZodString>;
+        availablePoints: z.ZodNumber;
+        cardImageUrl: z.ZodOptional<z.ZodString>;
+        pointsRuleImageUrl: z.ZodOptional<z.ZodString>;
+        pointsRuleContent: z.ZodOptional<z.ZodString>;
+        pointsUrl: z.ZodOptional<z.ZodString>;
+        presentation: z.ZodOptional<z.ZodObject<{
+            variant: z.ZodEnum<["blue", "silver", "gold", "black"]>;
+            labelsEmbedded: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            variant: "silver" | "gold" | "blue" | "black";
+            labelsEmbedded?: boolean | undefined;
+        }, {
+            variant: "silver" | "gold" | "blue" | "black";
+            labelsEmbedded?: boolean | undefined;
+        }>>;
+        progress: z.ZodOptional<z.ZodObject<{
+            daySpentCents: z.ZodNumber;
+            yearSpentCents: z.ZodNumber;
+            percent: z.ZodNumber;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            daySpentCents: number;
+            yearSpentCents: number;
+            percent: number;
+        }, {
+            message: string;
+            daySpentCents: number;
+            yearSpentCents: number;
+            percent: number;
+        }>>;
+        benefits: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            benefitRef: z.ZodString;
+            name: z.ZodString;
+            iconUrl: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            action: z.ZodOptional<z.ZodObject<{
+                kind: z.ZodEnum<["miniapp", "dialog", "toast"]>;
+                url: z.ZodOptional<z.ZodString>;
+                title: z.ZodOptional<z.ZodString>;
+                text: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                kind: "toast" | "miniapp" | "dialog";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: string | undefined;
+            }, {
+                kind: "toast" | "miniapp" | "dialog";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: string | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            benefitRef: string;
+            description?: string | undefined;
+            iconUrl?: string | undefined;
+            action?: {
+                kind: "toast" | "miniapp" | "dialog";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: string | undefined;
+            } | undefined;
+        }, {
+            name: string;
+            benefitRef: string;
+            description?: string | undefined;
+            iconUrl?: string | undefined;
+            action?: {
+                kind: "toast" | "miniapp" | "dialog";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: string | undefined;
+            } | undefined;
+        }>, "many">>;
+        /** 入会后偏好引导；首批固定三项，保留数组形态便于后续扩展。 */
+        preferencePrompts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodEnum<["我常来买衣服", "我常带娃来玩", "我常来吃美食"]>;
+            query: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+            query: string;
+        }, {
+            value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+            query: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        status: "unknown" | "active" | "inactive" | "frozen" | "expired";
+        userId: string;
+        cardRef: string;
+        cardDisplay: string;
+        availablePoints: number;
+        levelName?: string | undefined;
+        cardImageUrl?: string | undefined;
+        pointsRuleImageUrl?: string | undefined;
+        pointsRuleContent?: string | undefined;
+        pointsUrl?: string | undefined;
+        presentation?: {
+            variant: "silver" | "gold" | "blue" | "black";
+            labelsEmbedded?: boolean | undefined;
+        } | undefined;
+        progress?: {
+            message: string;
+            daySpentCents: number;
+            yearSpentCents: number;
+            percent: number;
+        } | undefined;
+        benefits?: {
+            name: string;
+            benefitRef: string;
+            description?: string | undefined;
+            iconUrl?: string | undefined;
+            action?: {
+                kind: "toast" | "miniapp" | "dialog";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: string | undefined;
+            } | undefined;
+        }[] | undefined;
+        preferencePrompts?: {
+            value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+            query: string;
+        }[] | undefined;
+    }, {
+        status: "unknown" | "active" | "inactive" | "frozen" | "expired";
+        userId: string;
+        cardRef: string;
+        cardDisplay: string;
+        availablePoints: number;
+        levelName?: string | undefined;
+        cardImageUrl?: string | undefined;
+        pointsRuleImageUrl?: string | undefined;
+        pointsRuleContent?: string | undefined;
+        pointsUrl?: string | undefined;
+        presentation?: {
+            variant: "silver" | "gold" | "blue" | "black";
+            labelsEmbedded?: boolean | undefined;
+        } | undefined;
+        progress?: {
+            message: string;
+            daySpentCents: number;
+            yearSpentCents: number;
+            percent: number;
+        } | undefined;
+        benefits?: {
+            name: string;
+            benefitRef: string;
+            description?: string | undefined;
+            iconUrl?: string | undefined;
+            action?: {
+                kind: "toast" | "miniapp" | "dialog";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: string | undefined;
+            } | undefined;
+        }[] | undefined;
+        preferencePrompts?: {
+            value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+            query: string;
+        }[] | undefined;
+    }>;
+    readonly 'member-point-usage-list': z.ZodObject<{
+        userId: z.ZodString;
+        balance: z.ZodNumber;
+        membershipLabel: z.ZodOptional<z.ZodString>;
+        items: z.ZodArray<z.ZodObject<{
+            usageRecordRef: z.ZodString;
+            title: z.ZodString;
+            amount: z.ZodString;
+            usedAt: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            usageRecordRef: string;
+            amount: string;
+            description?: string | undefined;
+            usedAt?: string | undefined;
+        }, {
+            title: string;
+            usageRecordRef: string;
+            amount: string;
+            description?: string | undefined;
+            usedAt?: string | undefined;
+        }>, "many">;
+        total: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        userId: string;
+        total: number;
+        items: {
+            title: string;
+            usageRecordRef: string;
+            amount: string;
+            description?: string | undefined;
+            usedAt?: string | undefined;
+        }[];
+        balance: number;
+        membershipLabel?: string | undefined;
+    }, {
+        userId: string;
+        total: number;
+        items: {
+            title: string;
+            usageRecordRef: string;
+            amount: string;
+            description?: string | undefined;
+            usedAt?: string | undefined;
+        }[];
+        balance: number;
+        membershipLabel?: string | undefined;
+    }>;
+    readonly 'member-enrollment-form': z.ZodObject<{
+        userId: z.ZodString;
+        state: z.ZodEnum<["unknown", "active", "not_enrolled", "closed"]>;
+        /** 表单版本（幂等键组成部分） */
+        formVersion: z.ZodString;
+        /** 表单字段（readOnly = 授权预填锁定；prefill = 预填值） */
+        fields: z.ZodArray<z.ZodObject<{
+            fieldId: z.ZodString;
+            label: z.ZodString;
+            type: z.ZodEnum<["text", "tel", "select", "date"]>;
+            required: z.ZodBoolean;
+            readOnly: z.ZodOptional<z.ZodBoolean>;
+            prefill: z.ZodOptional<z.ZodString>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            type: "date" | "text" | "tel" | "select";
+            required: boolean;
+            label: string;
+            fieldId: string;
+            options?: string[] | undefined;
+            readOnly?: boolean | undefined;
+            prefill?: string | undefined;
+            placeholder?: string | undefined;
+        }, {
+            type: "date" | "text" | "tel" | "select";
+            required: boolean;
+            label: string;
+            fieldId: string;
+            options?: string[] | undefined;
+            readOnly?: boolean | undefined;
+            prefill?: string | undefined;
+            placeholder?: string | undefined;
+        }>, "many">;
+        /** 隐私/条款同意项（required 必勾） */
+        consents: z.ZodArray<z.ZodObject<{
+            consentId: z.ZodString;
+            version: z.ZodString;
+            title: z.ZodString;
+            required: z.ZodBoolean;
+            url: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            required: boolean;
+            title: string;
+            consentId: string;
+            version: string;
+            url?: string | undefined;
+        }, {
+            required: boolean;
+            title: string;
+            consentId: string;
+            version: string;
+            url?: string | undefined;
+        }>, "many">;
+        /** 支付宝授权状态（required → 渲染授权按钮；authorized → mobile 预填 readOnly） */
+        authorization: z.ZodObject<{
+            status: z.ZodEnum<["required", "authorized", "unavailable"]>;
+            mobileMasked: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: "required" | "unavailable" | "authorized";
+            mobileMasked?: string | undefined;
+        }, {
+            status: "required" | "unavailable" | "authorized";
+            mobileMasked?: string | undefined;
+        }>;
+        /** 手动填写模式提示（授权不可用降级） */
+        manualNotice: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userId: string;
+        state: "unknown" | "active" | "not_enrolled" | "closed";
+        formVersion: string;
+        fields: {
+            type: "date" | "text" | "tel" | "select";
+            required: boolean;
+            label: string;
+            fieldId: string;
+            options?: string[] | undefined;
+            readOnly?: boolean | undefined;
+            prefill?: string | undefined;
+            placeholder?: string | undefined;
+        }[];
+        consents: {
+            required: boolean;
+            title: string;
+            consentId: string;
+            version: string;
+            url?: string | undefined;
+        }[];
+        authorization: {
+            status: "required" | "unavailable" | "authorized";
+            mobileMasked?: string | undefined;
+        };
+        manualNotice?: string | undefined;
+    }, {
+        userId: string;
+        state: "unknown" | "active" | "not_enrolled" | "closed";
+        formVersion: string;
+        fields: {
+            type: "date" | "text" | "tel" | "select";
+            required: boolean;
+            label: string;
+            fieldId: string;
+            options?: string[] | undefined;
+            readOnly?: boolean | undefined;
+            prefill?: string | undefined;
+            placeholder?: string | undefined;
+        }[];
+        consents: {
+            required: boolean;
+            title: string;
+            consentId: string;
+            version: string;
+            url?: string | undefined;
+        }[];
+        authorization: {
+            status: "required" | "unavailable" | "authorized";
+            mobileMasked?: string | undefined;
+        };
+        manualNotice?: string | undefined;
+    }>;
+    readonly 'member-enrollment-status': z.ZodObject<{
+        userId: z.ZodString;
+        attemptRef: z.ZodOptional<z.ZodString>;
+        state: z.ZodEnum<["pending_confirmation", "confirmation_timeout", "active", "failed"]>;
+        memberRef: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        userId: string;
+        state: "active" | "pending_confirmation" | "confirmation_timeout" | "failed";
+        message?: string | undefined;
+        memberRef?: string | undefined;
+        attemptRef?: string | undefined;
+    }, {
+        userId: string;
+        state: "active" | "pending_confirmation" | "confirmation_timeout" | "failed";
+        message?: string | undefined;
+        memberRef?: string | undefined;
+        attemptRef?: string | undefined;
+    }>;
+    readonly 'member-enrollment-cta': z.ZodObject<{
+        userId: z.ZodString;
+        authState: z.ZodLiteral<"authenticated">;
+        state: z.ZodEnum<["not_enrolled", "closed"]>;
+        /**
+         * alipays:// 深链，由部署配置注入；**可选透传素材**——出卡不依赖它，
+         * 壳能力（getLoginState/openGate）缺席时兜底 openLink 用，未配置恒出卡（无此字段）
+         */
+        enrollUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        title: z.ZodOptional<z.ZodString>;
+        subtitle: z.ZodOptional<z.ZodString>;
+        /**
+         * 入会权益提示列表（工具层注入通用文案；不得包含折扣/免费停车等未经系统确认的承诺）。
+         * 缺省不展示，由渲染层按有无决定是否渲染区块。
+         */
+        perks: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        userId: string;
+        authState: "authenticated";
+        state: "not_enrolled" | "closed";
+        enrollUrl?: string | undefined;
+        title?: string | undefined;
+        subtitle?: string | undefined;
+        perks?: string[] | undefined;
+    }, {
+        userId: string;
+        authState: "authenticated";
+        state: "not_enrolled" | "closed";
+        enrollUrl?: string | undefined;
+        title?: string | undefined;
+        subtitle?: string | undefined;
+        perks?: string[] | undefined;
+    }>;
+    readonly 'member-login-cta': z.ZodObject<{
+        /**
+         * 商场小程序登录页深链，由部署配置注入；**可选透传素材**——出卡不依赖它，
+         * 壳能力（getLoginState）缺席时兜底 openLink 用，未配置恒出卡（无此字段）
+         */
+        loginUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        title: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        loginUrl?: string | undefined;
+        title?: string | undefined;
+    }, {
+        loginUrl?: string | undefined;
+        title?: string | undefined;
+    }>;
+};
+export type MemberCardType = keyof typeof memberCardDataSchemas;