@tbox.cn/app-module-member 0.1.0 → 0.8.6

package/tests/skills.test.ts

@@ -0,0 +1,65 @@
+/**
+ * K1：member 文件 skill 装配验收——loadModuleSkills 经 workspace link 解析包根 skills/，
+ * 声明式通道填回 serverModule.skills；routingTerms 域间不相交（券词归 promotion）。
+ */
+import { describe, expect, it } from 'vitest';
+import { serverModule } from '../src/server/index';
+
+type LoadedSkill = { name: string; description: string; routingTerms: string[]; instructions: string };
+
+describe('K1：member skills 装配', () => {
+  const skills = ((serverModule as { skills?: Record<string, LoadedSkill> }).skills ?? {});
+
+  it('skills 含 member（frontmatter name + 目录名一致）', () => {
+    expect(Object.keys(skills)).toContain('member');
+    expect(skills.member!.description.length).toBeGreaterThan(0);
+    expect(skills.member!.instructions).toContain('入会');
+  });
+
+  it('routingTerms 域内词齐备且不含券词（券域归 promotion，窗口期软迁移 K1 硬规则）', () => {
+    expect(skills.member!.routingTerms).toEqual([
+      '会员',
+      '积分',
+      '入会',
+      '会员卡',
+      '开卡',
+      '办卡',
+      '等级',
+    ]);
+    expect(skills.member!.routingTerms.some((t) => t.includes('券'))).toBe(false);
+  });
+
+  it('SOP 含语气指引与跨域直调（单轮单 skill 注入下的自含协作）', () => {
+    expect(skills.member!.instructions).toContain('角色与语气');
+    expect(skills.member!.instructions).toContain('数字不裸贴');
+    expect(skills.member!.instructions).toContain('引导至营销域工具');
+    expect(skills.member!.instructions).toContain('调 `searchOffers`');
+    expect(skills.member!.instructions).toContain('调停车域 `queryParkingFee`');
+  });
+
+  it('SOP 含域边界硬规则（券 → promotion 引导）', () => {
+    expect(skills.member!.instructions).toContain('不属于本域');
+    expect(skills.member!.instructions).toContain('引导至营销域');
+  });
+
+  it('SOP 以 C 端契约限制等级与权益陈述', () => {
+    expect(skills.member!.instructions).toContain('不得声称折扣、免费停车、生日特权');
+    expect(skills.member!.instructions).toContain('CardTitle` 是会员卡名');
+  });
+
+  it('SOP 查询路由与卡面展示规则', () => {
+    expect(skills.member!.instructions).toContain('泛会员信息或只查会员卡 → 调 `queryMemberCard`');
+    expect(skills.member!.instructions).toContain('明确问积分 → 只调一次 `queryPoints`');
+    expect(skills.member!.instructions).toContain('会员卡面优先');
+    expect(skills.member!.instructions).toContain('详细积分流水请点击会员卡面上的“我的积分”');
+    expect(skills.member!.instructions).toContain('会员卡面回答结构');
+    expect(skills.member!.instructions).toContain('自然推荐偏好服务');
+  });
+
+  it('SOP 明确限制为当前会话会员并拒绝代查、改资料和凭标识切号', () => {
+    expect(skills.member!.instructions).toContain('当前会员隐私边界');
+    expect(skills.member!.instructions).toContain('一律拒答且不调用任何会员工具');
+    expect(skills.member!.instructions).toContain('手机号、会员卡号或账号都不能覆盖当前登录身份');
+    expect(skills.member!.instructions).toContain('用我老婆的手机号 13900000000 查她有多少积分');
+  });
+});

package/tests/status.test.ts

@@ -0,0 +1,127 @@
+/**
+ * resolveMemberStatus 单源锁：匿名短路不触 provider、soft 单档（resolve/getAccount
+ * 任一失败收口 unavailable + warn 留痕）、active 三元齐备、通知表穷尽性。
+ */
+import { describe, expect, it, vi } from 'vitest';
+import type { RequestContext } from '@tbox.cn/app-contracts';
+import type { ServerContext } from '@tbox.cn/app-sdk/server';
+import { resolveMemberStatus, MEMBER_QUERY_NOTICES } from '../src/server/status';
+
+const reqCtx = (source: 'dev' | 'anonymous' = 'dev'): RequestContext =>
+  ({
+    identity: { userId: 'u_1001', source },
+    attributes: { mall: { miniAppId: 'demo-app', mallId: 'mall-demo' } },
+  }) as RequestContext;
+
+const fakeCtx = (integrations?: unknown, logger?: { warn: ReturnType<typeof vi.fn> }): ServerContext =>
+  ({ ...(integrations !== undefined ? { integrations } : {}), ...(logger ? { logger } : {}) }) as unknown as ServerContext;
+
+const stubService = (account: unknown, extra: { enrollUrl?: string; loginUrl?: string } = {}) =>
+  ({ getAccount: async () => account, ...extra });
+
+describe('resolveMemberStatus（IO 唯一入口）', () => {
+  it('匿名短路不触 provider（ctx 无 integrations 仍返回 unauthenticated，未走 fail-soft）', async () => {
+    await expect(resolveMemberStatus(reqCtx('anonymous'), fakeCtx())).resolves.toEqual({
+      outcome: 'unauthenticated',
+    });
+  });
+
+  it('reqCtx 缺席 → unavailable + warn（管路故障不冒充身份语义）', async () => {
+    const warn = vi.fn();
+    await expect(resolveMemberStatus(undefined, fakeCtx(undefined, { warn }))).resolves.toEqual({
+      outcome: 'unavailable',
+    });
+    expect(warn).toHaveBeenCalledTimes(1);
+  });
+
+  it('integrations 缺失 → unavailable + warn 留痕（不伪装状态）', async () => {
+    const warn = vi.fn();
+    await expect(resolveMemberStatus(reqCtx(), fakeCtx(undefined, { warn }))).resolves.toEqual({
+      outcome: 'unavailable',
+    });
+    expect(warn).toHaveBeenCalledTimes(1);
+  });
+
+  it('resolveService 抛错 → unavailable + warn', async () => {
+    const warn = vi.fn();
+    const ctx = fakeCtx(
+      { resolveService: async () => { throw new Error('registry down'); } },
+      { warn },
+    );
+    await expect(resolveMemberStatus(reqCtx(), ctx)).resolves.toEqual({ outcome: 'unavailable' });
+    expect(warn).toHaveBeenCalledTimes(1);
+  });
+
+  it('getAccount 抛错 → unavailable + warn', async () => {
+    const warn = vi.fn();
+    const ctx = fakeCtx(
+      { resolveService: async () => ({ getAccount: async () => { throw new Error('provider timeout'); } }) },
+      { warn },
+    );
+    await expect(resolveMemberStatus(reqCtx(), ctx)).resolves.toEqual({ outcome: 'unavailable' });
+    expect(warn).toHaveBeenCalledTimes(1);
+  });
+
+  it('active → outcome/account/深链三元齐备（017 N1 双槽：service 字段退役，enrollment 槽独立取深链）', async () => {
+    const service = stubService({
+      authState: 'authenticated',
+      state: 'active',
+      memberRef: 'member:C-1001',
+      primaryMallCardNo: 'C-1001',
+      observedAt: '2026-08-30T00:00:00.000Z',
+    });
+    const ctx = fakeCtx({ resolveService: async () => service });
+    const status = await resolveMemberStatus(reqCtx(), ctx);
+    expect(status.outcome).toBe('active');
+    expect(status.account).toMatchObject({ state: 'active', primaryMallCardNo: 'C-1001' });
+    // 深链透传缺省（stub 无 enrollUrl/loginUrl 字段 → 不注入）
+    expect(status.enrollUrl).toBeUndefined();
+    expect(status.loginUrl).toBeUndefined();
+  });
+
+  it('active → 已配置深链透传 enrollUrl/loginUrl（跨模块门禁卡片数据源）', async () => {
+    const service = stubService({ authState: 'authenticated', state: 'active', observedAt: '2026-08-30T00:00:00.000Z' });
+    service.enrollUrl = 'alipays://enroll-demo';
+    service.loginUrl = 'alipays://login-demo';
+    const ctx = fakeCtx({ resolveService: async () => service });
+    const status = await resolveMemberStatus(reqCtx(), ctx);
+    expect(status.enrollUrl).toBe('alipays://enroll-demo');
+    expect(status.loginUrl).toBe('alipays://login-demo');
+  });
+
+  it('N1 双槽：enrollment 槽解析失败不拖累身份判定（active 保持 + warn 留痕 + 无深链）', async () => {
+    const warn = vi.fn();
+    const ctx = fakeCtx(
+      {
+        resolveService: async (input: { service: string }) => {
+          if (input.service === 'member.enrollment') throw new Error('enrollment slot down');
+          return stubService({ authState: 'authenticated', state: 'active', observedAt: '2026-08-30T00:00:00.000Z' });
+        },
+      },
+      { warn },
+    );
+    const status = await resolveMemberStatus(reqCtx(), ctx);
+    expect(status.outcome).toBe('active');
+    expect(status.enrollUrl).toBeUndefined();
+    expect(warn).toHaveBeenCalledTimes(1);
+  });
+
+  it('凭证轴未认证 → unauthenticated（tokenless 合法登录形态）', async () => {
+    const ctx = fakeCtx({
+      resolveService: async () => stubService({ authState: 'unauthenticated', state: 'unknown', observedAt: '2026-08-30T00:00:00.000Z' }),
+    });
+    await expect(resolveMemberStatus(reqCtx(), ctx)).resolves.toMatchObject({ outcome: 'unauthenticated' });
+  });
+});
+
+describe('MEMBER_QUERY_NOTICES（直聊面穷尽表）', () => {
+  it('键集 = 非 active 全量（扩值缺键由编译器拦截）', () => {
+    expect(Object.keys(MEMBER_QUERY_NOTICES).sort()).toEqual([
+      'closed',
+      'not_enrolled',
+      'unauthenticated',
+      'unavailable',
+      'unknown',
+    ]);
+  });
+});

package/tests/view.test.ts

@@ -0,0 +1,33 @@
+/**
+ * member 展示纯函数单测（0.4.0 D6：node 环境）。
+ */
+import { describe, expect, it } from 'vitest';
+import { enrollmentStateText, enrollmentTone, formatMemberDate, memberStateText, pointAmountClass } from '../src/client/cards/view';
+
+describe('pointAmountClass 双色', () => {
+  it('负支出红 / 正收入绿', () => {
+    expect(pointAmountClass('-120')).toBe('member-pu__amount--spend');
+    expect(pointAmountClass('+50')).toBe('member-pu__amount--income');
+  });
+});
+
+describe('会员资料格式化', () => {
+  it('日期格式稳定且关闭态不误报未入会', () => {
+    expect(formatMemberDate('2026-08-19T10:30:00+08:00')).toBe('2026.08.19');
+    expect(formatMemberDate('待确认')).toBe('待确认');
+    expect(memberStateText('closed')).toBe('已注销');
+    expect(memberStateText('unknown', 'authenticated')).toBe('状态待确认');
+    expect(memberStateText('unknown', 'unauthenticated')).toBe('未登录');
+  });
+});
+
+describe('enrollment 状态', () => {
+  it('四态文案 + tone', () => {
+    expect(enrollmentStateText('active')).toBe('入会成功');
+    expect(enrollmentStateText('pending_confirmation')).toBe('厂商确认中');
+    expect(enrollmentStateText('confirmation_timeout')).toBe('确认超时');
+    expect(enrollmentTone('active')).toBe('success');
+    expect(enrollmentTone('pending_confirmation')).toBe('warning');
+    expect(enrollmentTone('failed')).toBe('neutral');
+  });
+});

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-F6FHBH3N.js

@@ -1,160 +0,0 @@
-// src/server/service.ts
-var InMemoryMemberService = class {
-  balances = /* @__PURE__ */ new Map();
-  levels = /* @__PURE__ */ new Map();
-  idempotentKeys = /* @__PURE__ */ new Set();
-  audit = [];
-  constructor(initial = {}) {
-    for (const [userId, balance] of Object.entries(initial)) {
-      this.balances.set(userId, balance);
-    }
-  }
-  async queryPoints(userId) {
-    return {
-      userId,
-      balance: this.balances.get(userId) ?? 0,
-      level: this.levelOf(userId)
-    };
-  }
-  async queryDiscount(userId) {
-    const level = this.levelOf(userId);
-    const map = {
-      silver: { level: "silver", discount: 0.95 },
-      gold: { level: "gold", discount: 0.9 },
-      platinum: { level: "platinum", discount: 0.85 }
-    };
-    return map[level];
-  }
-  async deductPoints(userId, amount, idempotencyKey) {
-    if (this.idempotentKeys.has(idempotencyKey)) return true;
-    const current = this.balances.get(userId) ?? 0;
-    if (amount <= 0 || current < amount) return false;
-    this.balances.set(userId, current - amount);
-    this.idempotentKeys.add(idempotencyKey);
-    this.audit.push({ action: "deduct", userId, amount, key: idempotencyKey });
-    this.maybeUpgrade(userId);
-    return true;
-  }
-  async refundPoints(userId, amount, idempotencyKey) {
-    if (this.idempotentKeys.has(`refund:${idempotencyKey}`)) return true;
-    const current = this.balances.get(userId) ?? 0;
-    this.balances.set(userId, current + amount);
-    this.idempotentKeys.add(`refund:${idempotencyKey}`);
-    this.audit.push({ action: "refund", userId, amount, key: idempotencyKey });
-    return true;
-  }
-  async awardPoints(userId, amount) {
-    const current = this.balances.get(userId) ?? 0;
-    this.balances.set(userId, current + amount);
-    this.audit.push({ action: "award", userId, amount });
-    this.maybeUpgrade(userId);
-    return true;
-  }
-  levelOf(userId) {
-    const cached = this.levels.get(userId);
-    if (cached) return cached;
-    const balance = this.balances.get(userId) ?? 0;
-    if (balance >= 1e3) return "platinum";
-    if (balance >= 300) return "gold";
-    return "silver";
-  }
-  maybeUpgrade(userId) {
-    const newLevel = this.levelOf(userId);
-    const prev = this.levels.get(userId);
-    this.levels.set(userId, newLevel);
-    if (prev && prev !== newLevel) {
-      this.levelChangeListeners.forEach((fn) => fn({ userId, newLevel }));
-    }
-  }
-  levelChangeListeners = /* @__PURE__ */ new Set();
-  onLevelChange(fn) {
-    this.levelChangeListeners.add(fn);
-  }
-};
-
-// src/server/cards/points/meta.ts
-import { z } from "zod";
-var dataSchema = z.object({
-  userId: z.string(),
-  balance: z.number(),
-  level: z.enum(["silver", "gold", "platinum"])
-});
-var meta = {
-  cardType: "points",
-  dataSchema,
-  allowedTools: ["queryPoints"],
-  displayName: "\u4F1A\u5458\u79EF\u5206\u5361",
-  description: "\u5C55\u793A\u4F1A\u5458\u5F53\u524D\u79EF\u5206\u4F59\u989D\u4E0E\u7B49\u7EA7",
-  sampleData: { userId: "u_1001", balance: 860, level: "gold" },
-  schemaVersion: 1
-};
-var meta_default = meta;
-
-// src/server/tool.ts
-import { createTool } from "@tbox.cn/app-sdk/server";
-import { z as z2 } from "zod";
-function createQueryPointsTool(getMember) {
-  return createTool({
-    id: "queryPoints",
-    description: "\u67E5\u8BE2\u4F1A\u5458\u5F53\u524D\u79EF\u5206\u4F59\u989D\u4E0E\u7B49\u7EA7",
-    inputSchema: z2.object({
-      userId: z2.string().describe("\u4F1A\u5458 userId")
-    }),
-    outputSchema: z2.object({
-      userId: z2.string(),
-      balance: z2.number(),
-      level: z2.enum(["silver", "gold", "platinum"])
-    }),
-    execute: async ({ userId }) => {
-      const member2 = getMember();
-      if (!member2) return { userId, balance: 0, level: "silver" };
-      return member2.queryPoints(userId);
-    }
-  });
-}
-
-// src/server/handler.ts
-function createMemberHandler(ctx) {
-  return {
-    id: "member",
-    handle: async (_action, payload) => {
-      const member2 = ctx.resolveService("member");
-      if (!member2) return { cards: [], text: "\u4F1A\u5458\u670D\u52A1\u4E0D\u53EF\u7528" };
-      const { userId } = payload ?? {};
-      if (!userId) return { cards: [], text: "\u7F3A\u5C11 userId" };
-      const points = await member2.queryPoints(userId);
-      return {
-        cards: [{ cardType: "points", data: points }],
-        text: `\u5F53\u524D\u79EF\u5206 ${points.balance}\uFF0C\u7B49\u7EA7 ${points.level}`
-      };
-    }
-  };
-}
-
-// src/server/index.ts
-var member = new InMemoryMemberService({ u_1001: 860, u_1002: 120 });
-var cards = {
-  points: meta_default
-};
-var serverModule = {
-  cards,
-  register(ctx) {
-    ctx.services.register("member", member);
-    ctx.tools.register(createQueryPointsTool(() => ctx.resolveService("member")));
-    ctx.cards.registerMap(cards);
-    ctx.handlers.register(createMemberHandler(ctx));
-    const mallBus = ctx.bus;
-    mallBus.subscribe("parking.coupon.used", async ({ userId, amount }) => {
-      await member.awardPoints(userId, Math.floor(amount / 10));
-    });
-    member.onLevelChange(({ userId, newLevel }) => {
-      void mallBus.publish("member.level.changed", { userId, newLevel });
-    });
-  }
-};
-
-export {
-  InMemoryMemberService,
-  meta_default,
-  serverModule
-};

package/dist/chunk-OXXT6F5B.js

@@ -1,33 +0,0 @@
-// src/client/cards/points/index.tsx
-import { jsx, jsxs } from "react/jsx-runtime";
-function PointsCard({ data }) {
-  const levelLabel = {
-    silver: "\u94F6\u5361",
-    gold: "\u91D1\u5361",
-    platinum: "\u94C2\u91D1\u5361"
-  };
-  return /* @__PURE__ */ jsxs("div", { className: "mall-card mall-card--points", children: [
-    /* @__PURE__ */ jsx("div", { className: "mall-card__title", children: "\u4F1A\u5458\u79EF\u5206" }),
-    /* @__PURE__ */ jsx("div", { className: "mall-card__balance", children: data.balance }),
-    /* @__PURE__ */ jsxs("div", { className: "mall-card__meta", children: [
-      levelLabel[data.level],
-      " \xB7 \u7528\u6237 ",
-      data.userId
-    ] })
-  ] });
-}
-
-// src/client/index.ts
-var cards = {
-  points: PointsCard
-};
-var clientModule = {
-  cards,
-  register(ctx) {
-    ctx.cards.registerMap(cards);
-  }
-};
-
-export {
-  clientModule
-};

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

@@ -1,19 +0,0 @@
-import type { PointsCardData } from '../../../server/cards/points/meta';
-
-/** 会员积分卡组件 */
-export function PointsCard({ data }: { data: PointsCardData; cardId: string; isHistory: boolean }) {
-  const levelLabel: Record<PointsCardData['level'], string> = {
-    silver: '银卡',
-    gold: '金卡',
-    platinum: '铂金卡',
-  };
-  return (
-    <div className="mall-card mall-card--points">
-      <div className="mall-card__title">会员积分</div>
-      <div className="mall-card__balance">{data.balance}</div>
-      <div className="mall-card__meta">
-        {levelLabel[data.level]} · 用户 {data.userId}
-      </div>
-    </div>
-  );
-}

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

@@ -1,22 +0,0 @@
-import { z } from 'zod';
-import type { CardMeta } from '@tbox.cn/app-contracts';
-
-export const dataSchema = z.object({
-  userId: z.string(),
-  balance: z.number(),
-  level: z.enum(['silver', 'gold', 'platinum']),
-});
-
-export type PointsCardData = z.infer<typeof dataSchema>;
-
-const meta: CardMeta<typeof dataSchema> = {
-  cardType: 'points',
-  dataSchema,
-  allowedTools: ['queryPoints'],
-  displayName: '会员积分卡',
-  description: '展示会员当前积分余额与等级',
-  sampleData: { userId: 'u_1001', balance: 860, level: 'gold' },
-  schemaVersion: 1,
-};
-
-export default meta;

package/tbox.component.json

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