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

package/src/shopping-guide/cards.ts

@@ -0,0 +1,438 @@
+/**
+ * 导购域卡片数据契约（011 S7：shopping-guide 11 卡 zod schema，TIER1）。
+ * 源：POC @tbox/shopping-guide contracts（TypeBox）→ zod 重写（coerce 语义按 D11 字符串化收窄）。
+ */
+import { z } from 'zod';
+
+// ===== 通用显示值 =====
+
+export const httpsUrlSchema = z.string().regex(/^https:\/\//).max(2048);
+export const isoDateTimeSchema = z.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$/);
+
+export const moneySchema = z.object({
+  currency: z.literal('CNY'),
+  amountMinor: z.number().int().min(0),
+  display: z.string().min(1),
+});
+
+export const priceSummarySchema = z.object({
+  sale: moneySchema.optional(),
+  original: moneySchema.optional(),
+  promotion: moneySchema.optional(),
+});
+
+export const evidenceSchema = z.object({
+  code: z.string().min(1),
+  label: z.string().min(1),
+  value: z.string().optional(),
+  observedAt: isoDateTimeSchema,
+  expiresAt: isoDateTimeSchema.optional(),
+  sourceKind: z.enum(['catalog', 'merchant', 'mall', 'policy']),
+});
+
+export const reasonItemSchema = z.object({ code: z.string().min(1), label: z.string().min(1) });
+
+export const merchantLocationSchema = z.object({
+  buildingName: z.string().optional(),
+  floorName: z.string().optional(),
+  unitName: z.string().optional(),
+  displayText: z.string().min(1),
+  poiId: z.string().optional(),
+});
+/** @deprecated 使用 merchantLocationSchema（字段保持兼容，类型语义已升级为 shop location） */
+export const shopLocationSchema = merchantLocationSchema;
+
+export const merchantStatusSchema = z.object({
+  code: z.enum(['enabled', 'disabled', 'unknown']),
+  label: z.string().min(1),
+  observedAt: isoDateTimeSchema,
+});
+/** @deprecated 使用 merchantStatusSchema（字段保持兼容） */
+export const shopStatusSchema = merchantStatusSchema;
+
+export const pageInfoSchema = z.object({
+  page: z.number().int().min(1),
+  // max 200（0.7.5 放宽，原 100）：品牌导览常驻入口经 port 直调 pageSize=200 一次拉全量，
+  // provider 回显值入 pageInfo 需过卡 schema（card-emitter safeParse）；向后兼容（旧值域 ⊂ 新值域）
+  pageSize: z.number().int().min(1).max(200),
+  total: z.number().int().min(0),
+  hasMore: z.boolean(),
+});
+
+export const refinementSchema = z.object({ label: z.string().min(1), queryText: z.string().min(1) });
+
+const shopCouponSchema = z.object({
+  name: z.string().min(1),
+  imageUrl: httpsUrlSchema.optional(),
+  description: z.string().optional(),
+  faceValue: z.number().optional(),
+  salePrice: z.number().optional(),
+  applicableCategories: z.array(z.string()).optional(),
+  validHours: z.number().optional(),
+  usageTimeText: z.string().optional(),
+  purchaseUrl: z.string().max(2048).optional(),
+  freeCouponClaimMode: z.enum(['DIRECT', 'REDIRECT']).optional(),
+  offerRef: z.string().min(1).optional(),
+});
+
+/**
+ * 卡内条目动作草稿（0.3.2 D4：单源移至 shared/cards.ts，本处 import + re-export 保既有消费方）。
+ */
+import { actionDraftSchema } from '../shared/cards';
+export { actionDraftSchema };
+export type { ActionDraft } from '../shared/cards';
+
+// ===== 11 卡数据 schema =====
+
+/** product-list（context: recommendation/search/similar/history） */
+export const productListCardDataSchema = z.object({
+  context: z.enum(['recommendation', 'search', 'similar', 'history']),
+  summary: z.string().optional(),
+  items: z.array(
+    z.object({
+      productId: z.string().min(1),
+      name: z.string().min(1),
+      imageUrl: httpsUrlSchema.optional(),
+      brand: z.string().optional(),
+      categoryPath: z.array(z.string()),
+      price: priceSummarySchema,
+      availability: z.object({
+        status: z.enum(['in_stock', 'out_of_stock', 'limited', 'unknown']),
+        label: z.string(),
+        marketable: z.boolean(),
+        observedAt: isoDateTimeSchema,
+      }),
+      merchant: z.object({
+        merchantId: z.string(),
+        name: z.string(),
+        location: merchantLocationSchema.optional(),
+      }),
+      badges: z.array(z.string()),
+      reasons: z.array(reasonItemSchema).optional(),
+      evidence: z.array(evidenceSchema).optional(),
+      caveats: z.array(z.string()),
+      itemActions: z.array(actionDraftSchema),
+    }),
+  ),
+  noResultsReason: z.string().optional(),
+  pageInfo: pageInfoSchema.optional(),
+  refinements: z.array(refinementSchema),
+});
+export type ProductListCardData = z.infer<typeof productListCardDataSchema>;
+
+/** shop-list（context: recommendation/search，原 merchant-list） */
+export const shopListCardDataSchema = z.object({
+  context: z.enum(['recommendation', 'search']),
+  /** mall scope 透传：供客户端侧边栏详情 HTTP 请求携带 mallId 与 miniAppId（工具执行时注入） */
+  mallId: z.string().optional(),
+  /** 小程序 appId（miniAppId 唯一真值透传；HTTP /shop-detail 鉴权用） */
+  miniAppId: z.string().optional(),
+  summary: z.string().optional(),
+  categoryTabs: z.array(z.object({ code: z.string(), name: z.string() })).optional(),
+  items: z.array(
+    z.object({
+      merchantId: z.string(),
+      name: z.string(),
+      logoUrl: httpsUrlSchema.optional(),
+      coverUrl: httpsUrlSchema.optional(),
+      brand: z.string().optional(),
+      businessCategories: z.array(z.string()),
+      location: merchantLocationSchema,
+      status: merchantStatusSchema,
+      contactInfo: z
+        .array(z.object({ channel: z.string(), value: z.string() }))
+        .optional(),
+      services: z.array(z.string()),
+      promotionFacts: z.array(z.string()),
+      reasons: z.array(reasonItemSchema).optional(),
+      evidence: z.array(evidenceSchema).optional(),
+      itemActions: z.array(actionDraftSchema),
+      /** 门店关联优惠券（列表卡透传，供点击下钻时直接展示，避免二次请求） */
+      coupons: z.array(shopCouponSchema).optional(),
+    }),
+  ),
+  noResultsReason: z.string().optional(),
+  pageInfo: pageInfoSchema.optional(),
+  refinements: z.array(refinementSchema),
+});
+export type ShopListCardData = z.infer<typeof shopListCardDataSchema>;
+/** @deprecated 使用 ShopListCardData */
+export type MerchantListCardData = ShopListCardData;
+/** @deprecated 使用 shopListCardDataSchema */
+export const merchantListCardDataSchema = shopListCardDataSchema;
+
+/** product-detail */
+export const productDetailCardDataSchema = z.object({
+  productId: z.string().min(1),
+  name: z.string().min(1),
+  description: z.string().optional(),
+  imageUrls: z.array(httpsUrlSchema),
+  brand: z.string().optional(),
+  categoryPath: z.array(z.string()),
+  price: priceSummarySchema,
+  availability: z.object({
+    status: z.enum(['in_stock', 'out_of_stock', 'limited', 'unknown']),
+    label: z.string(),
+    marketable: z.boolean(),
+    observedAt: isoDateTimeSchema,
+  }),
+  merchant: z.object({
+    merchantId: z.string(),
+    name: z.string(),
+    location: merchantLocationSchema.optional(),
+  }),
+  attributes: z.array(z.object({ name: z.string(), value: z.string() })),
+  promotionFacts: z.array(z.string()),
+  evidence: z.array(evidenceSchema),
+  humanGuideAvailable: z.boolean(),
+  itemActions: z.array(actionDraftSchema),
+});
+export type ProductDetailCardData = z.infer<typeof productDetailCardDataSchema>;
+
+/** shop-detail（原 merchant-detail） */
+export const shopDetailCardDataSchema = z.object({
+  merchantId: z.string(),
+  name: z.string(),
+  /** mall scope 透传：供客户端 Sheet 后台 detail HTTP 请求携带（工具执行时注入，与 shop-list 同源） */
+  mallId: z.string().optional(),
+  /** 小程序 appId（miniAppId 唯一真值透传；HTTP /shop-detail 鉴权用） */
+  miniAppId: z.string().optional(),
+  logoUrl: httpsUrlSchema.optional(),
+  coverUrls: z.array(httpsUrlSchema),
+  brand: z.string().optional(),
+  businessCategories: z.array(z.string()),
+  location: merchantLocationSchema,
+  status: merchantStatusSchema,
+  description: z.string().optional(),
+  contactInfo: z
+    .array(z.object({ channel: z.string(), value: z.string() }))
+    .optional(),
+  services: z.array(z.string()),
+  promotionFacts: z.array(z.string()),
+  /** 门店关联优惠券列表（来自 couponList；name/imageUrl/faceValue/salePrice/applicableCategories/validHours） */
+  coupons: z.array(shopCouponSchema).optional(),
+  evidence: z.array(evidenceSchema),
+  itemActions: z.array(actionDraftSchema),
+});
+export type ShopDetailCardData = z.infer<typeof shopDetailCardDataSchema>;
+/** @deprecated 使用 ShopDetailCardData */
+export type MerchantDetailCardData = ShopDetailCardData;
+/** @deprecated 使用 shopDetailCardDataSchema */
+export const merchantDetailCardDataSchema = shopDetailCardDataSchema;
+
+/** category-list */
+export const categoryListCardDataSchema = z.object({
+  categories: z.array(
+    z.object({
+      code: z.string().min(1),
+      name: z.string().min(1),
+      description: z.string().optional(),
+      /** 类目图标 URL；undefined 时前端展示默认图标 */
+      iconUrl: httpsUrlSchema.optional(),
+      merchantCount: z.number().int().min(0),
+      subCategories: z
+        .array(z.object({ code: z.string(), name: z.string(), merchantCount: z.number().int().min(0) }))
+        .optional(),
+      /** 0.3.2 D4：类别条目动作（send 合成话术/外链） */
+      itemActions: z.array(actionDraftSchema).optional(),
+    }),
+  ),
+  /** 商场楼栋-楼层结构（与 mall-directory 同语义子集，供 category-list 卡片展示楼层导航） */
+  buildings: z
+    .array(
+      z.object({
+        buildingCode: z.string(),
+        buildingName: z.string(),
+        floors: z.array(
+          z.object({
+            floorCode: z.string(),
+            floorName: z.string(),
+            businessCategories: z.array(z.string()),
+            merchantCount: z.number().int().min(0),
+            /** 楼层条目动作（send：查看该楼层门店列表） */
+            itemActions: z.array(actionDraftSchema).optional(),
+          }),
+        ),
+      }),
+    )
+    .optional(),
+  observedAt: isoDateTimeSchema,
+});
+export type CategoryListCardData = z.infer<typeof categoryListCardDataSchema>;
+
+/** product-comparison（2-4 商品并排） */
+export const productComparisonCardDataSchema = z.object({
+  products: z.array(
+    z.object({
+      productId: z.string().min(1),
+      name: z.string().min(1),
+      imageUrl: httpsUrlSchema.optional(),
+      brand: z.string().optional(),
+      price: priceSummarySchema,
+      availability: z.object({
+        status: z.enum(['in_stock', 'out_of_stock', 'limited', 'unknown']),
+        label: z.string(),
+        marketable: z.boolean(),
+        observedAt: isoDateTimeSchema,
+      }),
+      merchant: z.object({ merchantId: z.string(), name: z.string() }),
+      attributes: z.array(z.object({ name: z.string(), value: z.string() })),
+      caveats: z.array(z.string()),
+    }),
+  ),
+  /** 0.3.2 D4：刷新截止时间（ISO）；到期后渲染端禁用全部条目交互 */
+  refreshRequiredAt: isoDateTimeSchema.optional(),
+  observedAt: isoDateTimeSchema,
+});
+export type ProductComparisonCardData = z.infer<typeof productComparisonCardDataSchema>;
+
+/** mall-directory（楼栋-楼层结构） */
+export const mallDirectoryCardDataSchema = z.object({
+  mallId: z.string(),
+  mallName: z.string(),
+  buildings: z.array(
+    z.object({
+      buildingCode: z.string(),
+      buildingName: z.string(),
+      floors: z.array(
+        z.object({
+          floorCode: z.string(),
+          floorName: z.string(),
+          businessCategories: z.array(z.string()),
+          merchantCount: z.number().int().min(0),
+          /** 0.3.2 D4：楼层条目动作（send：查看楼层门店） */
+          itemActions: z.array(actionDraftSchema).optional(),
+        }),
+      ),
+    }),
+  ),
+  observedAt: isoDateTimeSchema,
+});
+export type MallDirectoryCardData = z.infer<typeof mallDirectoryCardDataSchema>;
+
+/** nearby-mall-list */
+export const nearbyMallListCardDataSchema = z.object({
+  query: z.string().optional(),
+  malls: z.array(
+    z.object({
+      mallId: z.string(),
+      name: z.string(),
+      address: z.string(),
+      distanceKm: z.number().min(0).optional(),
+      status: z.object({ code: z.enum(['open', 'closed', 'unknown']), label: z.string() }),
+      itemActions: z.array(actionDraftSchema),
+    }),
+  ),
+});
+export type NearbyMallListCardData = z.infer<typeof nearbyMallListCardDataSchema>;
+
+/** customer-service-faq */
+export const customerServiceFaqCardDataSchema = z.object({
+  query: z.string().min(1),
+  faqs: z.array(
+    z.object({
+      question: z.string().min(1),
+      answer: z.string().min(1),
+      category: z.string().optional(),
+      relevanceScore: z.number().min(0).max(1),
+      /** 0.3.2 D4：答案参考外链（openLink） */
+      referenceUrl: httpsUrlSchema.optional(),
+    }),
+  ),
+  /** 客服电话（015：deployment.malls 经 mall-directory 服务注入；缺省不渲染拨打条目） */
+  contactPhone: z.string().min(1).optional(),
+  noResultsReason: z.string().optional(),
+});
+export type CustomerServiceFaqCardData = z.infer<typeof customerServiceFaqCardDataSchema>;
+
+/** human-guide-list */
+export const humanGuideListCardDataSchema = z.object({
+  merchantId: z.string(),
+  merchantName: z.string(),
+  guides: z.array(
+    z.object({
+      guideId: z.string(),
+      name: z.string(),
+      title: z.string().optional(),
+      avatarUrl: httpsUrlSchema.optional(),
+      contactInfo: z
+        .array(z.object({ channel: z.string(), value: z.string() }))
+        .optional(),
+      available: z.boolean(),
+      itemActions: z.array(actionDraftSchema),
+    }),
+  ),
+});
+export type HumanGuideListCardData = z.infer<typeof humanGuideListCardDataSchema>;
+
+/** location-handoff */
+export const locationHandoffCardDataSchema = z.object({
+  merchantId: z.string(),
+  merchantName: z.string(),
+  location: merchantLocationSchema,
+  mapUrl: httpsUrlSchema.optional(),
+  navigation: z
+    .object({
+      provider: z.enum(['amap', 'builtin']),
+      launchParams: z.record(z.string(), z.string()).optional(),
+    })
+    .optional(),
+  itemActions: z.array(actionDraftSchema),
+});
+export type LocationHandoffCardData = z.infer<typeof locationHandoffCardDataSchema>;
+
+/** recommend-merchants：类目 Tab + 门店推荐列表（按偏好/类目推荐场景专用） */
+export const recommendMerchantsCardDataSchema = z.object({
+  summary: z.string().optional(),
+  /** 类目筛选 Tab（来自 list-categories；有值时渲染 Tab 栏） */
+  categoryTabs: z.array(
+    z.object({
+      code: z.string(),
+      name: z.string(),
+    }),
+  ).optional(),
+  items: z.array(
+    z.object({
+      merchantId: z.string(),
+      name: z.string(),
+      logoUrl: httpsUrlSchema.optional(),
+      coverUrl: httpsUrlSchema.optional(),
+      brand: z.string().optional(),
+      businessCategories: z.array(z.string()),
+      location: merchantLocationSchema,
+      status: merchantStatusSchema,
+      description: z.string().optional(),
+      contactInfo: z.array(z.object({ channel: z.string(), value: z.string() })).optional(),
+      services: z.array(z.string()).optional(),
+      /** 营业时间/经营状态文本（如 "10:00营业"），来自知识库 经营状态 字段 */
+      operatingStatus: z.string().optional(),
+      /** 评分（如 "4.8"），来自知识库 评分 字段 */
+      rating: z.string().optional(),
+      /** 人均消费文本（如 "¥202"），来自知识库 人均消费 字段（分为单位时自动格式化） */
+      avgSpend: z.string().optional(),
+      promotionFacts: z.array(z.string()),
+      itemActions: z.array(actionDraftSchema),
+    }),
+  ),
+  noResultsReason: z.string().optional(),
+  observedAt: isoDateTimeSchema,
+});
+export type RecommendMerchantsCardData = z.infer<typeof recommendMerchantsCardDataSchema>;
+
+/** 11 卡 meta 数据 schema map（cardType → dataSchema，server 卡 meta 引用） */
+export const shoppingGuideCardDataSchemas = {
+  'product-list': productListCardDataSchema,
+  'product-detail': productDetailCardDataSchema,
+  'shop-list': shopListCardDataSchema,
+  'shop-detail': shopDetailCardDataSchema,
+  'category-list': categoryListCardDataSchema,
+  'product-comparison': productComparisonCardDataSchema,
+  'mall-directory': mallDirectoryCardDataSchema,
+  'nearby-mall-list': nearbyMallListCardDataSchema,
+  'customer-service-faq': customerServiceFaqCardDataSchema,
+  'human-guide-list': humanGuideListCardDataSchema,
+  'location-handoff': locationHandoffCardDataSchema,
+  'recommend-merchants': recommendMerchantsCardDataSchema,
+} as const;
+
+export type ShoppingGuideCardType = keyof typeof shoppingGuideCardDataSchemas;

package/tests/assembly-validate-scope.test.ts

@@ -0,0 +1,132 @@
+/**
+ * validateScope/createMallContextValidator 形状守卫（integrations v4 恒动态）：
+ * 白名单/动态判定（dynamicMalls）已退役——参考表纯元数据，任意 mallId 建会话；
+ * 校验唯一职责 = mallId 形状（会话边界键非空）。两形态共享 isValidMallShape 单一守卫核。
+ */
+import { describe, expect, it, vi } from 'vitest';
+
+describe('validateScope：形状守卫（v4 恒动态——白名单判定退役）', () => {
+  it('mallId-only（无 miniAppId）→ true（v4：miniAppId 可选——N1 缺陷修复）', async () => {
+    const { createMallRuntimeAssembly } = await import('../src/assembly');
+    const assembly = createMallRuntimeAssembly({ malls: [{ mallId: 'mall-demo', name: 'x' }] });
+    expect(assembly.validateScope({ mall: { mallId: 'mall-demo' } })).toBe(true);
+  });
+
+  it('双参齐全 → true（存量形态回归）', async () => {
+    const { createMallRuntimeAssembly } = await import('../src/assembly');
+    const assembly = createMallRuntimeAssembly({ malls: [{ mallId: 'mall-demo', name: 'x' }] });
+    expect(assembly.validateScope({ mall: { miniAppId: 'demo-app', mallId: 'mall-demo' } })).toBe(true);
+  });
+
+  it('参考表外 mallId → true（恒动态：白名单不再拒绝——限制移交数据面 INSTANCE_NOT_FOUND）', async () => {
+    const { createMallRuntimeAssembly } = await import('../src/assembly');
+    const assembly = createMallRuntimeAssembly({ malls: [{ mallId: 'mall-demo', name: 'x' }] });
+    expect(assembly.validateScope({ mall: { miniAppId: 'a', mallId: '99999' } })).toBe(true);
+  });
+
+  it('空控制平面（无参考表）→ 任意 mallId 放行', async () => {
+    const { createMallRuntimeAssembly } = await import('../src/assembly');
+    const assembly = createMallRuntimeAssembly({ malls: [] });
+    expect(assembly.validateScope({ mall: { mallId: '任意动态id' } })).toBe(true);
+  });
+
+  it('mallId 空串 → console.error 提示 + false', async () => {
+    const { createMallRuntimeAssembly } = await import('../src/assembly');
+    const err = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+    try {
+      const assembly = createMallRuntimeAssembly({ malls: [{ mallId: 'mall-demo', name: 'x' }] });
+      expect(assembly.validateScope({ mall: { mallId: '' } })).toBe(false);
+      expect(err).toHaveBeenCalledTimes(1);
+      expect(String(err.mock.calls[0][0])).toContain('形状非法');
+    } finally {
+      err.mockRestore();
+    }
+  });
+
+  it('mallId 缺失 → false（形状非法）', async () => {
+    const { createMallRuntimeAssembly } = await import('../src/assembly');
+    const err = vi.spyOn(console, 'error').mockImplementation(() => undefined);
+    try {
+      const assembly = createMallRuntimeAssembly({ malls: [{ mallId: 'mall-demo', name: 'x' }] });
+      expect(assembly.validateScope({ mall: { miniAppId: 'a' } })).toBe(false);
+      expect(err).toHaveBeenCalledTimes(1);
+    } finally {
+      err.mockRestore();
+    }
+  });
+
+  it("mall 键缺席 → true（'' scopeKey = 全局会话放行）", async () => {
+    const { createMallRuntimeAssembly } = await import('../src/assembly');
+    const assembly = createMallRuntimeAssembly({ malls: [{ mallId: 'mall-demo', name: 'x' }] });
+    expect(assembly.validateScope({})).toBe(true);
+    expect(assembly.validateScope({ other: 1 })).toBe(true);
+  });
+});
+
+describe('extractScopeKey/buildScope：v4 语义', () => {
+  const reqCtxOf = (attributes: Record<string, unknown>) => ({
+    identity: { userId: 'u-1', source: 'external' as const },
+    attributes,
+  });
+
+  it('extractScopeKey：mall scope 在场 → mallId；防御兜底 \'\'（主通路：无 mall context 不 bootstrap）', async () => {
+    const { createMallRuntimeAssembly } = await import('../src/assembly');
+    const assembly = createMallRuntimeAssembly({ malls: [{ mallId: 'mall-demo', name: 'x' }] });
+    expect(assembly.extractScopeKey(reqCtxOf({ mall: { mallId: 'm1' } }))).toBe('m1');
+    expect(assembly.extractScopeKey(reqCtxOf({}))).toBe('');
+  });
+
+  it('buildScope：miniAppId 在场透传 / 缺席不产键（ActionGrant 双端同构）', async () => {
+    const { createMallRuntimeAssembly } = await import('../src/assembly');
+    const assembly = createMallRuntimeAssembly({ malls: [{ mallId: 'mall-demo', name: 'x' }] });
+    expect(assembly.buildScope({ mall: { miniAppId: 'app1', mallId: 'm1' } })).toEqual({
+      mallId: 'm1',
+      miniAppId: 'app1',
+    });
+    expect(assembly.buildScope({ mall: { mallId: 'm1' } })).toEqual({ mallId: 'm1' });
+    expect(assembly.buildScope({})).toEqual({});
+  });
+});
+
+describe('createMallContextValidator（HTTP 面形态——同核）', () => {
+  it('mall 键缺席 → true（非 mall 部署/无 context 放行）', async () => {
+    const { createMallContextValidator } = await import('../src/assembly');
+    const validate = createMallContextValidator();
+    expect(validate({})).toBe(true);
+    expect(validate({ other: 1 })).toBe(true);
+  });
+
+  it('mallId-only（无 miniAppId）→ true（N8：HTTP 面不要求 miniAppId）', async () => {
+    const { createMallContextValidator } = await import('../src/assembly');
+    const validate = createMallContextValidator();
+    expect(validate({ mall: { mallId: 'mall-demo' } })).toBe(true);
+  });
+
+  it('参考表外 mallId → true（恒动态同核）', async () => {
+    const { createMallContextValidator } = await import('../src/assembly');
+    const validate = createMallContextValidator();
+    expect(validate({ mall: { mallId: '99999' } })).toBe(true);
+  });
+
+  it('mallId 空串 → 形状不过 false', async () => {
+    const { createMallContextValidator } = await import('../src/assembly');
+    const validate = createMallContextValidator();
+    expect(validate({ mall: { mallId: '' } })).toBe(false);
+  });
+
+  it('与 WS validateScope 同核（isValidMallShape 单一来源锁死）', async () => {
+    const { createMallContextValidator, createMallRuntimeAssembly, isValidMallShape } =
+      await import('../src/assembly');
+    const validate = createMallContextValidator();
+    const assembly = createMallRuntimeAssembly({ malls: [] });
+    for (const attrs of [
+      {},
+      { mall: { mallId: 'm1' } },
+      { mall: { mallId: '' } },
+      { mall: { miniAppId: 'a' } },
+    ]) {
+      expect(validate(attrs)).toBe(assembly.validateScope(attrs));
+      expect(validate(attrs)).toBe(isValidMallShape(attrs));
+    }
+  });
+});