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

package/tests/samples.test.ts

@@ -0,0 +1,42 @@
+/**
+ * samples 双断言（迁移自 mall dev-gallery 优惠券链路画廊守卫）：
+ * 全样本 dataSchema.safeParse 通过 + findSampleShapeViolations 无越界键（样本即契约）。
+ */
+import { describe, expect, it } from 'vitest';
+import { findSampleShapeViolations } from '@tbox.cn/app-sdk/server';
+import offerListMeta from '../src/server/cards/promotion-offer-list/meta';
+import entitlementListMeta from '../src/server/cards/promotion-entitlement-list/meta';
+
+const metas = [offerListMeta, entitlementListMeta];
+
+describe('promotion samples 双断言（样本即契约）', () => {
+  for (const meta of metas) {
+    it(`${meta.cardType}: 全样本过 schema + shape 无越界`, () => {
+      expect(meta.samples?.length ?? 0).toBeGreaterThan(0);
+      expect(findSampleShapeViolations(meta).violations).toEqual([]);
+      for (const s of meta.samples ?? []) {
+        expect(
+          meta.dataSchema.safeParse(s.data).success,
+          `${meta.cardType}/${s.label}`,
+        ).toBe(true);
+      }
+    });
+  }
+
+  it('样本集 9 格（offer-list 6 + entitlement-list 3）且券图为内联 SVG 占位', () => {
+    expect(offerListMeta.samples).toHaveLength(6);
+    expect(entitlementListMeta.samples).toHaveLength(3);
+    const serialized = JSON.stringify(metas.map((m) => m.samples));
+    expect(serialized).toContain('data:image/svg+xml');
+    // 结构性断言：样本图片只允许内联 SVG 或缺省——不允许任何外域图床
+    for (const meta of metas) {
+      for (const s of meta.samples ?? []) {
+        for (const item of (s.data as { items?: { imageUrl?: string }[] }).items ?? []) {
+          if (item.imageUrl) {
+            expect(item.imageUrl.startsWith('data:image/svg+xml'), `${meta.cardType}/${s.label}`).toBe(true);
+          }
+        }
+      }
+    }
+  });
+});

package/tests/view.test.ts

@@ -0,0 +1,61 @@
+/**
+ * promotion 展示纯函数单测（0.4.0 D6：node 环境）。
+ */
+import { describe, expect, it } from 'vitest';
+import {
+  entitlementStatusLabel,
+  entitlementTone,
+  offerTypeLabel,
+  resultStatusText,
+  resultTone,
+  sessionStatusText,
+  sessionTone,
+} from '../src/client/cards/view';
+
+describe('offerTypeLabel', () => {
+  it('五种类型 + 兜底', () => {
+    expect(offerTypeLabel('COUPON')).toBe('优惠券');
+    expect(offerTypeLabel('BUNDLE')).toBe('组合券');
+    expect(offerTypeLabel('PROMOTION')).toBe('促销');
+    expect(offerTypeLabel('ACTIVITY')).toBe('活动');
+    expect(offerTypeLabel('GROUPON')).toBe('团购');
+    expect(offerTypeLabel('NOPE')).toBe('优惠');
+  });
+});
+
+describe('entitlement 状态映射', () => {
+  it('文案', () => {
+    expect(entitlementStatusLabel('EFFECTIVE')).toBe('可用');
+    expect(entitlementStatusLabel('USED')).toBe('已使用');
+    expect(entitlementStatusLabel('EXPIRED')).toBe('已过期');
+    expect(entitlementStatusLabel('INVALID')).toBe('已失效');
+    expect(entitlementStatusLabel('X')).toBe('未知');
+  });
+  it('tone', () => {
+    expect(entitlementTone('EFFECTIVE')).toBe('available');
+    expect(entitlementTone('USED')).toBe('unavailable');
+    expect(entitlementTone('UNKNOWN')).toBe('neutral');
+  });
+});
+
+describe('operation-result 三态', () => {
+  it('tone + 文案', () => {
+    expect(resultTone('SUCCEEDED')).toBe('succeeded');
+    expect(resultTone('PENDING_AUTHORITY')).toBe('pending');
+    expect(resultTone('REJECTED')).toBe('rejected');
+    expect(resultStatusText('SUCCEEDED')).toBe('成功');
+    expect(resultStatusText('PENDING_AUTHORITY')).toBe('确认中');
+    expect(resultStatusText('REJECTED')).toBe('失败');
+  });
+});
+
+describe('activity session 状态', () => {
+  it('tone + 文案', () => {
+    expect(sessionTone('OPEN')).toBe('available');
+    expect(sessionTone('FULL')).toBe('unavailable');
+    expect(sessionTone('CLOSED')).toBe('unavailable');
+    expect(sessionStatusText('OPEN')).toBe('可报名');
+    expect(sessionStatusText('FULL')).toBe('已满');
+    expect(sessionStatusText('CLOSED')).toBe('已结束');
+  });
+});

package/tsup.config.ts

@@ -12,7 +12,9 @@ export default defineConfig({
   outDir: 'dist',
   clean: true,
   sourcemap: false,
-  dts: true,
+  // dts worker 以命令行式传参会撞 TS5074(incremental 需单文件 emit 或 tsBuildInfoFile);
+  // 声明产物一次性构建无需增量——仅 dts 关闭,typecheck 的增量缓存不受影响。
+  dts: { compilerOptions: { incremental: false } },
   external: [
     '@tbox.cn/app-sdk',
     '@tbox.cn/app-contracts',
@@ -22,7 +24,13 @@ export default defineConfig({
     'zod',
     '@mastra/core',
     'express',
+    '@phosphor-icons/react',
   ],
+  // 0.3.2/0.4.0 D1：模块自持 CSS 出货链。
+  // 顶层 loader 写法（实测：esbuildOptions 内设 loader 被 tsup 覆盖失效——CSS 提取断链静默丢失）。
+  loader: {
+    '.css': 'copy',
+  },
   esbuildOptions(options) {
     options.jsx = 'automatic';
   },

package/dist/chunk-AD6OLHSM.js

@@ -1,86 +0,0 @@
-// src/server/service.ts
-var InMemoryPromotionService = class {
-  constructor(getMember) {
-    this.getMember = getMember;
-  }
-  getMember;
-  async queryEligibleCoupons(userId) {
-    const member = this.getMember();
-    const points = member ? await member.queryPoints(userId) : { level: "silver" };
-    const coupons = [
-      {
-        couponId: `coupon_${userId}_${points.level}`,
-        title: points.level === "platinum" ? "\u94C2\u91D1\u4E13\u4EAB\u505C\u8F66\u5238" : points.level === "gold" ? "\u91D1\u5361\u505C\u8F66\u5238" : "\u505C\u8F66\u4F18\u60E0\u5238",
-        amount: points.level === "platinum" ? 10 : points.level === "gold" ? 5 : 2,
-        status: "AVAILABLE"
-      }
-    ];
-    return coupons;
-  }
-};
-
-// src/server/cards/coupon/meta.ts
-import { z } from "zod";
-var dataSchema = z.object({
-  couponId: z.string(),
-  title: z.string(),
-  amount: z.number(),
-  status: z.enum(["AVAILABLE", "USED", "EXPIRED"])
-});
-var meta = {
-  cardType: "coupon",
-  dataSchema,
-  allowedTools: [],
-  displayName: "\u4F18\u60E0\u5238\u5361",
-  description: "\u5C55\u793A\u63A8\u8350\u53D1\u653E\u7684\u4F18\u60E0\u5238",
-  sampleData: { couponId: "coupon_u_1_gold", title: "\u91D1\u5361\u505C\u8F66\u5238", amount: 5, status: "AVAILABLE" },
-  schemaVersion: 1
-};
-var meta_default = meta;
-
-// src/server/handler.ts
-function createPromotionHandler(ctx) {
-  return {
-    id: "promotion",
-    handle: async (_action, payload) => {
-      const promotion = ctx.resolveService("promotion");
-      if (!promotion) return { cards: [], text: "\u8425\u9500\u670D\u52A1\u4E0D\u53EF\u7528" };
-      const { userId } = payload ?? {};
-      if (!userId) return { cards: [], text: "\u7F3A\u5C11 userId" };
-      const coupons = await promotion.queryEligibleCoupons(userId);
-      if (coupons.length === 0) return { cards: [], text: "\u6682\u65E0\u53EF\u7528\u4F18\u60E0\u5238" };
-      return {
-        cards: [{ cardType: "coupon", data: coupons[0] }],
-        text: `\u63A8\u8350 ${coupons[0].title}\uFF08\u53EF\u62B5 ${coupons[0].amount} \u5143\uFF09`
-      };
-    }
-  };
-}
-
-// src/server/index.ts
-var currentCtx = null;
-var promotionSingleton = null;
-var cards = {
-  coupon: meta_default
-};
-var serverModule = {
-  cards,
-  register(ctx) {
-    currentCtx = ctx;
-    if (!promotionSingleton) {
-      promotionSingleton = new InMemoryPromotionService(
-        () => currentCtx?.resolveService("member")
-      );
-    }
-    const promotion = promotionSingleton;
-    ctx.services.register("promotion", promotion);
-    ctx.cards.registerMap(cards);
-    ctx.handlers.register(createPromotionHandler(ctx));
-  }
-};
-
-export {
-  InMemoryPromotionService,
-  meta_default,
-  serverModule
-};

package/dist/chunk-LQGF6337.js

@@ -1,32 +0,0 @@
-// src/client/cards/coupon/index.tsx
-import { jsx, jsxs } from "react/jsx-runtime";
-function CouponCard({ data }) {
-  return /* @__PURE__ */ jsxs("div", { className: "mall-card mall-card--coupon", children: [
-    /* @__PURE__ */ jsx("div", { className: "mall-card__title", children: data.title }),
-    /* @__PURE__ */ jsxs("div", { className: "mall-card__amount", children: [
-      "-",
-      data.amount,
-      " \u5143"
-    ] }),
-    /* @__PURE__ */ jsxs("div", { className: "mall-card__meta", children: [
-      data.couponId,
-      " \xB7 ",
-      data.status
-    ] })
-  ] });
-}
-
-// src/client/index.ts
-var cards = {
-  coupon: CouponCard
-};
-var clientModule = {
-  cards,
-  register(ctx) {
-    ctx.cards.registerMap(cards);
-  }
-};
-
-export {
-  clientModule
-};

package/src/client/cards/coupon/index.tsx

@@ -1,12 +0,0 @@
-import type { CouponCardData } from '../../../server/cards/coupon/meta';
-
-/** 优惠券卡组件 */
-export function CouponCard({ data }: { data: CouponCardData; cardId: string; isHistory: boolean }) {
-  return (
-    <div className="mall-card mall-card--coupon">
-      <div className="mall-card__title">{data.title}</div>
-      <div className="mall-card__amount">-{data.amount} 元</div>
-      <div className="mall-card__meta">{data.couponId} · {data.status}</div>
-    </div>
-  );
-}

package/src/server/cards/coupon/meta.ts

@@ -1,23 +0,0 @@
-import { z } from 'zod';
-import type { CardMeta } from '@tbox.cn/app-contracts';
-
-export const dataSchema = z.object({
-  couponId: z.string(),
-  title: z.string(),
-  amount: z.number(),
-  status: z.enum(['AVAILABLE', 'USED', 'EXPIRED']),
-});
-
-export type CouponCardData = z.infer<typeof dataSchema>;
-
-const meta: CardMeta<typeof dataSchema> = {
-  cardType: 'coupon',
-  dataSchema,
-  allowedTools: [],
-  displayName: '优惠券卡',
-  description: '展示推荐发放的优惠券',
-  sampleData: { couponId: 'coupon_u_1_gold', title: '金卡停车券', amount: 5, status: 'AVAILABLE' },
-  schemaVersion: 1,
-};
-
-export default meta;

package/tbox.component.json

@@ -1,20 +0,0 @@
-{
-  "schemaVersion": 1,
-  "name": "module-promotion",
-  "version": "0.2.0",
-  "kind": "business",
-  "risk": { "level": "low", "writeBoundary": "source" },
-  "distribution": { "defaultMode": "codegen" },
-  "contributes": {
-    "handlers": ["promotion"],
-    "tools": [],
-    "cards": [{ "cardType": "coupon", "schemaVersion": 1 }],
-    "routes": [],
-    "pages": [],
-    "tabs": []
-  },
-  "dependencies": {
-    "modules": [{ "id": "contracts-mall", "required": true }]
-  },
-  "env": []
-}

package/tests/service.test.ts

@@ -1,31 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { createServerContext } from '@tbox.cn/app-sdk/server';
-import { serverModule } from '../src/server/index';
-
-describe('module-promotion 资格校验与降级链', () => {
-  it('serverModule.register 注册 card/service/handler', () => {
-    const ctx = createServerContext();
-    serverModule.register(ctx);
-    expect(ctx.cards.has('coupon')).toBe(true);
-    expect(ctx.handlers.has('promotion')).toBe(true);
-    expect(ctx.resolveService('promotion')).toBeDefined();
-  });
-
-  it('降级链：silver → 2 元券 / gold → 5 元券 / platinum → 10 元券', async () => {
-    const ctx = createServerContext();
-    // stub member 供 promotion 查询等级
-    ctx.services.register('member', {
-      queryPoints: async (userId: string) => {
-        const level = userId === 'u_gold' ? 'gold' : userId === 'u_platinum' ? 'platinum' : 'silver';
-        return { userId, balance: 100, level: level as 'silver' | 'gold' | 'platinum' };
-      },
-      queryDiscount: async () => undefined,
-    });
-    serverModule.register(ctx);
-    const promotion = ctx.resolveService<{ queryEligibleCoupons(u: string): Promise<{ amount: number }[]> }>('promotion')!;
-
-    expect((await promotion.queryEligibleCoupons('u_silver'))[0].amount).toBe(2);
-    expect((await promotion.queryEligibleCoupons('u_gold'))[0].amount).toBe(5);
-    expect((await promotion.queryEligibleCoupons('u_platinum'))[0].amount).toBe(10);
-  });
-});