@tbox.cn/app-provider-mock 0.2.0

package/tests/integrations-e2e.test.ts

@@ -0,0 +1,219 @@
+/**
+ * Provider 拆包 F2 端到端槽位解析测试：provider-mock serverModule register →
+ * createIntegrationsRegistry.resolveService → 模块 ports 形态消费。
+ * 锁死链路：ctx.integrations 同引用传递（registerServerModules 语义模拟）+ local 短路 +
+ * mock 实现经槽位轴产出（demo ref 厂商中立）。
+ */
+import { beforeEach, describe, expect, it } from 'vitest';
+import { createIntegrationsRegistry, createAuthStrategyRegistry, createEnvironmentSecretProvider, createServerContext } from '@tbox.cn/app-sdk/server';
+import { serverModule, MOCK_SHELL_USER_ID, enrollMockMember, logoutMockMember, __resetMockMemberState } from '../src/server/index';
+import type { IntegrationsConfig } from '@tbox.cn/app-contracts';
+import type { RequestContext } from '@tbox.cn/app-contracts';
+
+const integrations: IntegrationsConfig = {
+  services: {
+    'member.account': { provider: 'mock', implementation: 'mock-member@1', instances: { 'mall-demo': { enabled: true } } },
+    'member.profile': { provider: 'mock', implementation: 'mock-member@1', instances: { 'mall-demo': { enabled: true } } },
+    'member.card': { provider: 'mock', implementation: 'mock-member@1', instances: { 'mall-demo': { enabled: true } } },
+    'member.benefits': { provider: 'mock', implementation: 'mock-member@1', instances: { 'mall-demo': { enabled: true } } },
+    'member.enrollment': { provider: 'mock', implementation: 'mock-member@1', instances: { 'mall-demo': { enabled: true } } },
+    'parking.query': { provider: 'mock', implementation: 'mock-parking@1', instances: { 'mall-demo': { enabled: true } } },
+    'parking.payment': { provider: 'mock', implementation: 'mock-parking@1', instances: { 'mall-demo': { enabled: true } } },
+    'parking.vehicle': { provider: 'mock', implementation: 'mock-parking@1', instances: { 'mall-demo': { enabled: true } } },
+    'promotion.offers': { provider: 'mock', implementation: 'mock-promotion@1', instances: { 'mall-demo': { enabled: true } } },
+    'promotion.entitlements': { provider: 'mock', implementation: 'mock-promotion@1', instances: { 'mall-demo': { enabled: true } } },
+    'promotion.activities': { provider: 'mock', implementation: 'mock-promotion@1', instances: { 'mall-demo': { enabled: true } } },
+    'promotion.acquisition': { provider: 'mock', implementation: 'mock-promotion@1', instances: { 'mall-demo': { enabled: true } } },
+    'shopping-guide.catalog': { provider: 'mock', implementation: 'mock-shopping@1', instances: { 'mall-demo': { enabled: true } } },
+    'shopping-guide.shops': { provider: 'mock', implementation: 'mock-shopping@1', instances: { 'mall-demo': { enabled: true } } },
+    'shopping-guide.categories': { provider: 'mock', implementation: 'mock-shopping@1', instances: { 'mall-demo': { enabled: true } } },
+    'shopping-guide.directory': { provider: 'mock', implementation: 'mock-shopping@1', instances: { 'mall-demo': { enabled: true } } },
+    'mall.info': { provider: 'mock', implementation: 'mock-mall-info@1', instances: { 'mall-demo': { enabled: true } } },
+  },
+};
+
+const catalog = {
+  providers: {
+    mock: {
+      'mock-member@1': { provider: 'mock', implementation: 'mock-member@1', credentialType: '-', owner: '@tbox.cn/app-provider-mock', local: true, services: ['member.account', 'member.profile', 'member.card', 'member.benefits', 'member.enrollment'] },
+      'mock-parking@1': { provider: 'mock', implementation: 'mock-parking@1', credentialType: '-', owner: '@tbox.cn/app-provider-mock', local: true, services: ['parking.query', 'parking.payment', 'parking.vehicle'] },
+      'mock-promotion@1': { provider: 'mock', implementation: 'mock-promotion@1', credentialType: '-', owner: '@tbox.cn/app-provider-mock', local: true, services: ['promotion.offers', 'promotion.entitlements', 'promotion.activities', 'promotion.acquisition'] },
+      'mock-shopping@1': { provider: 'mock', implementation: 'mock-shopping@1', credentialType: '-', owner: '@tbox.cn/app-provider-mock', local: true, services: ['shopping-guide.catalog', 'shopping-guide.shops', 'shopping-guide.categories', 'shopping-guide.directory'] },
+      'mock-mall-info@1': { provider: 'mock', implementation: 'mock-mall-info@1', credentialType: '-', owner: '@tbox.cn/app-provider-mock', local: true, services: ['mall.info'] },
+    },
+  },
+  services: {},
+  credentialTypes: {},
+};
+
+function requestContext(mallId = 'mall-demo'): RequestContext {
+  return {
+    identity: { userId: 'u_1', source: 'dev' },
+    credentials: { provider: 'dev', token: 't' },
+    attributes: { mall: { mallId } },
+  };
+}
+
+function fixtureCtx() {
+  const registry = createIntegrationsRegistry({
+    integrations,
+    catalog,
+    authStrategies: createAuthStrategyRegistry(),
+    secretProvider: createEnvironmentSecretProvider({ source: {}, production: false }),
+    instanceIdOf: (scope) => scope.mallId ?? '',
+  });
+  const ctx = createServerContext({ integrations: registry });
+  serverModule.register(ctx); // provider register 期注册 adapter（经 ctx.integrations 同引用）
+  return { ctx, registry };
+}
+
+describe('F2 端到端：provider-mock 经槽位轴解析', () => {
+  it('register（经 ctx.integrations）→ resolveService 三槽产出 mock 实现', async () => {
+    const { ctx, registry } = fixtureCtx();
+    expect(registry.listAdapters()).toEqual(['mock\u0000mock-member@1', 'mock\u0000mock-parking@1', 'mock\u0000mock-promotion@1', 'mock\u0000mock-shopping@1', 'mock\u0000mock-mall-info@1']);
+
+    const member = (await ctx.integrations!.resolveService({
+      service: 'member.account',
+      scope: { mallId: 'mall-demo' },
+      request: requestContext(),
+    })) as { getAccount(u: string): Promise<{ state: string }> };
+    await expect(member.getAccount('u1')).resolves.toMatchObject({ state: 'not_enrolled' });
+
+    const parking = (await ctx.integrations!.resolveService({
+      service: 'parking.query',
+      scope: { mallId: 'mall-demo' },
+      request: requestContext(),
+    })) as { queryFee(q: unknown, input: { plateNo: string }): Promise<{ quoteRef: string; payableCents: number }[]> };
+    const quotes = await parking.queryFee({ scope: {} } as never, { plateNo: 'demo-plate' });
+    expect(quotes[0]?.quoteRef.startsWith('demo:quote:')).toBe(true);
+
+    const promotion = (await ctx.integrations!.resolveService({
+      service: 'promotion.offers',
+      scope: { mallId: 'mall-demo' },
+      request: requestContext(),
+    })) as { searchOffers(q: unknown, input: { keyword: string }): Promise<{ items: unknown[] }> };
+    const page = await promotion.searchOffers({ scope: {} } as never, { keyword: '' });
+    expect(page.items.length).toBeGreaterThanOrEqual(2);
+
+    // 017 槽位原子化：guide 四槽各自产出单 Port（同一 impl 实例族）
+    const shoppingShop = (await ctx.integrations!.resolveService({
+      service: 'shopping-guide.shops',
+      scope: { mallId: 'mall-demo' },
+      request: requestContext(),
+    })) as { searchShops(input: unknown): Promise<{ items: unknown[]; total: number }> };
+    const shopPage = await shoppingShop.searchShops({ ctx: { scope: {} }, page: 1, pageSize: 10 });
+    expect(shopPage.total).toBeGreaterThan(0);
+    const shoppingCategory = (await ctx.integrations!.resolveService({
+      service: 'shopping-guide.categories',
+      scope: { mallId: 'mall-demo' },
+      request: requestContext(),
+    })) as { listCategories(): Promise<readonly unknown[]> };
+    expect((await shoppingCategory.listCategories()).length).toBeGreaterThan(0);
+    const shoppingDirectory = (await ctx.integrations!.resolveService({
+      service: 'shopping-guide.directory',
+      scope: { mallId: 'mall-demo' },
+      request: requestContext(),
+    })) as { getDirectory(ctx: unknown): Promise<{ mallId: string; buildings: unknown[] } | null> };
+    expect((await shoppingDirectory.getDirectory({ scope: { mallId: 'mall-demo' } } as never))?.mallId).toBe('mall-demo');
+
+    // mall.info（融合语义：动态别名 + demo 位置字段——mall-info agent tool 演示数据面）
+    const mallInfo = (await ctx.integrations!.resolveService({
+      service: 'mall.info',
+      scope: { mallId: 'mall-demo' },
+      request: requestContext(),
+    })) as { getMallInfo(mallId: string): Promise<{ mallId: string; name: string } | undefined> };
+    await expect(mallInfo.getMallInfo('mall-demo')).resolves.toMatchObject({
+      mallId: 'mall-demo',
+      name: '示例商场（mall-demo）',
+    });
+  });
+
+  it('local 短路：transport 为 InMemory（免凭据链）——mock 无 credentialRef 而解析成功', async () => {
+    const { ctx } = fixtureCtx();
+    await expect(
+      ctx.integrations!.resolveService({
+        service: 'member.account',
+        scope: { mallId: 'mall-demo' },
+        request: requestContext(),
+      }),
+    ).resolves.toBeDefined();
+  });
+
+  it('槽未配置（shopping-guide 无实例的 mall）→ INSTANCE_NOT_FOUND 上抛', async () => {
+    const { ctx } = fixtureCtx();
+    await expect(
+      ctx.integrations!.resolveService({
+        service: 'member.account',
+        scope: { mallId: 'mall-other' },
+        request: requestContext('mall-other'),
+      }),
+    ).rejects.toMatchObject({ code: 'PROVIDER_INSTANCE_NOT_FOUND' });
+  });
+});
+
+describe('C5：scoped mock 换码器（入会闭环身份供给）', () => {
+  beforeEach(() => __resetMockMemberState());
+
+  it('matches 绑定语义：member.account 绑 mock 的 mall 命中；未选择商场命中自身；绑他牌/未知 mall 不命中', () => {
+    const { ctx } = fixtureCtx();
+    const hit = ctx.authExchanges.get('alipay', { mall: { mallId: 'mall-demo' } });
+    expect(hit?.provider).toBe('alipay');
+    // 未选择商场（无 mallId）→ 命中本候选，exchangeByCode 显性抛 AUTH_NOT_CONFIGURED（不落内置本地 alipay）
+    const noMall = ctx.authExchanges.get('alipay');
+    expect(noMall?.provider).toBe('alipay');
+    // 未绑 mock 的 mall（无 member.account 实例）→ scoped 不命中，落到后续层（此处无兜底 = undefined）
+    expect(ctx.authExchanges.get('alipay', { mall: { mallId: 'mall-other' } })).toBeUndefined();
+  });
+
+  it('未选择商场（无 mallId）→ exchangeByCode 抛 AUTH_NOT_CONFIGURED 未选择商场', async () => {
+    const { ctx } = fixtureCtx();
+    const exchanger = ctx.authExchanges.get('alipay')!;
+    await expect(exchanger.exchangeByCode('any-authcode', 'alipay')).rejects.toThrow(/未选择商场/);
+  });
+
+  it('GUEST 形态（对齐真实档潜客分支）：token="" + openid 身份——合法登录未入会', async () => {
+    const { ctx } = fixtureCtx();
+    const exchanger = ctx.authExchanges.get('alipay', { mall: { mallId: 'mall-demo' } })!;
+    const result = await exchanger.exchangeByCode('any-authcode', 'alipay', { mall: { mallId: 'mall-demo' } });
+    expect(result).toEqual({
+      identity: { userId: 'demo-user', source: 'external' },
+      credentials: { token: '', provider: 'mock', attributes: { openid: 'demo:openid:demo-user' } },
+    });
+  });
+
+  it('MEMBER 形态（对齐真实档会员换码输出）：入会后冷登 → token + memberId', async () => {
+    enrollMockMember(MOCK_SHELL_USER_ID);
+    const { ctx } = fixtureCtx();
+    const exchanger = ctx.authExchanges.get('alipay', { mall: { mallId: 'mall-demo' } })!;
+    const result = await exchanger.exchangeByCode('any-authcode', 'alipay', { mall: { mallId: 'mall-demo' } });
+    expect(result).toEqual({
+      identity: { userId: 'demo-user', source: 'external' },
+      credentials: { token: 'demo:token:demo-user', provider: 'mock', attributes: { memberId: 'demo-user' } },
+    });
+  });
+
+  it('刻意不实现 devExternalCredentials：dev-login 走协议 fail-soft 无 claim 签发', () => {
+    const { ctx } = fixtureCtx();
+    const exchanger = ctx.authExchanges.get('alipay', { mall: { mallId: 'mall-demo' } });
+    // 能力口缺席（typeof 守卫语义——login-routes 同款消费形态）
+    expect(typeof (exchanger as { devExternalCredentials?: unknown })?.devExternalCredentials).toBe('undefined');
+  });
+
+  it('登出态换码降级 GUEST 形态（对齐真实档 silentLogin 非 200 → 访客结果，2026-09-02 真机实测）', async () => {
+    enrollMockMember(MOCK_SHELL_USER_ID);
+    logoutMockMember(MOCK_SHELL_USER_ID);
+    const { ctx } = fixtureCtx();
+    const exchanger = ctx.authExchanges.get('alipay', { mall: { mallId: 'mall-demo' } })!;
+    const degraded = await exchanger.exchangeByCode('any-authcode', 'alipay', { mall: { mallId: 'mall-demo' } });
+    expect(degraded.identity).toEqual({ userId: MOCK_SHELL_USER_ID, source: 'external' });
+    expect(degraded.credentials).toEqual({
+      token: '',
+      provider: 'mock',
+      attributes: { openid: 'demo:openid:demo-user' },
+    });
+    // 重登录（enroll 清登出态）后恢复 MEMBER 形态——H5 半屏成功登录后冷登即恢复
+    enrollMockMember(MOCK_SHELL_USER_ID);
+    const result = await exchanger.exchangeByCode('any-authcode', 'alipay', { mall: { mallId: 'mall-demo' } });
+    expect(result.credentials?.token).toBe('demo:token:demo-user');
+  });
+});

package/tests/mall-info.test.ts

@@ -0,0 +1,47 @@
+/**
+ * mock mall.info adapter 单测（mall.info 槽供给；对齐真实厂商 mall-info 单测通用形态）。
+ * 请求形状断言（记录≠校验教训）：mallId 形状守卫——合法 id 恒返回确定性别名；
+ * 畸形 id（注入类字符/超长）→ undefined，零上游调用（mock 无 IO，守卫即终态）。
+ */
+import { describe, expect, it } from 'vitest';
+import { mockMallInfoFactory, MOCK_MALL_INFO_PROVIDER, MOCK_MALL_INFO_IMPL } from '../src/server/mall-info';
+
+function makePort() {
+  return mockMallInfoFactory({
+    provider: MOCK_MALL_INFO_PROVIDER,
+    implementation: MOCK_MALL_INFO_IMPL,
+    instanceId: '',
+    config: {},
+    logger: { info: () => undefined, warn: () => undefined, error: () => undefined },
+    service: 'mall.info',
+  } as never) as { getMallInfo(mallId: string): Promise<{ mallId: string; name: string } | undefined> };
+}
+
+describe('mockMallInfoFactory：请求形状守卫', () => {
+  it('合法 mallId → 确定性别名 + demo 位置（动态商场品牌区真源 + agent tool 演示数据面）', async () => {
+    const port = makePort();
+    const info = await port.getMallInfo('1102588');
+    expect(info).toEqual({
+      mallId: '1102588',
+      name: '示例商场（1102588）',
+      address: '示例商场地址（demo）',
+      latitude: 30.0,
+      longitude: 120.0,
+    });
+    const info2 = await port.getMallInfo('demo-mall_1');
+    expect(info2?.name).toBe('示例商场（demo-mall_1）');
+  });
+
+  it('畸形 mallId → undefined（形状守卫——防注入类字符/超长）', async () => {
+    const port = makePort();
+    expect(await port.getMallInfo('../etc/passwd')).toBeUndefined();
+    expect(await port.getMallInfo('')).toBeUndefined();
+    expect(await port.getMallInfo('a'.repeat(33))).toBeUndefined();
+    expect(await port.getMallInfo('id with space')).toBeUndefined();
+  });
+
+  it('实现常量契约（provider=' + MOCK_MALL_INFO_PROVIDER + ' impl=' + MOCK_MALL_INFO_IMPL + '）', () => {
+    expect(MOCK_MALL_INFO_PROVIDER).toBe('mock');
+    expect(MOCK_MALL_INFO_IMPL).toBe('mock-mall-info@1');
+  });
+});

package/tests/mock-impl.test.ts

@@ -0,0 +1,348 @@
+/**
+ * provider-mock 单测（F1b）：mock 实现满足 TIER1 Port 面 + demo ref 厂商中立 + adapter 注册形态。
+ * 会员态为模块级共享 store（C5 入会闭环前提）——文件级复位保证用例顺序无关
+ * （「初始 not_enrolled」类断言不依赖前序用例是否 enroll 过同一 userId）。
+ */
+import { beforeEach, describe, expect, it } from 'vitest';
+import { MockMemberServiceImpl } from '../src/server/member';
+import { MockParkingServiceImpl } from '../src/server/parking';
+import { MockPromotionServiceImpl } from '../src/server/promotion';
+import { MockShoppingServiceImpl } from '../src/server/shopping';
+import { serverModule, MOCK_SHELL_USER_ID, enrollMockMember, logoutMockMember, isMockMemberEnrolled, isMockMemberLoggedOut, __resetMockMemberState } from '../src/server/index';
+import { resolveMockEnroll, resolveMockLogout } from '../src/server/mock-enroll-route';
+import { merchantLocationSchema, merchantStatusSchema } from '@tbox.cn/app-contracts-mall';
+
+beforeEach(() => {
+  __resetMockMemberState();
+});
+import type { ParkingQueryContext, PromotionQueryContext, ShopRecord, ShoppingQueryContext } from '@tbox.cn/app-contracts-mall';
+
+const parkCtx: ParkingQueryContext = {
+  scope: { miniAppId: 'demo-app', mallId: 'mall-demo' },
+  requestContext: { credentials: {} },
+} as ParkingQueryContext;
+const promoCtx = parkCtx as unknown as PromotionQueryContext;
+const shopCtx: ShoppingQueryContext = {
+  scope: { miniAppId: 'demo-app', mallId: 'mall-demo' },
+  requestContext: { credentials: {} },
+} as ShoppingQueryContext;
+
+/**
+ * 四域消费面契约锁：mock 实现必须覆盖模块消费的每个方法/属性。
+ * dag 铁律禁 provider import 模块类型 → 编译期强校验不可行；此处为运行时断言
+ * （架构约束下最优）。清单 = 各模块工具/服务消费面 grep 实况（时点快照，
+ * 模块新增消费方法需同步补清单）。
+ */
+function assertConsumedMethods(impl: unknown, methods: readonly string[], props: readonly string[] = []) {
+  for (const m of methods) {
+    expect(typeof (impl as Record<string, unknown>)[m], `mock 缺消费方法 ${m}`).toBe('function');
+  }
+  for (const p of props) {
+    expect((impl as Record<string, unknown>)[p], `mock 缺消费属性 ${p}`).not.toBeUndefined();
+  }
+}
+
+const MEMBER_CONSUMED_METHODS = [
+  'getAccount', 'getProfile', 'getCard', 'queryPoints', 'getBenefits', 'listPointUsage',
+  'queryDiscount', 'deductPoints', 'refundPoints', 'awardPoints', 'enroll',
+  'getEnrollmentStatus', 'getEnrollmentFormDefinition',
+] as const;
+const PARKING_CONSUMED_METHODS = [
+  'queryFee', 'listVehicles', 'listPaymentRecords', 'getPaymentRecordDetail', 'getInvoiceSettings',
+  'listInvoiceableOrders', 'queryParkingInfo', 'queryApplicableBenefits', 'locateVehicle',
+  'createOrder', 'getOrderInfo', 'getPaymentSign', 'uploadResult', 'reconcile', 'reprice',
+  'applyInvoice', 'bindVehicle', 'unbindVehicle',
+] as const;
+const PROMOTION_CONSUMED_METHODS = [
+  'searchOffers', 'getOfferDetail', 'recommendOffers', 'listEntitlements', 'getEntitlementDetail',
+  'listActivities', 'getActivityDetail', 'listActivityCategories', 'acquire',
+] as const;
+const SHOPPING_CONSUMED_METHODS = [
+  'searchShops', 'getShop', 'listCategories', 'getDirectory', 'searchProducts', 'getProduct', 'getFacets',
+] as const;
+
+describe('provider-mock：四域消费面契约锁（防少方法回归）', () => {
+  it('member 消费方法全存在（含 getEnrollmentFormDefinition，enrollUrl 属性）', () => {
+    assertConsumedMethods(new MockMemberServiceImpl(), MEMBER_CONSUMED_METHODS, ['enrollUrl']);
+  });
+  it('parking 消费方法全存在', () => {
+    assertConsumedMethods(new MockParkingServiceImpl('mall-demo'), PARKING_CONSUMED_METHODS);
+  });
+  it('promotion 消费方法全存在', () => {
+    assertConsumedMethods(new MockPromotionServiceImpl(), PROMOTION_CONSUMED_METHODS);
+  });
+  it('shopping 消费方法全存在', () => {
+    assertConsumedMethods(new MockShoppingServiceImpl(), SHOPPING_CONSUMED_METHODS);
+  });
+});
+
+describe('provider-mock：mock 实现 Port 面与厂商中立', () => {
+  it('member：开户/卡面/积分/流水/入会闭环，ref 恒 demo: 前缀', async () => {
+    const member = new MockMemberServiceImpl();
+    await expect(member.getAccount('u1')).resolves.toMatchObject({ state: 'not_enrolled' });
+    await member.enroll({ userId: 'u1', identity: 'enrollment_submission', fieldValues: {}, acceptedConsentIds: [], idempotencyKey: 'k1' });
+    await expect(member.getAccount('u1')).resolves.toMatchObject({ state: 'active', memberRef: 'demo:member:u1' });
+    await expect(member.getCard('u1')).resolves.toMatchObject({ cardDisplay: '示例会员卡', cardRef: 'demo:card:u1' });
+    await expect(member.queryPoints('u1')).resolves.toMatchObject({ balance: 300 });
+    const usage = await member.listPointUsage('u1', 1, 10);
+    expect(usage.items[0].usageRecordRef.startsWith('demo:')).toBe(true);
+    // CTA 卡 schema enrollUrl min(1)：mock 自持非空 demo 深链（厂商中立 + alipays:// 形态）
+    expect(member.enrollUrl).toMatch(/^alipays:\/\//);
+  });
+
+  it('parking：报价/权益/reprice/支付三步链（reconcile 恒 PAID），ref 恒 demo: 前缀', async () => {
+    const parking = new MockParkingServiceImpl('mall-demo');
+    const quote = (await parking.queryFee(parkCtx, { plateNo: 'demo-plate' }))[0];
+    expect(quote).toMatchObject({ plateNo: 'demo-plate', payableCents: 1500, paymentState: 'UNPAID' });
+    expect(quote?.quoteRef.startsWith('demo:quote:')).toBe(true);
+    const benefits = await parking.queryApplicableBenefits(parkCtx, 'demo-plate');
+    expect(benefits).toHaveLength(2);
+    const repriced = await parking.reprice(parkCtx, quote!.quoteRef, [benefits[0].benefitRef]);
+    expect(repriced.discountCents).toBeGreaterThan(0);
+    const order = await parking.createOrder(parkCtx, quote!.quoteRef);
+    expect(order.paymentRef.startsWith('demo:payment:')).toBe(true);
+    await expect(parking.reconcile(parkCtx, order.paymentRef)).resolves.toBe('PAID');
+  });
+
+  it('promotion：搜索/精查/推荐/资产/领取闭环，ref 恒 demo: 前缀', async () => {
+    const promotion = new MockPromotionServiceImpl();
+    const page = await promotion.searchOffers(promoCtx, { keyword: '' });
+    expect(page.items.length).toBeGreaterThanOrEqual(2);
+    expect(page.items.every((o) => o.offerRef.startsWith('demo:'))).toBe(true);
+    const detail = await promotion.getOfferDetail(promoCtx, { offerRef: 'demo:coupon:1001' });
+    expect(detail?.title).toContain('满 100 减 20');
+    const op = await promotion.acquire(promoCtx, { offerRef: 'demo:coupon:1001', externalMemberRef: 'demo:member:u1', idempotencyKey: 'k1' });
+    expect(op.status).toBe('SUCCEEDED');
+  });
+});
+
+describe('provider-mock：serverModule 形态（无卡模块 + adapter 注册）', () => {
+  it('cards 空 map + register 注册五 adapter/换码器/路由（真实 ServerContext 面）', () => {
+    expect(Object.keys(serverModule.cards)).toHaveLength(0);
+    expect(serverModule.declaration.moduleId).toBe('provider-mock');
+    const registered: Array<[string, string, unknown]> = [];
+    const exchangers: string[] = [];
+    const routers: string[] = [];
+    const ctx = {
+      integrations: { registerAdapter: (p: string, i: string, f: unknown) => registered.push([p, i, f]) },
+      authExchanges: { register: (e: { provider: string }) => exchangers.push(e.provider) },
+      routes: { register: (id: string) => routers.push(id) },
+    };
+    serverModule.register(ctx as never);
+    expect(registered.map(([p, i]) => `${p}\u0000${i}`)).toEqual([
+      'mock\u0000mock-member@1',
+      'mock\u0000mock-parking@1',
+      'mock\u0000mock-promotion@1',
+      'mock\u0000mock-shopping@1',
+      'mock\u0000mock-mall-info@1',
+    ]);
+    // 入会闭环接线：scoped alipay 换码器 + demo 入会路由
+    expect(exchangers).toEqual(['alipay']);
+    expect(routers).toEqual(['provider-mock']);
+  });
+});
+
+describe('provider-mock：shopping mock 行为（seed 派生 + 过滤矩阵）', () => {
+  const impl = new MockShoppingServiceImpl();
+
+  it('无参搜索 = 全量 12 家，分页 hasMore 正确', async () => {
+    const p1 = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10 });
+    expect(p1.total).toBe(12);
+    expect(p1.items).toHaveLength(10);
+    expect(p1.hasMore).toBe(true);
+    const p2 = await impl.searchShops({ ctx: shopCtx, page: 2, pageSize: 10 });
+    expect(p2.items).toHaveLength(2);
+    expect(p2.hasMore).toBe(false);
+  });
+
+  it('关键词大小写归一：NIKE 与 nike 均命中 2 家', async () => {
+    const a = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10, keywords: ['NIKE'] });
+    const b = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10, keywords: ['nike'] });
+    expect(a.total).toBe(2);
+    expect(b.total).toBe(2);
+    expect(a.items.map((s) => s.name).sort()).toEqual(['NIKE 专卖店', 'NIKE 跑步体验店']);
+  });
+
+  it('关键词多字段命中（名称/品牌/类目）', async () => {
+    const byCat = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10, keywords: ['运动'] });
+    expect(byCat.total).toBe(3); // 运动服饰三店（类目命中）
+    const byBrand = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10, keywords: ['NIKE'] });
+    expect(byBrand.total).toBe(2); // 品牌命中
+  });
+
+  it('类目等值过滤', async () => {
+    const page = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10, businessCategory: '餐饮' });
+    expect(page.total).toBe(4);
+    expect(page.items.every((s) => s.businessCategories.includes('餐饮'))).toBe(true);
+  });
+
+  it('楼层等值过滤', async () => {
+    const page = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10, floorCode: '3 楼' });
+    expect(page.total).toBe(3);
+    expect(page.items.every((s) => s.location.floorName === '3 楼')).toBe(true);
+  });
+
+  it('楼栋等值过滤', async () => {
+    const page = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10, buildingCode: 'A 栋' });
+    expect(page.total).toBe(12);
+  });
+
+  it('组合过滤 AND 语义', async () => {
+    const hit = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10, businessCategory: '运动服饰', floorCode: '3 楼' });
+    expect(hit.total).toBe(3);
+    const miss = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10, businessCategory: '餐饮', floorCode: '3 楼' });
+    expect(miss.total).toBe(0);
+  });
+
+  it('无命中 = total 0', async () => {
+    const page = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10, keywords: ['不存在的品牌'] });
+    expect(page.total).toBe(0);
+    expect(page.items).toHaveLength(0);
+  });
+
+  it('getShop：命中/未命中/入参 trim', async () => {
+    const hit = await impl.getShop('demo-shop-1007', shopCtx);
+    expect(hit?.name).toBe('NIKE 专卖店');
+    const trimmed = await impl.getShop(' demo-shop-1007 ', shopCtx);
+    expect(trimmed?.merchantId).toBe('demo-shop-1007');
+    await expect(impl.getShop('demo-shop-9999', shopCtx)).resolves.toBeNull();
+  });
+
+  it('listCategories：6 类目，code=name，merchantCount 正确', async () => {
+    const cats = await impl.listCategories(shopCtx);
+    expect(cats).toHaveLength(6);
+    expect(cats.every((c) => c.code === c.name)).toBe(true);
+    expect(cats.find((c) => c.name === '餐饮')?.merchantCount).toBe(4);
+    const page = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10 });
+    const shopCats = new Set(page.items.flatMap((s) => s.businessCategories));
+    expect(cats.map((c) => c.code).every((c) => shopCats.has(c))).toBe(true);
+  });
+
+  it('getDirectory：mallId 来自 ctx，楼层计数 = 门店数，floorCode 派生同值', async () => {
+    const dir = await impl.getDirectory(shopCtx);
+    expect(dir?.mallId).toBe('mall-demo');
+    expect(dir?.mallName).toBe('示例商场');
+    expect(dir?.buildings).toHaveLength(1);
+    expect(dir?.buildings[0].floors).toHaveLength(5);
+    expect(dir?.buildings[0].floors.find((f) => f.floorName === '3 楼')?.merchantCount).toBe(3);
+    expect(dir?.buildings[0].floors.every((f) => f.floorCode === f.floorName)).toBe(true);
+  });
+
+  it('派生 ShopRecord 过契约 schema（location/status）', async () => {
+    const page = await impl.searchShops({ ctx: shopCtx, page: 1, pageSize: 10 });
+    for (const s of page.items as readonly ShopRecord[]) {
+      expect(merchantLocationSchema.safeParse(s.location).success).toBe(true);
+      expect(merchantStatusSchema.safeParse(s.status).success).toBe(true);
+    }
+  });
+
+  it('member：getEnrollmentFormDefinition 返回合法表单定义（queryEnrollmentForm 工具消费）', async () => {
+    const member = new MockMemberServiceImpl();
+    const def = await member.getEnrollmentFormDefinition();
+    expect(def.formVersion).toBe('demo-v1');
+    expect(def.fields).toHaveLength(2);
+    expect(def.consents).toHaveLength(1);
+    expect(def.authorizationStatus).toBe('required');
+  });
+});
+
+describe('provider-mock：入会闭环共享 store（C5）', () => {
+  // 模块级共享状态：用例间复位，防串扰
+
+  it('状态跨实例共享：A 实例入会 → B 实例（factory 每请求新建）读到 active', async () => {
+    const a = new MockMemberServiceImpl();
+    const b = new MockMemberServiceImpl();
+    await a.enroll({ userId: 'u1', identity: 'enrollment_submission', fieldValues: {}, acceptedConsentIds: [], idempotencyKey: 'k1' });
+    await expect(b.getAccount('u1')).resolves.toMatchObject({ state: 'active' });
+    await expect(b.getCard('u1')).resolves.toMatchObject({ cardRef: 'demo:card:u1' });
+  });
+
+  it('默认访客：demo-user 初始 not_enrolled（无种子——首进首页即「立即加入会员」）', async () => {
+    const member = new MockMemberServiceImpl();
+    await expect(member.getAccount(MOCK_SHELL_USER_ID)).resolves.toMatchObject({
+      authState: 'authenticated',
+      state: 'not_enrolled',
+    });
+    await expect(member.getCard(MOCK_SHELL_USER_ID)).resolves.toBeNull();
+  });
+
+  it('enrollMockMember 幂等翻状态 + 余额缺省 300', async () => {
+    enrollMockMember(MOCK_SHELL_USER_ID);
+    enrollMockMember(MOCK_SHELL_USER_ID); // 幂等
+    const member = new MockMemberServiceImpl();
+    await expect(member.getAccount(MOCK_SHELL_USER_ID)).resolves.toMatchObject({
+      state: 'active',
+      memberRef: 'demo:member:demo-user',
+    });
+    await expect(member.queryPoints(MOCK_SHELL_USER_ID)).resolves.toMatchObject({ balance: 300 });
+    expect(isMockMemberEnrolled(MOCK_SHELL_USER_ID)).toBe(true);
+  });
+});
+
+describe('provider-mock：mock 入会落地路由（resolveMockEnroll 纯决策）', () => {
+
+  it('有身份 + 无参 → 缺省 demo-user 翻状态返 200', () => {
+    const outcome = resolveMockEnroll({ body: {}, identity: { source: 'dev' } });
+    expect(outcome).toEqual({ status: 200, body: { state: 'active', memberRef: 'demo:member:demo-user' } });
+    expect(isMockMemberEnrolled('demo-user')).toBe(true);
+  });
+
+  it('定向 userId（curl 翻浏览器 dev 用户）', () => {
+    const outcome = resolveMockEnroll({ body: { userId: 'dev_h5' }, identity: { source: 'dev' } });
+    expect(outcome).toEqual({ status: 200, body: { state: 'active', memberRef: 'demo:member:dev_h5' } });
+    expect(isMockMemberEnrolled('dev_h5')).toBe(true);
+  });
+
+  it('幂等：同 userId 两次均 200', () => {
+    const identity = { source: 'dev' as const };
+    expect(resolveMockEnroll({ body: {}, identity }).status).toBe(200);
+    expect(resolveMockEnroll({ body: {}, identity }).status).toBe(200);
+  });
+
+  it('匿名/无身份 → 401（不随 AUTH_MODE 放宽）', () => {
+    expect(resolveMockEnroll({ body: {}, identity: null }).status).toBe(401);
+    expect(resolveMockEnroll({ body: {}, identity: { source: 'anonymous' } }).status).toBe(401);
+    expect(isMockMemberEnrolled('demo-user')).toBe(false);
+  });
+
+  it('NODE_ENV=production → 503（mock 不进生产装配，双保险）', () => {
+    expect(resolveMockEnroll({ body: {}, identity: { source: 'dev' }, nodeEnv: 'production' }).status).toBe(503);
+    expect(isMockMemberEnrolled('demo-user')).toBe(false);
+  });
+});
+
+describe('provider-mock：登出态（logout 路由 + 换码降级 GUEST 形态 + getAccount 感知）', () => {
+  it('resolveMockLogout：有身份 → 200 翻登出态；enroll 清除登出态', () => {
+    __resetMockMemberState();
+    enrollMockMember('demo-user');
+    expect(isMockMemberLoggedOut('demo-user')).toBe(false);
+    const outcome = resolveMockLogout({ body: {}, identity: { source: 'dev' } });
+    expect(outcome).toEqual({ status: 200, body: { state: 'logged_out' } });
+    expect(isMockMemberLoggedOut('demo-user')).toBe(true);
+    // 重登录（enroll）清除登出态——与真实链同构（gate 页登录成功后厂商侧登录态恢复）
+    enrollMockMember('demo-user');
+    expect(isMockMemberLoggedOut('demo-user')).toBe(false);
+  });
+
+  it('resolveMockLogout：匿名/无身份 → 401；production → 503（与 enroll 同形）', () => {
+    __resetMockMemberState();
+    expect(resolveMockLogout({ body: {}, identity: null }).status).toBe(401);
+    expect(resolveMockLogout({ body: {}, identity: { source: 'anonymous' } }).status).toBe(401);
+    expect(resolveMockLogout({ body: {}, identity: { source: 'dev' }, nodeEnv: 'production' }).status).toBe(503);
+    expect(isMockMemberLoggedOut('demo-user')).toBe(false);
+  });
+
+  it('登出态 getAccount → not_enrolled（入会半屏触发判据）；enroll 清登出态 → active', async () => {
+    // 对齐真实档降级会话语义（token 空 + visitortoken → not_enrolled）：登出态不得误报 active，
+    // 否则降级后会员查询直接放行、半屏闭环永不触发。
+    __resetMockMemberState();
+    enrollMockMember(MOCK_SHELL_USER_ID);
+    logoutMockMember(MOCK_SHELL_USER_ID);
+    const member = new MockMemberServiceImpl();
+    await expect(member.getAccount(MOCK_SHELL_USER_ID)).resolves.toMatchObject({ state: 'not_enrolled' });
+    await expect(member.getCard(MOCK_SHELL_USER_ID)).resolves.toBeNull();
+    // enroll 即清登出态（mock-enrollment 页「同意协议并登录」回调）→ 冷登回 MEMBER → active
+    enrollMockMember(MOCK_SHELL_USER_ID);
+    await expect(member.getAccount(MOCK_SHELL_USER_ID)).resolves.toMatchObject({ state: 'active' });
+  });
+});

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "types": ["node"]
+  },
+  "include": ["src", "tests"]
+}

package/tsup.config.ts

@@ -0,0 +1,26 @@
+import { defineConfig } from 'tsup';
+
+export default defineConfig({
+  entry: {
+    index: 'src/index.ts',
+    'server/index': 'src/server/index.ts',
+  },
+  format: ['esm'],
+  target: 'node20',
+  platform: 'node',
+  outDir: 'dist',
+  clean: true,
+  sourcemap: false,
+  // dts worker 以命令行式传参会撞 TS5074(incremental 需单文件 emit 或 tsBuildInfoFile);
+  // 声明产物一次性构建无需增量——仅 dts 关闭,typecheck 的增量缓存不受影响。
+  dts: { compilerOptions: { incremental: false } },
+  external: [
+    '@tbox.cn/app-sdk',
+    '@tbox.cn/app-contracts',
+    '@tbox.cn/app-contracts-mall',
+    // mock-enroll-route 挂 express Router（devDep 不自动外部化——沿 module-member 先例显式声明，
+    // 防 express 被 bundle 进 dist（体积膨胀 + 宿主双实例））
+    'express',
+    'zod',
+  ],
+});