@tbox.cn/app-module-member 0.1.0 → 0.8.6

package/dist/server/index.d.ts

@@ -1,28 +1,40 @@
+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 { CardMeta } from '@tbox.cn/app-contracts';
+import { RequestContext } from '@tbox.cn/app-contracts';
 import * as zod from 'zod';
-import { z } from 'zod';
-import { ServerContext } from '@tbox.cn/app-sdk/server';
-import { MemberQueryPort, MemberSettlementPort, Points, DiscountRule } 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：商圈会员完整实现。
+ * MemberService：商圈会员完整实现（011 K2 六 Port + 015 入会升级）。
  * extends 契约 Port（保证满足消费方子集约束）；完整接口只在本模块包内。
  */
-interface MemberService extends MemberQueryPort, MemberSettlementPort {
-    /** 积分变动记录（单测/观测用） */
-    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） */
+
+/** 仅供隔离单测使用的 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;
@@ -30,53 +42,928 @@ declare class InMemoryMemberService implements MemberService {
         key?: string;
     }[];
     constructor(initial?: Record<string, number>);
+    getAccount(userId: string): Promise<MemberAccountSnapshot>;
+    getProfile(userId: string): Promise<MemberProfileSnapshot>;
+    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;
+    }>;
     queryDiscount(userId: string): Promise<DiscountRule | undefined>;
     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>;
-    private levelOf;
-    private maybeUpgrade;
-    private levelChangeListeners;
-    onLevelChange(fn: (e: {
-        userId: string;
-        newLevel: 'silver' | 'gold' | 'platinum';
-    }) => void): void;
+    enroll(input: MemberEnrollmentInput): Promise<MemberEnrollmentResult>;
+    getEnrollmentStatus(userId: string, attemptRef: string): Promise<{
+        status: MemberEnrollmentStatus;
+        memberRef?: string;
+        reason?: string;
+    }>;
 }
 
-declare const dataSchema: z.ZodObject<{
-    userId: z.ZodString;
-    balance: z.ZodNumber;
-    level: z.ZodEnum<["silver", "gold", "platinum"]>;
-}, "strip", z.ZodTypeAny, {
-    userId: string;
-    balance: number;
-    level: "silver" | "gold" | "platinum";
-}, {
-    userId: string;
-    balance: number;
-    level: "silver" | "gold" | "platinum";
-}>;
-declare const meta: CardMeta<typeof dataSchema>;
+/**
+ * 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;
+        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>;
+        memberRef: zod.ZodOptional<zod.ZodString>;
+        registeredAt: zod.ZodOptional<zod.ZodString>;
+        labels: zod.ZodArray<zod.ZodObject<{
+            labelRef: zod.ZodString;
+            name: zod.ZodString;
+        }, "strip", zod.ZodTypeAny, {
+            name: string;
+            labelRef: string;
+        }, {
+            name: string;
+            labelRef: string;
+        }>, "many">;
+    }, "strip", zod.ZodTypeAny, {
+        userId: string;
+        state: "unknown" | "active" | "not_enrolled" | "closed";
+        authState: "authenticated" | "unauthenticated";
+        labels: {
+            name: string;
+            labelRef: string;
+        }[];
+        displayName?: string | undefined;
+        avatarUrl?: string | undefined;
+        contactDisplay?: string | undefined;
+        memberRef?: string | undefined;
+        registeredAt?: string | undefined;
+    }, {
+        userId: string;
+        state: "unknown" | "active" | "not_enrolled" | "closed";
+        authState: "authenticated" | "unauthenticated";
+        labels: {
+            name: string;
+            labelRef: string;
+        }[];
+        displayName?: string | undefined;
+        avatarUrl?: string | undefined;
+        contactDisplay?: string | undefined;
+        memberRef?: string | undefined;
+        registeredAt?: string | undefined;
+    }>>;
+    readonly 'member-card-summary': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+        userId: zod.ZodString;
+        cardRef: zod.ZodString;
+        cardDisplay: zod.ZodString;
+        status: zod.ZodEnum<["active", "inactive", "frozen", "expired", "unknown"]>;
+        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";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: string | undefined;
+            }, {
+                kind: "toast" | "miniapp" | "dialog";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: string | undefined;
+            }>>;
+        }, "strip", zod.ZodTypeAny, {
+            name: string;
+            benefitRef: string;
+            description?: string | undefined;
+            action?: {
+                kind: "toast" | "miniapp" | "dialog";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: string | undefined;
+            } | undefined;
+            iconUrl?: string | undefined;
+        }, {
+            name: string;
+            benefitRef: string;
+            description?: string | undefined;
+            action?: {
+                kind: "toast" | "miniapp" | "dialog";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: 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;
+        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";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: string | undefined;
+            } | undefined;
+            iconUrl?: string | undefined;
+        }[] | undefined;
+        preferencePrompts?: {
+            value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+            query: string;
+        }[] | undefined;
+    }, {
+        status: "unknown" | "active" | "inactive" | "frozen" | "expired";
+        userId: string;
+        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";
+                url?: string | undefined;
+                text?: string | undefined;
+                title?: 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;
+        membershipLabel: zod.ZodOptional<zod.ZodString>;
+        items: zod.ZodArray<zod.ZodObject<{
+            usageRecordRef: zod.ZodString;
+            title: zod.ZodString;
+            amount: zod.ZodString;
+            usedAt: zod.ZodOptional<zod.ZodString>;
+            description: zod.ZodOptional<zod.ZodString>;
+        }, "strip", zod.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: zod.ZodNumber;
+    }, "strip", zod.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': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+        userId: zod.ZodString;
+        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, {
+            required: boolean;
+            version: string;
+            title: string;
+            consentId: string;
+            url?: string | undefined;
+        }, {
+            required: boolean;
+            version: string;
+            title: string;
+            consentId: string;
+            url?: string | undefined;
+        }>, "many">;
+        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;
+        authorization: {
+            status: "required" | "unavailable" | "authorized";
+            mobileMasked?: string | undefined;
+        };
+        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;
+            version: string;
+            title: string;
+            consentId: string;
+            url?: string | undefined;
+        }[];
+        manualNotice?: string | undefined;
+    }, {
+        userId: string;
+        authorization: {
+            status: "required" | "unavailable" | "authorized";
+            mobileMasked?: string | undefined;
+        };
+        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;
+            version: string;
+            title: string;
+            consentId: string;
+            url?: string | undefined;
+        }[];
+        manualNotice?: string | undefined;
+    }>>;
+    readonly 'member-enrollment-status': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+        userId: zod.ZodString;
+        attemptRef: zod.ZodOptional<zod.ZodString>;
+        state: zod.ZodEnum<["pending_confirmation", "confirmation_timeout", "active", "failed"]>;
+        memberRef: zod.ZodOptional<zod.ZodString>;
+        message: zod.ZodOptional<zod.ZodString>;
+    }, "strip", zod.ZodTypeAny, {
+        userId: string;
+        state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
+        message?: string | undefined;
+        memberRef?: string | undefined;
+        attemptRef?: string | undefined;
+    }, {
+        userId: string;
+        state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
+        message?: string | undefined;
+        memberRef?: 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;
+        state: "not_enrolled" | "closed";
+        authState: "authenticated";
+        title?: string | undefined;
+        subtitle?: string | undefined;
+        enrollUrl?: string | undefined;
+        perks?: string[] | undefined;
+    }, {
+        userId: string;
+        state: "not_enrolled" | "closed";
+        authState: "authenticated";
+        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: {
+        moduleId: string;
+    };
     cards: {
-        readonly points: _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+        readonly 'member-info': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+            userId: zod.ZodString;
+            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>;
+            memberRef: zod.ZodOptional<zod.ZodString>;
+            registeredAt: zod.ZodOptional<zod.ZodString>;
+            labels: zod.ZodArray<zod.ZodObject<{
+                labelRef: zod.ZodString;
+                name: zod.ZodString;
+            }, "strip", zod.ZodTypeAny, {
+                name: string;
+                labelRef: string;
+            }, {
+                name: string;
+                labelRef: string;
+            }>, "many">;
+        }, "strip", zod.ZodTypeAny, {
+            userId: string;
+            state: "unknown" | "active" | "not_enrolled" | "closed";
+            authState: "authenticated" | "unauthenticated";
+            labels: {
+                name: string;
+                labelRef: string;
+            }[];
+            displayName?: string | undefined;
+            avatarUrl?: string | undefined;
+            contactDisplay?: string | undefined;
+            memberRef?: string | undefined;
+            registeredAt?: string | undefined;
+        }, {
+            userId: string;
+            state: "unknown" | "active" | "not_enrolled" | "closed";
+            authState: "authenticated" | "unauthenticated";
+            labels: {
+                name: string;
+                labelRef: string;
+            }[];
+            displayName?: string | undefined;
+            avatarUrl?: string | undefined;
+            contactDisplay?: string | undefined;
+            memberRef?: string | undefined;
+            registeredAt?: string | undefined;
+        }>>;
+        readonly 'member-card-summary': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+            userId: zod.ZodString;
+            cardRef: zod.ZodString;
+            cardDisplay: zod.ZodString;
+            status: zod.ZodEnum<["active", "inactive", "frozen", "expired", "unknown"]>;
+            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";
+                    url?: string | undefined;
+                    text?: string | undefined;
+                    title?: string | undefined;
+                }, {
+                    kind: "toast" | "miniapp" | "dialog";
+                    url?: string | undefined;
+                    text?: string | undefined;
+                    title?: string | undefined;
+                }>>;
+            }, "strip", zod.ZodTypeAny, {
+                name: string;
+                benefitRef: string;
+                description?: string | undefined;
+                action?: {
+                    kind: "toast" | "miniapp" | "dialog";
+                    url?: string | undefined;
+                    text?: string | undefined;
+                    title?: string | undefined;
+                } | undefined;
+                iconUrl?: string | undefined;
+            }, {
+                name: string;
+                benefitRef: string;
+                description?: string | undefined;
+                action?: {
+                    kind: "toast" | "miniapp" | "dialog";
+                    url?: string | undefined;
+                    text?: string | undefined;
+                    title?: 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;
+            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";
+                    url?: string | undefined;
+                    text?: string | undefined;
+                    title?: string | undefined;
+                } | undefined;
+                iconUrl?: string | undefined;
+            }[] | undefined;
+            preferencePrompts?: {
+                value: "我常来买衣服" | "我常带娃来玩" | "我常来吃美食";
+                query: string;
+            }[] | undefined;
+        }, {
+            status: "unknown" | "active" | "inactive" | "frozen" | "expired";
+            userId: string;
+            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";
+                    url?: string | undefined;
+                    text?: string | undefined;
+                    title?: 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;
+                amount: zod.ZodString;
+                usedAt: zod.ZodOptional<zod.ZodString>;
+                description: zod.ZodOptional<zod.ZodString>;
+            }, "strip", zod.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: zod.ZodNumber;
         }, "strip", zod.ZodTypeAny, {
             userId: string;
+            total: number;
+            items: {
+                title: string;
+                usageRecordRef: string;
+                amount: string;
+                description?: string | undefined;
+                usedAt?: string | undefined;
+            }[];
             balance: number;
-            level: "silver" | "gold" | "platinum";
+            membershipLabel?: string | undefined;
         }, {
             userId: string;
+            total: number;
+            items: {
+                title: string;
+                usageRecordRef: string;
+                amount: string;
+                description?: string | undefined;
+                usedAt?: string | undefined;
+            }[];
             balance: number;
-            level: "silver" | "gold" | "platinum";
+            membershipLabel?: string | undefined;
         }>>;
+        readonly 'member-enrollment-form': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+            userId: zod.ZodString;
+            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, {
+                required: boolean;
+                version: string;
+                title: string;
+                consentId: string;
+                url?: string | undefined;
+            }, {
+                required: boolean;
+                version: string;
+                title: string;
+                consentId: string;
+                url?: string | undefined;
+            }>, "many">;
+            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;
+            authorization: {
+                status: "required" | "unavailable" | "authorized";
+                mobileMasked?: string | undefined;
+            };
+            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;
+                version: string;
+                title: string;
+                consentId: string;
+                url?: string | undefined;
+            }[];
+            manualNotice?: string | undefined;
+        }, {
+            userId: string;
+            authorization: {
+                status: "required" | "unavailable" | "authorized";
+                mobileMasked?: string | undefined;
+            };
+            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;
+                version: string;
+                title: string;
+                consentId: string;
+                url?: string | undefined;
+            }[];
+            manualNotice?: string | undefined;
+        }>>;
+        readonly 'member-enrollment-status': _tbox_cn_app_contracts.CardMeta<zod.ZodObject<{
+            userId: zod.ZodString;
+            attemptRef: zod.ZodOptional<zod.ZodString>;
+            state: zod.ZodEnum<["pending_confirmation", "confirmation_timeout", "active", "failed"]>;
+            memberRef: zod.ZodOptional<zod.ZodString>;
+            message: zod.ZodOptional<zod.ZodString>;
+        }, "strip", zod.ZodTypeAny, {
+            userId: string;
+            state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
+            message?: string | undefined;
+            memberRef?: string | undefined;
+            attemptRef?: string | undefined;
+        }, {
+            userId: string;
+            state: "failed" | "active" | "pending_confirmation" | "confirmation_timeout";
+            message?: string | undefined;
+            memberRef?: 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;
+            state: "not_enrolled" | "closed";
+            authState: "authenticated";
+            title?: string | undefined;
+            subtitle?: string | undefined;
+            enrollUrl?: string | undefined;
+            perks?: string[] | undefined;
+        }, {
+            userId: string;
+            state: "not_enrolled" | "closed";
+            authState: "authenticated";
+            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, meta as pointsMeta, serverModule };
+export { InMemoryMemberService, type MemberAccountService, type MemberEnrollmentService, type MemberService, memberCards, resolveMemberAccountPort, resolveMemberBenefitsPort, resolveMemberCardPort, resolveMemberEnrollmentPort, resolveMemberProfilePort, serverModule };