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

package/dist/assembly.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 商圈装配器（011 B2：TIER1 领域运行时）：
+ * 纯函数——extractScopeKey/validateScope/extractMallScope，
+ * SDK 原语（ScopeSessionRegistry/ProviderRegistry）组合在模板装配点完成（011 L1）。
+ *
+ * 不 import app-sdk（依赖方向：contracts-mall → contracts；SDK 不依赖 TIER1）。
+ */
+import type { RequestContext } from '@tbox.cn/app-contracts';
+import type { MallDeploymentControlPlane } from './deployment';
+import { type MallScope, type MallRequestContext } from './scope';
+/** 装配器产物：模板注入 createScopeSessionRegistry 的 extractor/validator + 领域提取函数 */
+export interface MallRuntimeAssembly {
+    /**
+     * scope 键提取（SDK ScopeSessionRegistry 注入点）：
+     * 无 mall scope → 抛 'Mall scope is required'（非 mall 部署不应装载本装配器）。
+     */
+    extractScopeKey(ctx: RequestContext): string;
+    /** scope 白名单校验（SDK ScopeSessionRegistry 注入点）：parseMallScope 成功且 mallId ∈ malls */
+    validateScope(attributes: Record<string, unknown>): boolean;
+    /** 011 D1：领域扁平 scope（回显 + ActionGrant 签发/校验单一来源） */
+    buildScope(attributes: Record<string, unknown>): Record<string, string>;
+    /** 提取 MallScope（模块 handler 前置；无 scope → undefined 由调用方降级） */
+    extractMallScope(ctx: RequestContext): MallScope | undefined;
+    /** 提取必在 MallScope（调用方已确认存在） */
+    requireMallScope(ctx: MallRequestContext): MallScope;
+    /** 控制平面（只读快照） */
+    controlPlane: Readonly<MallDeploymentControlPlane>;
+}
+export declare function createMallRuntimeAssembly(controlPlane: MallDeploymentControlPlane): MallRuntimeAssembly;

package/dist/deployment.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 商圈部署控制平面（011 L2：三段配置的类型真源）：
+ * deployment（小程序/agent/组件清单）+ malls（白名单）+ providerInstances（外部服务实例）。
+ * 无内联密钥（loader 断言在模板层，见 011 L2）。
+ */
+import type { ProviderInstance } from '@tbox.cn/app-contracts';
+/** 组件启用项：componentId + 可选 feature 子集（feature 门控 = 运行时护栏，非装配期裁剪，011 D10） */
+export interface MallDeploymentComponent {
+    componentId: string;
+    /** 启用 feature（⊆ 模块 declaration.features，doctor feature-declaration 校验） */
+    enabledFeatures?: string[];
+    /** 可选组件：未安装该模块时 doctor 降级 warning（缺省 false = 必须安装） */
+    optional?: boolean;
+}
+/** 商圈白名单项 */
+export interface MallDeploymentMall {
+    mallId: string;
+    name: string;
+}
+/** Provider 模版声明（011 评审 7.1：credentialType 真源参数化，模板装配不再硬编码商家类型） */
+export interface MallDeploymentProviderTemplate {
+    /** 'id@version'（与 ProviderInstance.providerTemplateId 匹配） */
+    providerTemplateId: string;
+    /** 认证类型（ProviderAuthStrategy.credentialType 注册点匹配键） */
+    credentialType: string;
+}
+/** 部署控制平面（部署配置 JSON 的形状） */
+export interface MallDeploymentControlPlane {
+    deployment: {
+        /** 小程序 appId */
+        miniAppId: string;
+        /** agent 实例 id */
+        agentId: string;
+        /** 组件清单（与已装模块对账，doctor deployment-consistency） */
+        components: MallDeploymentComponent[];
+    };
+    /** 商圈白名单（validateScope 依据） */
+    malls: MallDeploymentMall[];
+    /** Provider 模版声明（可选；缺省由模板装配从实例派生） */
+    providerTemplates?: MallDeploymentProviderTemplate[];
+    /** Provider 实例（三段之三；机密走 credentialRef，禁内联密钥） */
+    providerInstances: ProviderInstance[];
+}

package/dist/guard.d.ts

@@ -0,0 +1,50 @@
+/**
+ * 商圈守卫（011：location/user 领域守卫，TIER1 运行时）：
+ * 卡片/工具入参中的位置与用户字段防御解析。
+ * 平台存储数据不可全信——一切外部形状先过 zod。
+ */
+import { z } from 'zod';
+/** 商圈位置（经纬度字符串化，D11：数值一律字符串化） */
+export interface MallLocation {
+    latitude: string;
+    longitude: string;
+    /** 可选商圈 id（位置所属 mall） */
+    mallId?: string;
+    /** 可选名称（POI） */
+    name?: string;
+}
+export declare const mallLocationSchema: z.ZodObject<{
+    latitude: z.ZodString;
+    longitude: z.ZodString;
+    mallId: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    latitude: string;
+    longitude: string;
+    name?: string | undefined;
+    mallId?: string | undefined;
+}, {
+    latitude: string;
+    longitude: string;
+    name?: string | undefined;
+    mallId?: string | undefined;
+}>;
+/** 解析失败返回 undefined（调用方降级「位置未知」文案） */
+export declare function parseMallLocation(raw: unknown): MallLocation | undefined;
+/** 商圈用户标识（D11 字符串化 user 字段守卫） */
+export interface MallUserRef {
+    userId: string;
+    /** 可选 mall 会员主体 id */
+    subjectId?: string;
+}
+export declare const mallUserRefSchema: z.ZodObject<{
+    userId: z.ZodString;
+    subjectId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    subjectId?: string | undefined;
+}, {
+    userId: string;
+    subjectId?: string | undefined;
+}>;
+export declare function parseMallUserRef(raw: unknown): MallUserRef | undefined;

package/dist/index.d.ts

@@ -1,7 +1,8 @@
 /**
- * @tbox.cn/app-contracts-mall：商圈领域契约（TIER1，types-only 纯类型包）。
- * 消费方（module-parking / module-promotion / scenario）只依赖本契约，
+ * @tbox.cn/app-contracts-mall：商圈领域契约（TIER1，types + runtime）。
+ * 消费方（module-* / scenario / 模板装配点）只依赖本契约，
  * 不依赖任何模块实现包——结构类型子集接口 + 事件总线破环双向依赖。
+ * runtime 值（scope 解析/装配器/守卫）经 ./runtime 导出（dist/runtime.js）。
  */
 export * from './domain/points';
 export * from './domain/coupon';
@@ -11,3 +12,10 @@ export * from './services/member';
 export * from './services/parking';
 export * from './services/promotion';
 export * from './events';
+export * from './scope';
+export * from './deployment';
+export * from './assembly';
+export * from './guard';
+export * from './shopping-guide/cards';
+export * from './shopping-guide/ports';
+export * from './member/cards';

package/dist/member/cards.d.ts

@@ -0,0 +1,517 @@
+/**
+ * 会员域卡片数据契约（011 K2：member 7 卡 zod schema，TIER1）。
+ */
+import { z } from 'zod';
+export declare const memberStateSchema: z.ZodEnum<["active", "not_enrolled", "closed"]>;
+/** member-info：账户 + 资料摘要 */
+export declare const memberInfoCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    state: z.ZodEnum<["active", "not_enrolled", "closed"]>;
+    displayName: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodString>;
+    contactDisplay: z.ZodOptional<z.ZodString>;
+    memberRef: z.ZodOptional<z.ZodString>;
+    registeredAt: z.ZodOptional<z.ZodString>;
+    labels: z.ZodArray<z.ZodObject<{
+        labelRef: z.ZodString;
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        labelRef: string;
+    }, {
+        name: string;
+        labelRef: string;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    state: "active" | "not_enrolled" | "closed";
+    labels: {
+        name: string;
+        labelRef: string;
+    }[];
+    avatarUrl?: string | undefined;
+    displayName?: string | undefined;
+    contactDisplay?: string | undefined;
+    memberRef?: string | undefined;
+    registeredAt?: string | undefined;
+}, {
+    userId: string;
+    state: "active" | "not_enrolled" | "closed";
+    labels: {
+        name: string;
+        labelRef: string;
+    }[];
+    avatarUrl?: string | undefined;
+    displayName?: string | undefined;
+    contactDisplay?: string | undefined;
+    memberRef?: string | undefined;
+    registeredAt?: string | undefined;
+}>;
+export type MemberInfoCardData = z.infer<typeof memberInfoCardDataSchema>;
+/** member-card-summary：会员卡面（等级 + 积分摘要） */
+export declare const memberCardSummaryCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    cardRef: z.ZodString;
+    cardDisplay: z.ZodString;
+    status: z.ZodEnum<["active", "inactive", "frozen", "expired", "unknown"]>;
+    levelName: z.ZodOptional<z.ZodString>;
+    availablePoints: z.ZodNumber;
+    cardImageUrl: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: "active" | "unknown" | "inactive" | "frozen" | "expired";
+    userId: string;
+    cardRef: string;
+    cardDisplay: string;
+    availablePoints: number;
+    levelName?: string | undefined;
+    cardImageUrl?: string | undefined;
+}, {
+    status: "active" | "unknown" | "inactive" | "frozen" | "expired";
+    userId: string;
+    cardRef: string;
+    cardDisplay: string;
+    availablePoints: number;
+    levelName?: string | undefined;
+    cardImageUrl?: string | undefined;
+}>;
+export type MemberCardSummaryCardData = z.infer<typeof memberCardSummaryCardDataSchema>;
+/** member-coupon-list */
+export declare const memberCouponListCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        couponRef: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodEnum<["amount", "discount", "gift", "parking", "unknown"]>;
+        status: z.ZodEnum<["effective", "used", "expired", "invalid", "unknown"]>;
+        benefitText: z.ZodOptional<z.ZodString>;
+        thresholdText: z.ZodOptional<z.ZodString>;
+    }, "strip", z.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: z.ZodNumber;
+}, "strip", z.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;
+    }[];
+}>;
+export type MemberCouponListCardData = z.infer<typeof memberCouponListCardDataSchema>;
+/** member-coupon-detail */
+export declare const memberCouponDetailCardDataSchema: z.ZodObject<{
+    couponRef: z.ZodString;
+    title: z.ZodString;
+    type: z.ZodEnum<["amount", "discount", "gift", "parking", "unknown"]>;
+    status: z.ZodEnum<["effective", "used", "expired", "invalid", "unknown"]>;
+    description: z.ZodOptional<z.ZodString>;
+    benefitText: z.ZodOptional<z.ZodString>;
+    thresholdText: z.ZodOptional<z.ZodString>;
+}, "strip", z.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;
+}>;
+export type MemberCouponDetailCardData = z.infer<typeof memberCouponDetailCardDataSchema>;
+/**
+ * member-point-usage-list（011 K3：吸收教学 points 卡——userId/balance/level 字段对齐）。
+ */
+export declare const memberPointUsageListCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    balance: z.ZodNumber;
+    level: z.ZodEnum<["silver", "gold", "platinum"]>;
+    items: z.ZodArray<z.ZodObject<{
+        usageRecordRef: z.ZodString;
+        title: z.ZodString;
+        amount: z.ZodString;
+        usedAt: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        amount: string;
+        title: string;
+        usageRecordRef: string;
+        description?: string | undefined;
+        usedAt?: string | undefined;
+    }, {
+        amount: string;
+        title: string;
+        usageRecordRef: string;
+        description?: string | undefined;
+        usedAt?: string | undefined;
+    }>, "many">;
+    total: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    total: number;
+    items: {
+        amount: string;
+        title: string;
+        usageRecordRef: string;
+        description?: string | undefined;
+        usedAt?: string | undefined;
+    }[];
+    balance: number;
+    level: "silver" | "gold" | "platinum";
+}, {
+    userId: string;
+    total: number;
+    items: {
+        amount: string;
+        title: string;
+        usageRecordRef: string;
+        description?: string | undefined;
+        usedAt?: string | undefined;
+    }[];
+    balance: number;
+    level: "silver" | "gold" | "platinum";
+}>;
+export type MemberPointUsageListCardData = z.infer<typeof memberPointUsageListCardDataSchema>;
+/** member-enrollment-form（入会表单；写动作 = member.enroll grant） */
+export declare const memberEnrollmentFormCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    state: z.ZodEnum<["active", "not_enrolled", "closed"]>;
+    /** 表单必填项（渲染端收集后经 componentAction member.enroll 提交） */
+    fields: z.ZodArray<z.ZodObject<{
+        fieldId: z.ZodString;
+        label: z.ZodString;
+        required: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+        fieldId: string;
+        required: boolean;
+    }, {
+        label: string;
+        fieldId: string;
+        required: boolean;
+    }>, "many">;
+    actionId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    userId: string;
+    actionId: string;
+    state: "active" | "not_enrolled" | "closed";
+    fields: {
+        label: string;
+        fieldId: string;
+        required: boolean;
+    }[];
+}, {
+    userId: string;
+    actionId: string;
+    state: "active" | "not_enrolled" | "closed";
+    fields: {
+        label: string;
+        fieldId: string;
+        required: boolean;
+    }[];
+}>;
+export type MemberEnrollmentFormCardData = z.infer<typeof memberEnrollmentFormCardDataSchema>;
+/** member-enrollment-status（入会结果状态卡） */
+export declare const memberEnrollmentStatusCardDataSchema: z.ZodObject<{
+    userId: z.ZodString;
+    success: z.ZodBoolean;
+    memberRef: z.ZodOptional<z.ZodString>;
+    message: z.ZodOptional<z.ZodString>;
+    state: z.ZodEnum<["active", "not_enrolled", "closed"]>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    userId: string;
+    state: "active" | "not_enrolled" | "closed";
+    message?: string | undefined;
+    memberRef?: string | undefined;
+}, {
+    success: boolean;
+    userId: string;
+    state: "active" | "not_enrolled" | "closed";
+    message?: string | undefined;
+    memberRef?: string | undefined;
+}>;
+export type MemberEnrollmentStatusCardData = z.infer<typeof memberEnrollmentStatusCardDataSchema>;
+/** 7 卡 schema map（cardType → dataSchema） */
+export declare const memberCardDataSchemas: {
+    readonly 'member-info': z.ZodObject<{
+        userId: z.ZodString;
+        state: z.ZodEnum<["active", "not_enrolled", "closed"]>;
+        displayName: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodString>;
+        contactDisplay: z.ZodOptional<z.ZodString>;
+        memberRef: z.ZodOptional<z.ZodString>;
+        registeredAt: z.ZodOptional<z.ZodString>;
+        labels: z.ZodArray<z.ZodObject<{
+            labelRef: z.ZodString;
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            labelRef: string;
+        }, {
+            name: string;
+            labelRef: string;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        userId: string;
+        state: "active" | "not_enrolled" | "closed";
+        labels: {
+            name: string;
+            labelRef: string;
+        }[];
+        avatarUrl?: string | undefined;
+        displayName?: string | undefined;
+        contactDisplay?: string | undefined;
+        memberRef?: string | undefined;
+        registeredAt?: string | undefined;
+    }, {
+        userId: string;
+        state: "active" | "not_enrolled" | "closed";
+        labels: {
+            name: string;
+            labelRef: string;
+        }[];
+        avatarUrl?: string | undefined;
+        displayName?: string | undefined;
+        contactDisplay?: string | undefined;
+        memberRef?: string | undefined;
+        registeredAt?: string | undefined;
+    }>;
+    readonly 'member-card-summary': z.ZodObject<{
+        userId: z.ZodString;
+        cardRef: z.ZodString;
+        cardDisplay: z.ZodString;
+        status: z.ZodEnum<["active", "inactive", "frozen", "expired", "unknown"]>;
+        levelName: z.ZodOptional<z.ZodString>;
+        availablePoints: z.ZodNumber;
+        cardImageUrl: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: "active" | "unknown" | "inactive" | "frozen" | "expired";
+        userId: string;
+        cardRef: string;
+        cardDisplay: string;
+        availablePoints: number;
+        levelName?: string | undefined;
+        cardImageUrl?: string | undefined;
+    }, {
+        status: "active" | "unknown" | "inactive" | "frozen" | "expired";
+        userId: string;
+        cardRef: string;
+        cardDisplay: string;
+        availablePoints: number;
+        levelName?: string | undefined;
+        cardImageUrl?: string | undefined;
+    }>;
+    readonly 'member-coupon-list': z.ZodObject<{
+        userId: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{
+            couponRef: z.ZodString;
+            title: z.ZodString;
+            type: z.ZodEnum<["amount", "discount", "gift", "parking", "unknown"]>;
+            status: z.ZodEnum<["effective", "used", "expired", "invalid", "unknown"]>;
+            benefitText: z.ZodOptional<z.ZodString>;
+            thresholdText: z.ZodOptional<z.ZodString>;
+        }, "strip", z.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: z.ZodNumber;
+    }, "strip", z.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': z.ZodObject<{
+        couponRef: z.ZodString;
+        title: z.ZodString;
+        type: z.ZodEnum<["amount", "discount", "gift", "parking", "unknown"]>;
+        status: z.ZodEnum<["effective", "used", "expired", "invalid", "unknown"]>;
+        description: z.ZodOptional<z.ZodString>;
+        benefitText: z.ZodOptional<z.ZodString>;
+        thresholdText: z.ZodOptional<z.ZodString>;
+    }, "strip", z.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;
+    }>;
+    readonly 'member-point-usage-list': z.ZodObject<{
+        userId: z.ZodString;
+        balance: z.ZodNumber;
+        level: z.ZodEnum<["silver", "gold", "platinum"]>;
+        items: z.ZodArray<z.ZodObject<{
+            usageRecordRef: z.ZodString;
+            title: z.ZodString;
+            amount: z.ZodString;
+            usedAt: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            amount: string;
+            title: string;
+            usageRecordRef: string;
+            description?: string | undefined;
+            usedAt?: string | undefined;
+        }, {
+            amount: string;
+            title: string;
+            usageRecordRef: string;
+            description?: string | undefined;
+            usedAt?: string | undefined;
+        }>, "many">;
+        total: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        userId: string;
+        total: number;
+        items: {
+            amount: string;
+            title: string;
+            usageRecordRef: string;
+            description?: string | undefined;
+            usedAt?: string | undefined;
+        }[];
+        balance: number;
+        level: "silver" | "gold" | "platinum";
+    }, {
+        userId: string;
+        total: number;
+        items: {
+            amount: string;
+            title: string;
+            usageRecordRef: string;
+            description?: string | undefined;
+            usedAt?: string | undefined;
+        }[];
+        balance: number;
+        level: "silver" | "gold" | "platinum";
+    }>;
+    readonly 'member-enrollment-form': z.ZodObject<{
+        userId: z.ZodString;
+        state: z.ZodEnum<["active", "not_enrolled", "closed"]>;
+        /** 表单必填项（渲染端收集后经 componentAction member.enroll 提交） */
+        fields: z.ZodArray<z.ZodObject<{
+            fieldId: z.ZodString;
+            label: z.ZodString;
+            required: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+            fieldId: string;
+            required: boolean;
+        }, {
+            label: string;
+            fieldId: string;
+            required: boolean;
+        }>, "many">;
+        actionId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        userId: string;
+        actionId: string;
+        state: "active" | "not_enrolled" | "closed";
+        fields: {
+            label: string;
+            fieldId: string;
+            required: boolean;
+        }[];
+    }, {
+        userId: string;
+        actionId: string;
+        state: "active" | "not_enrolled" | "closed";
+        fields: {
+            label: string;
+            fieldId: string;
+            required: boolean;
+        }[];
+    }>;
+    readonly 'member-enrollment-status': z.ZodObject<{
+        userId: z.ZodString;
+        success: z.ZodBoolean;
+        memberRef: z.ZodOptional<z.ZodString>;
+        message: z.ZodOptional<z.ZodString>;
+        state: z.ZodEnum<["active", "not_enrolled", "closed"]>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        userId: string;
+        state: "active" | "not_enrolled" | "closed";
+        message?: string | undefined;
+        memberRef?: string | undefined;
+    }, {
+        success: boolean;
+        userId: string;
+        state: "active" | "not_enrolled" | "closed";
+        message?: string | undefined;
+        memberRef?: string | undefined;
+    }>;
+};
+export type MemberCardType = keyof typeof memberCardDataSchemas;

package/dist/runtime.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @tbox.cn/app-contracts-mall runtime 入口（011 A5：types-only → types + runtime）。
+ * 本文件为唯一运行时 JS（经 tsup/esbuild 出 dist/runtime.js）；
+ * 类型面仍经 tsc emitDeclarationOnly 出 dist/*.d.ts。
+ * 依赖方向：contracts-mall → contracts（TIER0）；SDK 不 import 本包（011 B3）。
+ */
+export { MALL_SCOPE_KEY, mallScopeSchema, parseMallScope, extractMallScope, requireMallScope } from './scope';
+export { createMallRuntimeAssembly } from './assembly';
+export { mallLocationSchema, parseMallLocation, mallUserRefSchema, parseMallUserRef } from './guard';
+export * from './shopping-guide/cards';
+export * from './member/cards';