@tbox.cn/app-module-member 0.2.0 → 0.8.7

package/dist/server/index.d.ts

@@ -1,29 +1,40 @@
-import * as _mastra_core_tools from '@mastra/core/tools';
+import * as _tbox_cn_app_sdk_server from '@tbox.cn/app-sdk/server';
+import { ServerContext } from '@tbox.cn/app-sdk/server';
 import * as _tbox_cn_app_contracts from '@tbox.cn/app-contracts';
+import { RequestContext } from '@tbox.cn/app-contracts';
 import * as zod from 'zod';
-import { PreToolDef, ServerContext } from '@tbox.cn/app-sdk/server';
-import { MemberAccountPort, MemberProfilePort, MemberCardPort, MemberBenefitsPort, MemberCouponPort, MemberEnrollmentPort, MemberAccountSnapshot, MemberProfileSnapshot, MemberCardSnapshot, Points, MemberBenefitsSnapshot, PointUsageRecord, DiscountRule, MemberCouponSnapshot } from '@tbox.cn/app-contracts-mall';
+import { MemberAccountPort, MemberProfilePort, MemberCardPort, MemberBenefitsPort, MemberEnrollmentPort, MemberAccountSnapshot, MemberProfileSnapshot, MemberCardSnapshot, Points, MemberBenefitsSnapshot, MemberEnrollmentFormDefinition, PointUsageRecord, DiscountRule, MemberEnrollmentInput, MemberEnrollmentResult, MemberEnrollmentStatus } from '@tbox.cn/app-contracts-mall';
 
 /**
- * MemberService：商圈会员完整实现（011 K2：6 Port 全量）。
+ * MemberService：商圈会员完整实现（011 K2 六 Port + 015 入会升级）。
  * extends 契约 Port（保证满足消费方子集约束）；完整接口只在本模块包内。
  */
-interface MemberService extends MemberAccountPort, MemberProfilePort, MemberCardPort, MemberBenefitsPort, MemberCouponPort, MemberEnrollmentPort {
-    /** 积分变动记录（单测/观测用） */
-    audit: {
-        action: string;
-        userId: string;
-        amount: number;
-        key?: string;
-    }[];
+/**
+ * InMemory 演示实现（仅供隔离单测；运行时注册与 Provider 解析不得使用）。
+ * 017 槽位原子化后非 Port 成员归位：getEnrollmentFormDefinition 已收编
+ * MemberEnrollmentPort optional 方法（R13）；enrollUrl/loginUrl 为槽产物自由属性
+ * （enrollment/account 槽的类型视图见 ports.ts）；audit 转 InMemory 私有观测成员。
+ */
+interface MemberService extends MemberAccountPort, MemberProfilePort, MemberCardPort, MemberBenefitsPort, MemberEnrollmentPort {
+    /** 入会落地页深链（alipays:// 或 H5 链接），从 deployment provider config 注入；空串表示未配置。 */
+    readonly enrollUrl: string;
+    /**
+     * 登录页深链，同样从 deployment provider config 注入。
+     * 可选而非必填——真实 provider 接入前不该被迫实现；缺省时登录引导退回文本。
+     */
+    readonly loginUrl?: string;
 }
-/** 内存实现（PoC；真实数据源 = joycity-membership provider 接入点，二期） */
+
+/** 仅供隔离单测使用的 fixture；运行时注册与 Provider 解析不得使用。 */
 declare class InMemoryMemberService implements MemberService {
+    readonly enrollUrl: string;
     private balances;
-    private levels;
     private idempotentKeys;
     private usages;
     private profiles;
+    private enrollmentAttempts;
+    private pendingConfirmations;
+    private statusQueries;
     audit: {
         action: string;
         userId: string;
@@ -36,6 +47,7 @@ declare class InMemoryMemberService implements MemberService {
     getCard(userId: string): Promise<MemberCardSnapshot | null>;
     queryPoints(userId: string): Promise<Points>;
     getBenefits(userId: string): Promise<MemberBenefitsSnapshot>;
+    getEnrollmentFormDefinition(): Promise<MemberEnrollmentFormDefinition>;
     listPointUsage(userId: string, page: number, pageSize: number): Promise<{
         items: ReadonlyArray<PointUsageRecord>;
         total: number;
@@ -44,40 +56,44 @@ declare class InMemoryMemberService implements MemberService {
     deductPoints(userId: string, amount: number, idempotencyKey: string): Promise<boolean>;
     refundPoints(userId: string, amount: number, idempotencyKey: string): Promise<boolean>;
     awardPoints(userId: string, amount: number): Promise<boolean>;
-    listCoupons(userId: string, page: number, pageSize: number): Promise<{
-        items: ReadonlyArray<MemberCouponSnapshot>;
-        total: number;
-    }>;
-    getCoupon(_userId: string, _couponRef: string): Promise<MemberCouponSnapshot | null>;
-    enroll(input: {
-        userId: string;
-        name?: string;
-        phone?: string;
-    }): Promise<{
-        success: boolean;
+    enroll(input: MemberEnrollmentInput): Promise<MemberEnrollmentResult>;
+    getEnrollmentStatus(userId: string, attemptRef: string): Promise<{
+        status: MemberEnrollmentStatus;
         memberRef?: string;
-        error?: string;
-    }>;
-    completeAuthorization(input: {
-        userId: string;
-        scopes: readonly string[];
-    }): Promise<{
-        success: boolean;
+        reason?: string;
     }>;
-    private levelOf;
-    private maybeUpgrade;
-    private levelChangeListeners;
-    onLevelChange(fn: (e: {
-        userId: string;
-        newLevel: 'silver' | 'gold' | 'platinum';
-    }) => void): void;
 }
 
+/**
+ * member Port 分槽解析（017 槽位原子化）：五槽独立解析（account/profile/card/
+ * benefits/enrollment），无运行时 InMemory 兜底（InMemoryMemberService 仅限隔离单测）。
+ * 解析失败一律上抛：未配置/禁用等预期缺席错误码由 registry 抛出，调用方按业务文案转译
+ * （status fail-soft / 工具层文案兜底）。
+ *
+ * 非 Port 成员归位：loginUrl 挂 account 槽产物、enrollUrl 挂 enrollment 槽产物
+ * （厂商 fat 实现运行期携带；契约 Port 不含——返回类型上的可选属性扩展即类型视图）。
+ */
+
+/** account 槽产物类型视图：Port + 厂商实例携带的登录深链（可选） */
+type MemberAccountService = MemberAccountPort & {
+    readonly loginUrl?: string;
+};
+/** enrollment 槽产物类型视图：Port + 厂商实例携带的入会深链（可选） */
+type MemberEnrollmentService = MemberEnrollmentPort & {
+    readonly enrollUrl?: string;
+};
+declare function resolveMemberAccountPort(reqCtx: RequestContext, ctx: ServerContext): Promise<MemberAccountService>;
+declare function resolveMemberProfilePort(reqCtx: RequestContext, ctx: ServerContext): Promise<MemberProfilePort>;
+declare function resolveMemberCardPort(reqCtx: RequestContext, ctx: ServerContext): Promise<MemberCardPort>;
+declare function resolveMemberBenefitsPort(reqCtx: RequestContext, ctx: ServerContext): Promise<MemberBenefitsPort>;
+declare function resolveMemberEnrollmentPort(reqCtx: RequestContext, ctx: ServerContext): Promise<MemberEnrollmentService>;
+
 /** 7 卡 meta map（key 约定 = cardType） */
 declare const memberCards: {
     readonly 'member-info': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
         userId: zod.ZodString;
-        state: zod.ZodEnum<["active", "not_enrolled", "closed"]>;
+        authState: zod.ZodEnum<["authenticated", "unauthenticated"]>;
+        state: zod.ZodEnum<["unknown", "active", "not_enrolled", "closed"]>;
         displayName: zod.ZodOptional<zod.ZodString>;
         avatarUrl: zod.ZodOptional<zod.ZodString>;
         contactDisplay: zod.ZodOptional<zod.ZodString>;
@@ -87,18 +103,19 @@ declare const memberCards: {
             labelRef: zod.ZodString;
             name: zod.ZodString;
         }, "strip", zod.ZodTypeAny, {
-            name: string;
             labelRef: string;
-        }, {
             name: string;
+        }, {
             labelRef: string;
+            name: string;
         }>, "many">;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        state: "active" | "not_enrolled" | "closed";
+        authState: "authenticated" | "unauthenticated";
+        state: "unknown" | "active" | "not_enrolled" | "closed";
         labels: {
-            name: string;
             labelRef: string;
+            name: string;
         }[];
         displayName?: string | undefined;
         avatarUrl?: string | undefined;
@@ -107,10 +124,11 @@ declare const memberCards: {
         registeredAt?: string | undefined;
     }, {
         userId: string;
-        state: "active" | "not_enrolled" | "closed";
+        authState: "authenticated" | "unauthenticated";
+        state: "unknown" | "active" | "not_enrolled" | "closed";
         labels: {
-            name: string;
             labelRef: string;
+            name: string;
         }[];
         displayName?: string | undefined;
         avatarUrl?: string | undefined;
@@ -126,100 +144,168 @@ declare const memberCards: {
         levelName: zod.ZodOptional<zod.ZodString>;
         availablePoints: zod.ZodNumber;
         cardImageUrl: zod.ZodOptional<zod.ZodString>;
+        pointsRuleImageUrl: zod.ZodOptional<zod.ZodString>;
+        pointsRuleContent: zod.ZodOptional<zod.ZodString>;
+        pointsUrl: zod.ZodOptional<zod.ZodString>;
+        presentation: zod.ZodOptional<zod.ZodObject<{
+            variant: zod.ZodEnum<["blue", "silver", "gold", "black"]>;
+            labelsEmbedded: zod.ZodOptional<zod.ZodBoolean>;
+        }, "strip", zod.ZodTypeAny, {
+            variant: "silver" | "gold" | "blue" | "black";
+            labelsEmbedded?: boolean | undefined;
+        }, {
+            variant: "silver" | "gold" | "blue" | "black";
+            labelsEmbedded?: boolean | undefined;
+        }>>;
+        progress: zod.ZodOptional<zod.ZodObject<{
+            daySpentCents: zod.ZodNumber;
+            yearSpentCents: zod.ZodNumber;
+            percent: zod.ZodNumber;
+            message: zod.ZodString;
+        }, "strip", zod.ZodTypeAny, {
+            message: string;
+            daySpentCents: number;
+            yearSpentCents: number;
+            percent: number;
+        }, {
+            message: string;
+            daySpentCents: number;
+            yearSpentCents: number;
+            percent: number;
+        }>>;
+        benefits: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
+            benefitRef: zod.ZodString;
+            name: zod.ZodString;
+            iconUrl: zod.ZodOptional<zod.ZodString>;
+            description: zod.ZodOptional<zod.ZodString>;
+            action: zod.ZodOptional<zod.ZodObject<{
+                kind: zod.ZodEnum<["miniapp", "dialog", "toast"]>;
+                url: zod.ZodOptional<zod.ZodString>;
+                title: zod.ZodOptional<zod.ZodString>;
+                text: zod.ZodOptional<zod.ZodString>;
+            }, "strip", zod.ZodTypeAny, {
+                kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
+                url?: string | undefined;
+                text?: string | undefined;
+            }, {
+                kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
+                url?: string | undefined;
+                text?: string | undefined;
+            }>>;
+        }, "strip", zod.ZodTypeAny, {
+            name: string;
+            benefitRef: string;
+            description?: string | undefined;
+            action?: {
+                kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
+                url?: string | undefined;
+                text?: string | undefined;
+            } | undefined;
+            iconUrl?: string | undefined;
+        }, {
+            name: string;
+            benefitRef: string;
+            description?: string | undefined;
+            action?: {
+                kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
+                url?: string | undefined;
+                text?: string | undefined;
+            } | undefined;
+            iconUrl?: string | undefined;
+        }>, "many">>;
+        preferencePrompts: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
+            value: zod.ZodEnum<["我常来买衣服", "我常带娃来玩", "我常来吃美食"]>;
+            query: zod.ZodString;
+        }, "strip", zod.ZodTypeAny, {
+            value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+            query: string;
+        }, {
+            value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+            query: string;
+        }>, "many">>;
     }, "strip", zod.ZodTypeAny, {
-        status: "unknown" | "active" | "inactive" | "frozen" | "expired";
         userId: string;
+        status: "unknown" | "active" | "inactive" | "frozen" | "expired";
         cardRef: string;
         cardDisplay: string;
         availablePoints: number;
+        presentation?: {
+            variant: "silver" | "gold" | "blue" | "black";
+            labelsEmbedded?: boolean | undefined;
+        } | undefined;
         levelName?: string | undefined;
         cardImageUrl?: string | undefined;
+        pointsRuleImageUrl?: string | undefined;
+        pointsRuleContent?: string | undefined;
+        pointsUrl?: string | undefined;
+        progress?: {
+            message: string;
+            daySpentCents: number;
+            yearSpentCents: number;
+            percent: number;
+        } | undefined;
+        benefits?: {
+            name: string;
+            benefitRef: string;
+            description?: string | undefined;
+            action?: {
+                kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
+                url?: string | undefined;
+                text?: string | undefined;
+            } | undefined;
+            iconUrl?: string | undefined;
+        }[] | undefined;
+        preferencePrompts?: {
+            value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+            query: string;
+        }[] | undefined;
     }, {
-        status: "unknown" | "active" | "inactive" | "frozen" | "expired";
         userId: string;
+        status: "unknown" | "active" | "inactive" | "frozen" | "expired";
         cardRef: string;
         cardDisplay: string;
         availablePoints: number;
+        presentation?: {
+            variant: "silver" | "gold" | "blue" | "black";
+            labelsEmbedded?: boolean | undefined;
+        } | undefined;
         levelName?: string | undefined;
         cardImageUrl?: string | undefined;
-    }>>;
-    readonly 'member-coupon-list': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
-        userId: zod.ZodString;
-        items: zod.ZodArray<zod.ZodObject<{
-            couponRef: zod.ZodString;
-            title: zod.ZodString;
-            type: zod.ZodEnum<["amount", "discount", "gift", "parking", "unknown"]>;
-            status: zod.ZodEnum<["effective", "used", "expired", "invalid", "unknown"]>;
-            benefitText: zod.ZodOptional<zod.ZodString>;
-            thresholdText: zod.ZodOptional<zod.ZodString>;
-        }, "strip", zod.ZodTypeAny, {
-            type: "unknown" | "amount" | "discount" | "gift" | "parking";
-            status: "unknown" | "expired" | "effective" | "used" | "invalid";
-            title: string;
-            couponRef: string;
-            benefitText?: string | undefined;
-            thresholdText?: string | undefined;
-        }, {
-            type: "unknown" | "amount" | "discount" | "gift" | "parking";
-            status: "unknown" | "expired" | "effective" | "used" | "invalid";
-            title: string;
-            couponRef: string;
-            benefitText?: string | undefined;
-            thresholdText?: string | undefined;
-        }>, "many">;
-        total: zod.ZodNumber;
-    }, "strip", zod.ZodTypeAny, {
-        userId: string;
-        total: number;
-        items: {
-            type: "unknown" | "amount" | "discount" | "gift" | "parking";
-            status: "unknown" | "expired" | "effective" | "used" | "invalid";
-            title: string;
-            couponRef: string;
-            benefitText?: string | undefined;
-            thresholdText?: string | undefined;
-        }[];
-    }, {
-        userId: string;
-        total: number;
-        items: {
-            type: "unknown" | "amount" | "discount" | "gift" | "parking";
-            status: "unknown" | "expired" | "effective" | "used" | "invalid";
-            title: string;
-            couponRef: string;
-            benefitText?: string | undefined;
-            thresholdText?: string | undefined;
-        }[];
-    }>>;
-    readonly 'member-coupon-detail': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
-        couponRef: zod.ZodString;
-        title: zod.ZodString;
-        type: zod.ZodEnum<["amount", "discount", "gift", "parking", "unknown"]>;
-        status: zod.ZodEnum<["effective", "used", "expired", "invalid", "unknown"]>;
-        description: zod.ZodOptional<zod.ZodString>;
-        benefitText: zod.ZodOptional<zod.ZodString>;
-        thresholdText: zod.ZodOptional<zod.ZodString>;
-    }, "strip", zod.ZodTypeAny, {
-        type: "unknown" | "amount" | "discount" | "gift" | "parking";
-        status: "unknown" | "expired" | "effective" | "used" | "invalid";
-        title: string;
-        couponRef: string;
-        description?: string | undefined;
-        benefitText?: string | undefined;
-        thresholdText?: string | undefined;
-    }, {
-        type: "unknown" | "amount" | "discount" | "gift" | "parking";
-        status: "unknown" | "expired" | "effective" | "used" | "invalid";
-        title: string;
-        couponRef: string;
-        description?: string | undefined;
-        benefitText?: string | undefined;
-        thresholdText?: string | undefined;
+        pointsRuleImageUrl?: string | undefined;
+        pointsRuleContent?: string | undefined;
+        pointsUrl?: string | undefined;
+        progress?: {
+            message: string;
+            daySpentCents: number;
+            yearSpentCents: number;
+            percent: number;
+        } | undefined;
+        benefits?: {
+            name: string;
+            benefitRef: string;
+            description?: string | undefined;
+            action?: {
+                kind: "toast" | "miniapp" | "dialog";
+                title?: string | undefined;
+                url?: string | undefined;
+                text?: string | undefined;
+            } | undefined;
+            iconUrl?: string | undefined;
+        }[] | undefined;
+        preferencePrompts?: {
+            value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+            query: string;
+        }[] | undefined;
     }>>;
     readonly 'member-point-usage-list': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
         userId: zod.ZodString;
         balance: zod.ZodNumber;
-        level: zod.ZodEnum<["silver", "gold", "platinum"]>;
+        membershipLabel: zod.ZodOptional<zod.ZodString>;
         items: zod.ZodArray<zod.ZodObject<{
             usageRecordRef: zod.ZodString;
             title: zod.ZodString;
@@ -227,111 +313,225 @@ declare const memberCards: {
             usedAt: zod.ZodOptional<zod.ZodString>;
             description: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
-            amount: string;
-            title: string;
             usageRecordRef: string;
-            description?: string | undefined;
+            title: string;
+            amount: string;
             usedAt?: string | undefined;
+            description?: string | undefined;
         }, {
-            amount: string;
-            title: string;
             usageRecordRef: string;
-            description?: string | undefined;
+            title: string;
+            amount: string;
             usedAt?: string | undefined;
+            description?: string | undefined;
         }>, "many">;
         total: zod.ZodNumber;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        total: number;
+        balance: number;
         items: {
-            amount: string;
-            title: string;
             usageRecordRef: string;
-            description?: string | undefined;
+            title: string;
+            amount: string;
             usedAt?: string | undefined;
+            description?: string | undefined;
         }[];
-        balance: number;
-        level: "silver" | "gold" | "platinum";
+        total: number;
+        membershipLabel?: string | undefined;
     }, {
         userId: string;
-        total: number;
+        balance: number;
         items: {
-            amount: string;
-            title: string;
             usageRecordRef: string;
-            description?: string | undefined;
+            title: string;
+            amount: string;
             usedAt?: string | undefined;
+            description?: string | undefined;
         }[];
-        balance: number;
-        level: "silver" | "gold" | "platinum";
+        total: number;
+        membershipLabel?: string | undefined;
     }>>;
     readonly 'member-enrollment-form': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
         userId: zod.ZodString;
-        state: zod.ZodEnum<["active", "not_enrolled", "closed"]>;
+        state: zod.ZodEnum<["unknown", "active", "not_enrolled", "closed"]>;
+        formVersion: zod.ZodString;
         fields: zod.ZodArray<zod.ZodObject<{
             fieldId: zod.ZodString;
             label: zod.ZodString;
+            type: zod.ZodEnum<["text", "tel", "select", "date"]>;
             required: zod.ZodBoolean;
+            readOnly: zod.ZodOptional<zod.ZodBoolean>;
+            prefill: zod.ZodOptional<zod.ZodString>;
+            placeholder: zod.ZodOptional<zod.ZodString>;
+            options: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
         }, "strip", zod.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">;
+        consents: zod.ZodArray<zod.ZodObject<{
+            consentId: zod.ZodString;
+            version: zod.ZodString;
+            title: zod.ZodString;
+            required: zod.ZodBoolean;
+            url: zod.ZodOptional<zod.ZodString>;
+        }, "strip", zod.ZodTypeAny, {
+            title: string;
+            required: boolean;
+            version: string;
+            consentId: string;
+            url?: string | undefined;
+        }, {
+            title: string;
+            required: boolean;
+            version: string;
+            consentId: string;
+            url?: string | undefined;
         }>, "many">;
-        actionId: zod.ZodString;
+        authorization: zod.ZodObject<{
+            status: zod.ZodEnum<["required", "authorized", "unavailable"]>;
+            mobileMasked: zod.ZodOptional<zod.ZodString>;
+        }, "strip", zod.ZodTypeAny, {
+            status: "required" | "unavailable" | "authorized";
+            mobileMasked?: string | undefined;
+        }, {
+            status: "required" | "unavailable" | "authorized";
+            mobileMasked?: string | undefined;
+        }>;
+        manualNotice: zod.ZodOptional<zod.ZodString>;
     }, "strip", zod.ZodTypeAny, {
         userId: string;
-        actionId: string;
-        state: "active" | "not_enrolled" | "closed";
+        state: "unknown" | "active" | "not_enrolled" | "closed";
+        authorization: {
+            status: "required" | "unavailable" | "authorized";
+            mobileMasked?: string | undefined;
+        };
         fields: {
+            type: "date" | "text" | "tel" | "select";
             required: boolean;
             label: string;
             fieldId: string;
+            options?: string[] | undefined;
+            readOnly?: boolean | undefined;
+            prefill?: string | undefined;
+            placeholder?: string | undefined;
         }[];
+        formVersion: string;
+        consents: {
+            title: string;
+            required: boolean;
+            version: string;
+            consentId: string;
+            url?: string | undefined;
+        }[];
+        manualNotice?: string | undefined;
     }, {
         userId: string;
-        actionId: string;
-        state: "active" | "not_enrolled" | "closed";
+        state: "unknown" | "active" | "not_enrolled" | "closed";
+        authorization: {
+            status: "required" | "unavailable" | "authorized";
+            mobileMasked?: string | undefined;
+        };
         fields: {
+            type: "date" | "text" | "tel" | "select";
             required: boolean;
             label: string;
             fieldId: string;
+            options?: string[] | undefined;
+            readOnly?: boolean | undefined;
+            prefill?: string | undefined;
+            placeholder?: string | undefined;
+        }[];
+        formVersion: string;
+        consents: {
+            title: string;
+            required: boolean;
+            version: string;
+            consentId: string;
+            url?: string | undefined;
         }[];
+        manualNotice?: string | undefined;
     }>>;
     readonly 'member-enrollment-status': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
         userId: zod.ZodString;
-        success: zod.ZodBoolean;
+        attemptRef: zod.ZodOptional<zod.ZodString>;
+        state: zod.ZodEnum<["pending_confirmation", "confirmation_timeout", "active", "failed"]>;
         memberRef: zod.ZodOptional<zod.ZodString>;
         message: zod.ZodOptional<zod.ZodString>;
-        state: zod.ZodEnum<["active", "not_enrolled", "closed"]>;
     }, "strip", zod.ZodTypeAny, {
-        success: boolean;
         userId: string;
-        state: "active" | "not_enrolled" | "closed";
-        message?: string | undefined;
+        state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
         memberRef?: string | undefined;
+        message?: string | undefined;
+        attemptRef?: string | undefined;
     }, {
-        success: boolean;
         userId: string;
-        state: "active" | "not_enrolled" | "closed";
-        message?: string | undefined;
+        state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
         memberRef?: string | undefined;
+        message?: string | undefined;
+        attemptRef?: string | undefined;
+    }>>;
+    readonly 'member-enrollment-cta': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+        userId: zod.ZodString;
+        authState: zod.ZodLiteral<"authenticated">;
+        state: zod.ZodEnum<["not_enrolled", "closed"]>;
+        enrollUrl: zod.ZodOptional<zod.ZodEffects<zod.ZodString, string, string>>;
+        title: zod.ZodOptional<zod.ZodString>;
+        subtitle: zod.ZodOptional<zod.ZodString>;
+        perks: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+    }, "strip", zod.ZodTypeAny, {
+        userId: string;
+        authState: "authenticated";
+        state: "not_enrolled" | "closed";
+        title?: string | undefined;
+        subtitle?: string | undefined;
+        enrollUrl?: string | undefined;
+        perks?: string[] | undefined;
+    }, {
+        userId: string;
+        authState: "authenticated";
+        state: "not_enrolled" | "closed";
+        title?: string | undefined;
+        subtitle?: string | undefined;
+        enrollUrl?: string | undefined;
+        perks?: string[] | undefined;
+    }>>;
+    readonly 'member-login-cta': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+        loginUrl: zod.ZodOptional<zod.ZodEffects<zod.ZodString, string, string>>;
+        title: zod.ZodOptional<zod.ZodString>;
+    }, "strip", zod.ZodTypeAny, {
+        title?: string | undefined;
+        loginUrl?: string | undefined;
+    }, {
+        title?: string | undefined;
+        loginUrl?: string | undefined;
     }>>;
 };
 
 /** 模块注册入口：自注册闭环（与客户端 clientModule 对称） */
 declare const serverModule: {
     declaration: {
-        componentId: string;
-        features: string[];
+        moduleId: string;
     };
     cards: {
         readonly 'member-info': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
             userId: zod.ZodString;
-            state: zod.ZodEnum<["active", "not_enrolled", "closed"]>;
+            authState: zod.ZodEnum<["authenticated", "unauthenticated"]>;
+            state: zod.ZodEnum<["unknown", "active", "not_enrolled", "closed"]>;
             displayName: zod.ZodOptional<zod.ZodString>;
             avatarUrl: zod.ZodOptional<zod.ZodString>;
             contactDisplay: zod.ZodOptional<zod.ZodString>;
@@ -341,18 +541,19 @@ declare const serverModule: {
                 labelRef: zod.ZodString;
                 name: zod.ZodString;
             }, "strip", zod.ZodTypeAny, {
-                name: string;
                 labelRef: string;
-            }, {
                 name: string;
+            }, {
                 labelRef: string;
+                name: string;
             }>, "many">;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            state: "active" | "not_enrolled" | "closed";
+            authState: "authenticated" | "unauthenticated";
+            state: "unknown" | "active" | "not_enrolled" | "closed";
             labels: {
-                name: string;
                 labelRef: string;
+                name: string;
             }[];
             displayName?: string | undefined;
             avatarUrl?: string | undefined;
@@ -361,10 +562,11 @@ declare const serverModule: {
             registeredAt?: string | undefined;
         }, {
             userId: string;
-            state: "active" | "not_enrolled" | "closed";
+            authState: "authenticated" | "unauthenticated";
+            state: "unknown" | "active" | "not_enrolled" | "closed";
             labels: {
-                name: string;
                 labelRef: string;
+                name: string;
             }[];
             displayName?: string | undefined;
             avatarUrl?: string | undefined;
@@ -380,100 +582,168 @@ declare const serverModule: {
             levelName: zod.ZodOptional<zod.ZodString>;
             availablePoints: zod.ZodNumber;
             cardImageUrl: zod.ZodOptional<zod.ZodString>;
+            pointsRuleImageUrl: zod.ZodOptional<zod.ZodString>;
+            pointsRuleContent: zod.ZodOptional<zod.ZodString>;
+            pointsUrl: zod.ZodOptional<zod.ZodString>;
+            presentation: zod.ZodOptional<zod.ZodObject<{
+                variant: zod.ZodEnum<["blue", "silver", "gold", "black"]>;
+                labelsEmbedded: zod.ZodOptional<zod.ZodBoolean>;
+            }, "strip", zod.ZodTypeAny, {
+                variant: "silver" | "gold" | "blue" | "black";
+                labelsEmbedded?: boolean | undefined;
+            }, {
+                variant: "silver" | "gold" | "blue" | "black";
+                labelsEmbedded?: boolean | undefined;
+            }>>;
+            progress: zod.ZodOptional<zod.ZodObject<{
+                daySpentCents: zod.ZodNumber;
+                yearSpentCents: zod.ZodNumber;
+                percent: zod.ZodNumber;
+                message: zod.ZodString;
+            }, "strip", zod.ZodTypeAny, {
+                message: string;
+                daySpentCents: number;
+                yearSpentCents: number;
+                percent: number;
+            }, {
+                message: string;
+                daySpentCents: number;
+                yearSpentCents: number;
+                percent: number;
+            }>>;
+            benefits: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
+                benefitRef: zod.ZodString;
+                name: zod.ZodString;
+                iconUrl: zod.ZodOptional<zod.ZodString>;
+                description: zod.ZodOptional<zod.ZodString>;
+                action: zod.ZodOptional<zod.ZodObject<{
+                    kind: zod.ZodEnum<["miniapp", "dialog", "toast"]>;
+                    url: zod.ZodOptional<zod.ZodString>;
+                    title: zod.ZodOptional<zod.ZodString>;
+                    text: zod.ZodOptional<zod.ZodString>;
+                }, "strip", zod.ZodTypeAny, {
+                    kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
+                    url?: string | undefined;
+                    text?: string | undefined;
+                }, {
+                    kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
+                    url?: string | undefined;
+                    text?: string | undefined;
+                }>>;
+            }, "strip", zod.ZodTypeAny, {
+                name: string;
+                benefitRef: string;
+                description?: string | undefined;
+                action?: {
+                    kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
+                    url?: string | undefined;
+                    text?: string | undefined;
+                } | undefined;
+                iconUrl?: string | undefined;
+            }, {
+                name: string;
+                benefitRef: string;
+                description?: string | undefined;
+                action?: {
+                    kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
+                    url?: string | undefined;
+                    text?: string | undefined;
+                } | undefined;
+                iconUrl?: string | undefined;
+            }>, "many">>;
+            preferencePrompts: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
+                value: zod.ZodEnum<["我常来买衣服", "我常带娃来玩", "我常来吃美食"]>;
+                query: zod.ZodString;
+            }, "strip", zod.ZodTypeAny, {
+                value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+                query: string;
+            }, {
+                value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+                query: string;
+            }>, "many">>;
         }, "strip", zod.ZodTypeAny, {
-            status: "unknown" | "active" | "inactive" | "frozen" | "expired";
             userId: string;
+            status: "unknown" | "active" | "inactive" | "frozen" | "expired";
             cardRef: string;
             cardDisplay: string;
             availablePoints: number;
+            presentation?: {
+                variant: "silver" | "gold" | "blue" | "black";
+                labelsEmbedded?: boolean | undefined;
+            } | undefined;
             levelName?: string | undefined;
             cardImageUrl?: string | undefined;
+            pointsRuleImageUrl?: string | undefined;
+            pointsRuleContent?: string | undefined;
+            pointsUrl?: string | undefined;
+            progress?: {
+                message: string;
+                daySpentCents: number;
+                yearSpentCents: number;
+                percent: number;
+            } | undefined;
+            benefits?: {
+                name: string;
+                benefitRef: string;
+                description?: string | undefined;
+                action?: {
+                    kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
+                    url?: string | undefined;
+                    text?: string | undefined;
+                } | undefined;
+                iconUrl?: string | undefined;
+            }[] | undefined;
+            preferencePrompts?: {
+                value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+                query: string;
+            }[] | undefined;
         }, {
-            status: "unknown" | "active" | "inactive" | "frozen" | "expired";
             userId: string;
+            status: "unknown" | "active" | "inactive" | "frozen" | "expired";
             cardRef: string;
             cardDisplay: string;
             availablePoints: number;
+            presentation?: {
+                variant: "silver" | "gold" | "blue" | "black";
+                labelsEmbedded?: boolean | undefined;
+            } | undefined;
             levelName?: string | undefined;
             cardImageUrl?: string | undefined;
-        }>>;
-        readonly 'member-coupon-list': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
-            userId: zod.ZodString;
-            items: zod.ZodArray<zod.ZodObject<{
-                couponRef: zod.ZodString;
-                title: zod.ZodString;
-                type: zod.ZodEnum<["amount", "discount", "gift", "parking", "unknown"]>;
-                status: zod.ZodEnum<["effective", "used", "expired", "invalid", "unknown"]>;
-                benefitText: zod.ZodOptional<zod.ZodString>;
-                thresholdText: zod.ZodOptional<zod.ZodString>;
-            }, "strip", zod.ZodTypeAny, {
-                type: "unknown" | "amount" | "discount" | "gift" | "parking";
-                status: "unknown" | "expired" | "effective" | "used" | "invalid";
-                title: string;
-                couponRef: string;
-                benefitText?: string | undefined;
-                thresholdText?: string | undefined;
-            }, {
-                type: "unknown" | "amount" | "discount" | "gift" | "parking";
-                status: "unknown" | "expired" | "effective" | "used" | "invalid";
-                title: string;
-                couponRef: string;
-                benefitText?: string | undefined;
-                thresholdText?: string | undefined;
-            }>, "many">;
-            total: zod.ZodNumber;
-        }, "strip", zod.ZodTypeAny, {
-            userId: string;
-            total: number;
-            items: {
-                type: "unknown" | "amount" | "discount" | "gift" | "parking";
-                status: "unknown" | "expired" | "effective" | "used" | "invalid";
-                title: string;
-                couponRef: string;
-                benefitText?: string | undefined;
-                thresholdText?: string | undefined;
-            }[];
-        }, {
-            userId: string;
-            total: number;
-            items: {
-                type: "unknown" | "amount" | "discount" | "gift" | "parking";
-                status: "unknown" | "expired" | "effective" | "used" | "invalid";
-                title: string;
-                couponRef: string;
-                benefitText?: string | undefined;
-                thresholdText?: string | undefined;
-            }[];
-        }>>;
-        readonly 'member-coupon-detail': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
-            couponRef: zod.ZodString;
-            title: zod.ZodString;
-            type: zod.ZodEnum<["amount", "discount", "gift", "parking", "unknown"]>;
-            status: zod.ZodEnum<["effective", "used", "expired", "invalid", "unknown"]>;
-            description: zod.ZodOptional<zod.ZodString>;
-            benefitText: zod.ZodOptional<zod.ZodString>;
-            thresholdText: zod.ZodOptional<zod.ZodString>;
-        }, "strip", zod.ZodTypeAny, {
-            type: "unknown" | "amount" | "discount" | "gift" | "parking";
-            status: "unknown" | "expired" | "effective" | "used" | "invalid";
-            title: string;
-            couponRef: string;
-            description?: string | undefined;
-            benefitText?: string | undefined;
-            thresholdText?: string | undefined;
-        }, {
-            type: "unknown" | "amount" | "discount" | "gift" | "parking";
-            status: "unknown" | "expired" | "effective" | "used" | "invalid";
-            title: string;
-            couponRef: string;
-            description?: string | undefined;
-            benefitText?: string | undefined;
-            thresholdText?: string | undefined;
+            pointsRuleImageUrl?: string | undefined;
+            pointsRuleContent?: string | undefined;
+            pointsUrl?: string | undefined;
+            progress?: {
+                message: string;
+                daySpentCents: number;
+                yearSpentCents: number;
+                percent: number;
+            } | undefined;
+            benefits?: {
+                name: string;
+                benefitRef: string;
+                description?: string | undefined;
+                action?: {
+                    kind: "toast" | "miniapp" | "dialog";
+                    title?: string | undefined;
+                    url?: string | undefined;
+                    text?: string | undefined;
+                } | undefined;
+                iconUrl?: string | undefined;
+            }[] | undefined;
+            preferencePrompts?: {
+                value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+                query: string;
+            }[] | undefined;
         }>>;
         readonly 'member-point-usage-list': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
             userId: zod.ZodString;
             balance: zod.ZodNumber;
-            level: zod.ZodEnum<["silver", "gold", "platinum"]>;
+            membershipLabel: zod.ZodOptional<zod.ZodString>;
             items: zod.ZodArray<zod.ZodObject<{
                 usageRecordRef: zod.ZodString;
                 title: zod.ZodString;
@@ -481,118 +751,219 @@ declare const serverModule: {
                 usedAt: zod.ZodOptional<zod.ZodString>;
                 description: zod.ZodOptional<zod.ZodString>;
             }, "strip", zod.ZodTypeAny, {
-                amount: string;
-                title: string;
                 usageRecordRef: string;
-                description?: string | undefined;
+                title: string;
+                amount: string;
                 usedAt?: string | undefined;
+                description?: string | undefined;
             }, {
-                amount: string;
-                title: string;
                 usageRecordRef: string;
-                description?: string | undefined;
+                title: string;
+                amount: string;
                 usedAt?: string | undefined;
+                description?: string | undefined;
             }>, "many">;
             total: zod.ZodNumber;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            total: number;
+            balance: number;
             items: {
-                amount: string;
-                title: string;
                 usageRecordRef: string;
-                description?: string | undefined;
+                title: string;
+                amount: string;
                 usedAt?: string | undefined;
+                description?: string | undefined;
             }[];
-            balance: number;
-            level: "silver" | "gold" | "platinum";
+            total: number;
+            membershipLabel?: string | undefined;
         }, {
             userId: string;
-            total: number;
+            balance: number;
             items: {
-                amount: string;
-                title: string;
                 usageRecordRef: string;
-                description?: string | undefined;
+                title: string;
+                amount: string;
                 usedAt?: string | undefined;
+                description?: string | undefined;
             }[];
-            balance: number;
-            level: "silver" | "gold" | "platinum";
+            total: number;
+            membershipLabel?: string | undefined;
         }>>;
         readonly 'member-enrollment-form': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
             userId: zod.ZodString;
-            state: zod.ZodEnum<["active", "not_enrolled", "closed"]>;
+            state: zod.ZodEnum<["unknown", "active", "not_enrolled", "closed"]>;
+            formVersion: zod.ZodString;
             fields: zod.ZodArray<zod.ZodObject<{
                 fieldId: zod.ZodString;
                 label: zod.ZodString;
+                type: zod.ZodEnum<["text", "tel", "select", "date"]>;
                 required: zod.ZodBoolean;
+                readOnly: zod.ZodOptional<zod.ZodBoolean>;
+                prefill: zod.ZodOptional<zod.ZodString>;
+                placeholder: zod.ZodOptional<zod.ZodString>;
+                options: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
             }, "strip", zod.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">;
+            consents: zod.ZodArray<zod.ZodObject<{
+                consentId: zod.ZodString;
+                version: zod.ZodString;
+                title: zod.ZodString;
+                required: zod.ZodBoolean;
+                url: zod.ZodOptional<zod.ZodString>;
+            }, "strip", zod.ZodTypeAny, {
+                title: string;
+                required: boolean;
+                version: string;
+                consentId: string;
+                url?: string | undefined;
+            }, {
+                title: string;
+                required: boolean;
+                version: string;
+                consentId: string;
+                url?: string | undefined;
             }>, "many">;
-            actionId: zod.ZodString;
+            authorization: zod.ZodObject<{
+                status: zod.ZodEnum<["required", "authorized", "unavailable"]>;
+                mobileMasked: zod.ZodOptional<zod.ZodString>;
+            }, "strip", zod.ZodTypeAny, {
+                status: "required" | "unavailable" | "authorized";
+                mobileMasked?: string | undefined;
+            }, {
+                status: "required" | "unavailable" | "authorized";
+                mobileMasked?: string | undefined;
+            }>;
+            manualNotice: zod.ZodOptional<zod.ZodString>;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
-            actionId: string;
-            state: "active" | "not_enrolled" | "closed";
+            state: "unknown" | "active" | "not_enrolled" | "closed";
+            authorization: {
+                status: "required" | "unavailable" | "authorized";
+                mobileMasked?: string | undefined;
+            };
             fields: {
+                type: "date" | "text" | "tel" | "select";
                 required: boolean;
                 label: string;
                 fieldId: string;
+                options?: string[] | undefined;
+                readOnly?: boolean | undefined;
+                prefill?: string | undefined;
+                placeholder?: string | undefined;
             }[];
+            formVersion: string;
+            consents: {
+                title: string;
+                required: boolean;
+                version: string;
+                consentId: string;
+                url?: string | undefined;
+            }[];
+            manualNotice?: string | undefined;
         }, {
             userId: string;
-            actionId: string;
-            state: "active" | "not_enrolled" | "closed";
+            state: "unknown" | "active" | "not_enrolled" | "closed";
+            authorization: {
+                status: "required" | "unavailable" | "authorized";
+                mobileMasked?: string | undefined;
+            };
             fields: {
+                type: "date" | "text" | "tel" | "select";
                 required: boolean;
                 label: string;
                 fieldId: string;
+                options?: string[] | undefined;
+                readOnly?: boolean | undefined;
+                prefill?: string | undefined;
+                placeholder?: string | undefined;
+            }[];
+            formVersion: string;
+            consents: {
+                title: string;
+                required: boolean;
+                version: string;
+                consentId: string;
+                url?: string | undefined;
             }[];
+            manualNotice?: string | undefined;
         }>>;
         readonly 'member-enrollment-status': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
             userId: zod.ZodString;
-            success: zod.ZodBoolean;
+            attemptRef: zod.ZodOptional<zod.ZodString>;
+            state: zod.ZodEnum<["pending_confirmation", "confirmation_timeout", "active", "failed"]>;
             memberRef: zod.ZodOptional<zod.ZodString>;
             message: zod.ZodOptional<zod.ZodString>;
-            state: zod.ZodEnum<["active", "not_enrolled", "closed"]>;
         }, "strip", zod.ZodTypeAny, {
-            success: boolean;
             userId: string;
-            state: "active" | "not_enrolled" | "closed";
-            message?: string | undefined;
+            state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
             memberRef?: string | undefined;
+            message?: string | undefined;
+            attemptRef?: string | undefined;
         }, {
-            success: boolean;
             userId: string;
-            state: "active" | "not_enrolled" | "closed";
-            message?: string | undefined;
+            state: "active" | "failed" | "pending_confirmation" | "confirmation_timeout";
             memberRef?: string | undefined;
+            message?: string | undefined;
+            attemptRef?: string | undefined;
         }>>;
-    };
-    preTools: {
-        queryPoints: PreToolDef<_mastra_core_tools.Tool<{
+        readonly 'member-enrollment-cta': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+            userId: zod.ZodString;
+            authState: zod.ZodLiteral<"authenticated">;
+            state: zod.ZodEnum<["not_enrolled", "closed"]>;
+            enrollUrl: zod.ZodOptional<zod.ZodEffects<zod.ZodString, string, string>>;
+            title: zod.ZodOptional<zod.ZodString>;
+            subtitle: zod.ZodOptional<zod.ZodString>;
+            perks: zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+        }, "strip", zod.ZodTypeAny, {
             userId: string;
+            authState: "authenticated";
+            state: "not_enrolled" | "closed";
+            title?: string | undefined;
+            subtitle?: string | undefined;
+            enrollUrl?: string | undefined;
+            perks?: string[] | undefined;
         }, {
             userId: string;
-            total: number;
-            items: {
-                amount: string;
-                title: string;
-                usageRecordRef: string;
-                description?: string | undefined;
-                usedAt?: string | undefined;
-            }[];
-            balance: number;
-            level: "silver" | "gold" | "platinum";
-        }, unknown, unknown, _mastra_core_tools.ToolExecutionContext<unknown, unknown, unknown>, "queryPoints", unknown>>;
+            authState: "authenticated";
+            state: "not_enrolled" | "closed";
+            title?: string | undefined;
+            subtitle?: string | undefined;
+            enrollUrl?: string | undefined;
+            perks?: string[] | undefined;
+        }>>;
+        readonly 'member-login-cta': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+            loginUrl: zod.ZodOptional<zod.ZodEffects<zod.ZodString, string, string>>;
+            title: zod.ZodOptional<zod.ZodString>;
+        }, "strip", zod.ZodTypeAny, {
+            title?: string | undefined;
+            loginUrl?: string | undefined;
+        }, {
+            title?: string | undefined;
+            loginUrl?: string | undefined;
+        }>>;
+    };
+    preTools: {};
+    skills: {
+        [k: string]: _tbox_cn_app_sdk_server.LocalSkill;
     };
     register(ctx: ServerContext): void;
 };
 
-export { InMemoryMemberService, type MemberService, memberCards, serverModule };
+export { InMemoryMemberService, type MemberAccountService, type MemberEnrollmentService, type MemberService, memberCards, resolveMemberAccountPort, resolveMemberBenefitsPort, resolveMemberCardPort, resolveMemberEnrollmentPort, resolveMemberProfilePort, serverModule };