@tbox.cn/app-module-promotion 0.2.0 → 0.9.4

package/tests/ports-resolve.test.ts

@@ -0,0 +1,96 @@
+/**
+ * promotion ports 017 槽位原子化回归锁（四槽同构矩阵）：offers/entitlements/activities/acquisition。
+ * - 槽位命中 → adapter 产物 + service 参数 = 槽 id；
+ * - PROVIDER_NOT_IMPLEMENTED → 上抛（配置即声明）；
+ * - 预期缺席三码 → InMemoryPromotionService 兜底；
+ * - 其余错误原样上抛；槽级隔离（acquisition 缺席不影响 offers 命中）。
+ */
+import { describe, expect, it } from 'vitest';
+import type { RequestContext } from '@tbox.cn/app-contracts';
+import { createServerContext } from '@tbox.cn/app-sdk/server';
+import type { ServerContext } from '@tbox.cn/app-sdk/server';
+import {
+  inMemoryPromotion,
+  resolvePromotionAcquisitionPort,
+  resolvePromotionActivitiesPort,
+  resolvePromotionEntitlementsPort,
+  resolvePromotionOffersPort,
+} from '../src/server/ports';
+
+function requestContext(mallId = 'mall-demo'): RequestContext {
+  return {
+    identity: { userId: 'u_1001', source: 'dev' },
+    credentials: { provider: 'dev', token: 'user-token' },
+    attributes: { mall: { miniAppId: 'app', mallId } },
+  };
+}
+
+function ctxWithIntegrations(resolveService: (input: unknown) => Promise<unknown>): ServerContext {
+  const ctx = createServerContext({});
+  (ctx as { integrations?: unknown }).integrations = { resolveService };
+  return ctx;
+}
+
+const sentinel = { kind: 'slot-hit' } as unknown as never;
+
+const RESOLVERS = [
+  { name: 'promotion.offers', resolve: resolvePromotionOffersPort },
+  { name: 'promotion.entitlements', resolve: resolvePromotionEntitlementsPort },
+  { name: 'promotion.activities', resolve: resolvePromotionActivitiesPort },
+  { name: 'promotion.acquisition', resolve: resolvePromotionAcquisitionPort },
+] as const;
+
+describe('promotion ports 四槽解析（017 槽位原子化）', () => {
+  for (const { name, resolve } of RESOLVERS) {
+    it(`[${name}] T1 槽位命中 → adapter 产物 + service 参数 = 槽 id`, async () => {
+      let captured: unknown;
+      const ctx = ctxWithIntegrations(async (input) => {
+        captured = input;
+        return sentinel;
+      });
+      await expect(resolve(requestContext(), ctx)).resolves.toBe(sentinel);
+      expect(captured).toMatchObject({ service: name, scope: { mallId: 'mall-demo' } });
+    });
+
+    it(`[${name}] T2 PROVIDER_NOT_IMPLEMENTED → 上抛不兜底`, async () => {
+      const ctx = ctxWithIntegrations(async () => {
+        throw Object.assign(new Error('无 adapter'), { code: 'PROVIDER_NOT_IMPLEMENTED' });
+      });
+      await expect(resolve(requestContext(), ctx)).rejects.toMatchObject({
+        code: 'PROVIDER_NOT_IMPLEMENTED',
+      });
+    });
+
+    it(`[${name}] T3 预期缺席三码 → InMemoryPromotionService 单例`, async () => {
+      for (const code of ['PROVIDER_SERVICE_NOT_CONFIGURED', 'PROVIDER_INSTANCE_NOT_FOUND', 'PROVIDER_INSTANCE_DISABLED']) {
+        const ctx = ctxWithIntegrations(async () => {
+          throw Object.assign(new Error(code), { code });
+        });
+        await expect(resolve(requestContext(), ctx)).resolves.toBe(inMemoryPromotion);
+      }
+    });
+
+    it(`[${name}] T4 PROVIDER_NOT_FOUND → 原样上抛`, async () => {
+      const ctx = ctxWithIntegrations(async () => {
+        throw Object.assign(new Error('未命中 catalog'), { code: 'PROVIDER_NOT_FOUND' });
+      });
+      await expect(resolve(requestContext(), ctx)).rejects.toMatchObject({ code: 'PROVIDER_NOT_FOUND' });
+    });
+
+    it(`[${name}] T5 ctx 无 integrations → InMemory 兜底`, async () => {
+      const ctx = createServerContext({});
+      await expect(resolve(requestContext(), ctx)).resolves.toBe(inMemoryPromotion);
+    });
+  }
+
+  it('T6 槽级隔离：acquisition 缺席兜底，offers 照常命中（只读厂商 + InMemory 领取的显式形态）', async () => {
+    const ctx = ctxWithIntegrations(async (input: unknown) => {
+      if ((input as { service: string }).service === 'promotion.acquisition') {
+        throw Object.assign(new Error('未配置'), { code: 'PROVIDER_SERVICE_NOT_CONFIGURED' });
+      }
+      return sentinel;
+    });
+    await expect(resolvePromotionOffersPort(requestContext(), ctx)).resolves.toBe(sentinel);
+    await expect(resolvePromotionAcquisitionPort(requestContext(), ctx)).resolves.toBe(inMemoryPromotion);
+  });
+});

package/tests/pretool-coupons.test.ts

@@ -0,0 +1,63 @@
+/**
+ * W5 P1 / W2 / W7 promotion 切片验收（2026-09-01）：
+ * - 出参体积门：listCoupons CLAIMABLE 档出参 JSON 实测 ≤ 2KB（超限即撤 preTool 的 go/no-go 门）；
+ * - 15 工具 description 含预告知句（withCardEmissionHint 单点 wrap）；
+ * - note 契约：列表卡 note 含数量+首项标题、best-deal note 含测算金额（不再静态句）。
+ */
+import { describe, expect, it } from 'vitest';
+import { InMemoryPromotionService } from '../src/server/service';
+import { createPromotionTools, offerSummary } from '../src/server/tools';
+import { CARD_EMISSION_HINT_BASE } from '@tbox.cn/app-sdk/server';
+import type { PromotionQueryContext } from '@tbox.cn/app-contracts-mall';
+
+const q = {
+  scope: { miniAppId: 'app', mallId: 'mall-1' },
+  subjectId: 'u_1',
+  requestContext: {},
+} as never as PromotionQueryContext;
+
+describe('listCoupons 出参体积门（P1 go/no-go）', () => {
+  it('CLAIMABLE 档 mock 出参 JSON ≤ 2048 字符（offerSummary 投影形态）', async () => {
+    const service = new InMemoryPromotionService();
+    const page = await service.searchOffers(q, { offerTypes: ['COUPON'] });
+    const facts = {
+      presentation: 'coupon' as const,
+      mode: 'claimable' as const,
+      summary: '可领取优惠券',
+      items: page.items.map(offerSummary),
+    };
+    const json = JSON.stringify(facts);
+    // go/no-go：> 2048 字符 → preTool listCoupons 必须整体撤除（index.ts）并记录 Agent Note
+    expect(json.length).toBeLessThanOrEqual(2048);
+  });
+});
+
+describe('withCardEmissionHint：出卡工具预告知（W2）', () => {
+  const tools = createPromotionTools({
+    getCtx: () => {
+      throw new Error('promotion 模块未注册');
+    },
+  });
+
+  it('15 个出卡工具 description 含预告知句', () => {
+    for (const tool of Object.values(tools)) {
+      expect(tool.description).toContain(CARD_EMISSION_HINT_BASE);
+    }
+  });
+});
+
+describe('note 契约（W7）：关键事实前置', () => {
+  it('offerSummary 含 title（列表卡 note 的首项事实源）', () => {
+    const summary = offerSummary({
+      offerRef: 'o1',
+      title: '满 100 减 20',
+      offerType: 'COUPON',
+      tags: [],
+      validity: { end: '' },
+      facets: [],
+      availability: { status: 'AVAILABLE', reasonCodes: [], evaluatedAt: '', authoritative: true },
+      priceText: '免费',
+    } as never);
+    expect(summary.title).toBe('满 100 减 20');
+  });
+});