@tbox.cn/app-provider-mock 0.2.0 → 0.3.0

package/dist/server/index.js

@@ -1,10 +1,29 @@
 // src/server/index.ts
 import { readLoginMallId } from "@tbox.cn/app-contracts-mall";
 
+// src/server/config.ts
+function resolveConfig(raw, defaults, intKeys = []) {
+  const src = raw && typeof raw === "object" ? raw : {};
+  const out = {};
+  for (const [key, fallback] of Object.entries(defaults)) {
+    const value = src[key];
+    const ok = typeof value === typeof fallback && (typeof value !== "number" || Number.isFinite(value) && (!intKeys.includes(key) || Number.isInteger(value))) && (typeof value !== "string" || value !== "");
+    out[key] = ok ? value : fallback;
+  }
+  return out;
+}
+
 // src/server/member.ts
-var DEMO_USAGE = [
-  { usageRecordRef: "demo:usage:1", title: "\u5F00\u5361\u793C", amount: "+300", usedAt: (/* @__PURE__ */ new Date()).toISOString(), description: "mock \u6F14\u793A\u6D41\u6C34" }
-];
+var MEMBER_CFG_DEFAULTS = {
+  memberName: "\u793A\u4F8B\u4F1A\u5458",
+  cardName: "\u793A\u4F8B\u4F1A\u5458\u5361",
+  levelName: "",
+  // '' 哨兵 = 不展示等级区（MemberCardSnapshot.levelName 可选位）
+  initialPoints: 300,
+  enrollUrl: "alipays://platformapi/startapp?appId=demo&page=v/index/index",
+  loginUrl: "alipays://platformapi/startapp?appId=demo&page=v/login/index"
+};
+var MEMBER_CFG_INT_KEYS = ["initialPoints"];
 var mockMemberState = {
   enrolled: /* @__PURE__ */ new Set(),
   balances: /* @__PURE__ */ new Map(),
@@ -15,7 +34,6 @@ var MOCK_SHELL_USER_ID = "demo-user";
 function enrollMockMember(userId) {
   mockMemberState.enrolled.add(userId);
   mockMemberState.loggedOut.delete(userId);
-  if (!mockMemberState.balances.has(userId)) mockMemberState.balances.set(userId, 300);
 }
 function isMockMemberEnrolled(userId) {
   return mockMemberState.enrolled.has(userId);
@@ -40,11 +58,21 @@ var MockMemberServiceImpl = class {
    * 透传素材，mock 出厂面恒配 demo 值）。demo 值厂商中立（appId=demo），点击在壳内
    * navigateTo 失败即无害降级。
    */
-  enrollUrl = "alipays://platformapi/startapp?appId=demo&page=v/index/index";
+  enrollUrl;
   /** 登录页深链（同上，可选透传素材；供未登录引导卡跳转）。 */
-  loginUrl = "alipays://platformapi/startapp?appId=demo&page=v/login/index";
+  loginUrl;
+  /** 配置快照（fail-soft，构造期一次解析；键集 ≡ MEMBER_CFG_DEFAULTS） */
+  cfg;
+  /** 积分流水（金额随 initialPoints 派生——与余额同源） */
+  usage;
   /** 默认访客（无种子）：demo-user 初始 not_enrolled，经入会闭环翻为 active */
-  constructor(initial = {}) {
+  constructor(initial = {}, config = {}) {
+    this.cfg = resolveConfig(config, MEMBER_CFG_DEFAULTS, MEMBER_CFG_INT_KEYS);
+    this.enrollUrl = this.cfg.enrollUrl;
+    this.loginUrl = this.cfg.loginUrl;
+    this.usage = [
+      { usageRecordRef: "demo:usage:1", title: "\u5F00\u5361\u793C", amount: `+${String(this.cfg.initialPoints)}`, usedAt: (/* @__PURE__ */ new Date()).toISOString(), description: "mock \u6F14\u793A\u6D41\u6C34" }
+    ];
     for (const [userId, balance] of Object.entries(initial)) {
       mockMemberState.enrolled.add(userId);
       mockMemberState.balances.set(userId, balance);
@@ -60,44 +88,51 @@ var MockMemberServiceImpl = class {
     };
   }
   async getProfile(_userId) {
-    return { labels: [{ labelRef: "demo:label:1", name: "\u793A\u4F8B\u4F1A\u5458" }], observedAt: (/* @__PURE__ */ new Date()).toISOString() };
+    return { labels: [{ labelRef: "demo:label:1", name: this.cfg.memberName }], observedAt: (/* @__PURE__ */ new Date()).toISOString() };
   }
   async getCard(userId) {
     if (!isMockMemberActive(userId)) return null;
     return {
       cardRef: `demo:card:${userId}`,
-      cardDisplay: "\u793A\u4F8B\u4F1A\u5458\u5361",
+      cardDisplay: this.cfg.cardName,
       status: "active",
+      ...this.cfg.levelName !== "" ? { levelName: this.cfg.levelName } : {},
       observedAt: (/* @__PURE__ */ new Date()).toISOString()
     };
   }
   async queryPoints(userId) {
-    return { userId, balance: mockMemberState.balances.get(userId) ?? 0, membershipLabel: "\u793A\u4F8B\u4F1A\u5458\u5361" };
+    return { userId, balance: this.currentBalanceOf(userId), membershipLabel: this.cfg.cardName };
   }
-  async getBenefits(_userId) {
-    return { availablePoints: 300, levelName: "\u793A\u4F8B\u7B49\u7EA7", observedAt: (/* @__PURE__ */ new Date()).toISOString() };
+  async getBenefits(userId) {
+    return { availablePoints: this.currentBalanceOf(userId), levelName: "\u793A\u4F8B\u7B49\u7EA7", observedAt: (/* @__PURE__ */ new Date()).toISOString() };
   }
   async listPointUsage(_userId, page, pageSize) {
     const start = (page - 1) * pageSize;
-    return { items: DEMO_USAGE.slice(start, start + pageSize), total: DEMO_USAGE.length };
+    return { items: this.usage.slice(start, start + pageSize), total: this.usage.length };
   }
   async queryDiscount() {
     return { level: "silver", discount: 0.95 };
   }
   async deductPoints(userId, amount, _key) {
-    const balance = mockMemberState.balances.get(userId) ?? 0;
+    const balance = this.currentBalanceOf(userId);
     if (balance < amount) return false;
     mockMemberState.balances.set(userId, balance - amount);
     return true;
   }
   async refundPoints(userId, amount, _key) {
-    mockMemberState.balances.set(userId, (mockMemberState.balances.get(userId) ?? 0) + amount);
+    mockMemberState.balances.set(userId, this.currentBalanceOf(userId) + amount);
     return true;
   }
   async awardPoints(userId, amount) {
-    mockMemberState.balances.set(userId, (mockMemberState.balances.get(userId) ?? 0) + amount);
+    mockMemberState.balances.set(userId, this.currentBalanceOf(userId) + amount);
     return true;
   }
+  /** 余额单源：显式增减覆盖值 ??（已入会 ? 配置初值 : 0）——入会不写种子（惰性读） */
+  currentBalanceOf(userId) {
+    const override = mockMemberState.balances.get(userId);
+    if (override !== void 0) return override;
+    return isMockMemberEnrolled(userId) ? this.cfg.initialPoints : 0;
+  }
   async enroll(input) {
     enrollMockMember(input.userId);
     return { status: "active", memberRef: `demo:member:${input.userId}` };
@@ -121,46 +156,76 @@ var MockMemberServiceImpl = class {
 
 // src/server/parking.ts
 var now = () => (/* @__PURE__ */ new Date()).toISOString();
-var DEMO_BENEFITS = [
-  { benefitRef: "demo:benefit:member-discount", title: "\u4F1A\u5458 95 \u6298", description: "mock \u6F14\u793A\u6743\u76CA", kind: "discount", autoSelected: true, estimatedDiscountCents: 75 },
-  { benefitRef: "demo:benefit:points-offset", title: "\u79EF\u5206\u62B5 5 \u5143", description: "mock \u6F14\u793A\u6743\u76CA", kind: "points", autoSelected: false, estimatedDiscountCents: 500, requiredPoints: 500, previewPayableCents: 1e3 }
-];
-function demoQuote(q, plateNo) {
-  return {
-    quoteRef: `demo:quote:${plateNo}`,
-    plateNo,
-    mallId: q.scope.mallId ?? "demo",
-    entryAt: now(),
-    feeItems: [{ name: "\u505C\u8F66\u8D39\uFF083 \u5C0F\u65F6\uFF09", amountCents: 1500 }],
-    totalCents: 1500,
-    discountCents: 0,
-    payableCents: 1500,
-    appliedBenefits: [],
-    revision: 1,
-    paymentState: "UNPAID"
-  };
-}
+var PARKING_CFG_DEFAULTS = {
+  parkName: "\u793A\u4F8B\u505C\u8F66\u573A",
+  feeName: "\u505C\u8F66\u8D39\uFF083 \u5C0F\u65F6\uFF09",
+  feeCents: 1500,
+  remainingSpaces: 128,
+  firstHourRate: "\u514D\u8D39",
+  memberBenefitEnabled: true,
+  memberBenefitDiscountCents: 75,
+  pointsBenefitEnabled: true,
+  invoiceEnabled: true,
+  vehicleFloor: "B1",
+  vehicleZone: "A \u533A",
+  vehicleSpaceNo: "A-128"
+};
+var PARKING_CFG_INT_KEYS = ["feeCents", "remainingSpaces", "memberBenefitDiscountCents"];
 var MockParkingServiceImpl = class {
   vehicles = /* @__PURE__ */ new Map();
-  records = [
-    {
-      recordRef: "demo:record:1",
-      plateNo: "demo-plate",
-      amountCents: 1500,
-      paidAt: now(),
-      status: "PAID",
-      parkName: "\u793A\u4F8B\u505C\u8F66\u573A",
-      orderCompleted: true
-    }
-  ];
-  constructor(mallId = "mall-demo") {
+  records;
+  /** 配置快照（fail-soft，构造期一次解析；键集 ≡ PARKING_CFG_DEFAULTS） */
+  cfg;
+  constructor(mallId = "mall-demo", config = {}) {
     this.mallId = mallId;
     void this.mallId;
+    this.cfg = resolveConfig(config, PARKING_CFG_DEFAULTS, PARKING_CFG_INT_KEYS);
+    this.records = [
+      {
+        recordRef: "demo:record:1",
+        plateNo: "demo-plate",
+        amountCents: this.cfg.feeCents,
+        paidAt: now(),
+        status: "PAID",
+        parkName: this.cfg.parkName,
+        orderCompleted: true
+      }
+    ];
   }
   mallId;
+  /**
+   * kind 必须下发：客户端按它分流（discount = 自动生效、不进勾选区；points = 积分入口），
+   * 服务端 projectPaymentOptions 也只认 kind==='points'。缺省时整套分流静默失效——
+   * 等级权益会退化成一个可勾选项，积分入口则从不出现。
+   */
+  benefits() {
+    const benefits = [];
+    if (this.cfg.memberBenefitEnabled) {
+      benefits.push({ benefitRef: "demo:benefit:member-discount", title: "\u4F1A\u5458 95 \u6298", description: "mock \u6F14\u793A\u6743\u76CA", kind: "discount", autoSelected: true, estimatedDiscountCents: this.cfg.memberBenefitDiscountCents });
+    }
+    if (this.cfg.pointsBenefitEnabled) {
+      benefits.push({ benefitRef: "demo:benefit:points-offset", title: "\u79EF\u5206\u62B5 5 \u5143", description: "mock \u6F14\u793A\u6743\u76CA", kind: "points", autoSelected: false, estimatedDiscountCents: 500, requiredPoints: 500, previewPayableCents: 1e3 });
+    }
+    return benefits;
+  }
+  quote(q, plateNo) {
+    return {
+      quoteRef: `demo:quote:${plateNo}`,
+      plateNo,
+      mallId: q.scope.mallId ?? "demo",
+      entryAt: now(),
+      feeItems: [{ name: this.cfg.feeName, amountCents: this.cfg.feeCents }],
+      totalCents: this.cfg.feeCents,
+      discountCents: 0,
+      payableCents: this.cfg.feeCents,
+      appliedBenefits: [],
+      revision: 1,
+      paymentState: "UNPAID"
+    };
+  }
   async queryFee(q, input) {
     const plateNo = input.plateNo ?? (input.vehicleRef ? this.vehicles.get(input.vehicleRef)?.plateNo : void 0) ?? "demo-plate";
-    const quote = demoQuote(q, plateNo);
+    const quote = this.quote(q, plateNo);
     return quote ? [quote] : [];
   }
   async listVehicles() {
@@ -178,7 +243,7 @@ var MockParkingServiceImpl = class {
     return record;
   }
   async getInvoiceSettings() {
-    return { parkingInvoiceEnabled: true };
+    return { parkingInvoiceEnabled: this.cfg.invoiceEnabled };
   }
   async listInvoiceableOrders(_q, page, pageSize) {
     const all = this.records.filter((r) => r.orderCompleted === true);
@@ -188,26 +253,26 @@ var MockParkingServiceImpl = class {
   async queryParkingInfo(_q, kind) {
     return {
       kind,
-      title: "\u793A\u4F8B\u505C\u8F66\u573A",
+      title: this.cfg.parkName,
       entries: [
-        { label: "\u5269\u4F59\u8F66\u4F4D", value: "128" },
-        { label: "\u9996\u5C0F\u65F6\u8D39\u7387", value: "\u514D\u8D39" },
-        { label: "\u4F1A\u5458\u6743\u76CA", value: "\u4F1A\u5458 95 \u6298" }
+        { label: "\u5269\u4F59\u8F66\u4F4D", value: String(this.cfg.remainingSpaces) },
+        { label: "\u9996\u5C0F\u65F6\u8D39\u7387", value: this.cfg.firstHourRate },
+        { label: "\u4F1A\u5458\u6743\u76CA", value: this.cfg.memberBenefitEnabled ? "\u4F1A\u5458 95 \u6298" : "\u2014" }
       ]
     };
   }
   async queryApplicableBenefits(_q, _plateNo) {
-    return DEMO_BENEFITS;
+    return this.benefits();
   }
   async locateVehicle(_q, _plateNo) {
-    return { floorName: "B1", zoneName: "A \u533A", spaceNo: "A-128", walkingRoute: "\u7535\u68AF\u5DE6\u8F6C 50 \u7C73" };
+    return { floorName: this.cfg.vehicleFloor, zoneName: this.cfg.vehicleZone, spaceNo: this.cfg.vehicleSpaceNo, walkingRoute: "\u7535\u68AF\u5DE6\u8F6C 50 \u7C73" };
   }
   // ===== 支付三步链（mock：reconcile 恒 PAID 收口） =====
   async createOrder(_q, quoteRef) {
     return { payOrderId: `demo:pay:${quoteRef}`, paymentRef: `demo:payment:${quoteRef}` };
   }
   async getOrderInfo(_q, _paymentRef) {
-    return { orderInfo: "demo-order-info", channel: "50", payableFeeCents: 1500 };
+    return { orderInfo: "demo-order-info", channel: "50", payableFeeCents: this.cfg.feeCents };
   }
   async getPaymentSign(_q, _paymentRef) {
     return { orderInfo: "demo-order-info" };
@@ -218,8 +283,8 @@ var MockParkingServiceImpl = class {
     return "PAID";
   }
   async reprice(q, quoteRef, benefitRefs) {
-    const base = demoQuote(q, "demo-plate");
-    const discount = DEMO_BENEFITS.filter((b) => benefitRefs.includes(b.benefitRef)).reduce((sum, b) => sum + (b.estimatedDiscountCents ?? 0), 0);
+    const base = this.quote(q, "demo-plate");
+    const discount = this.benefits().filter((b) => benefitRefs.includes(b.benefitRef)).reduce((sum, b) => sum + (b.estimatedDiscountCents ?? 0), 0);
     return {
       ...base,
       quoteRef: `${quoteRef}#r${Date.now()}`,
@@ -251,79 +316,97 @@ var MockParkingServiceImpl = class {
 // src/server/promotion.ts
 var now2 = () => (/* @__PURE__ */ new Date()).toISOString();
 var inDays = (d) => new Date(Date.now() + d * 864e5).toISOString();
-var DEMO_OFFERS = [
-  {
-    offerRef: "demo:coupon:1001",
-    offerType: "COUPON",
-    title: "\u6EE1 100 \u51CF 20 \u5143\u5238",
-    subtitle: "\u5168\u573A\u901A\u7528\uFF08mock \u6F14\u793A\uFF09",
-    tags: ["\u901A\u7528"],
-    validity: { start: now2(), end: inDays(30) },
-    facets: [{ kind: "COUPON", discountType: "AMOUNT", value: 2e3, thresholdCents: 1e4 }],
-    availability: { status: "AVAILABLE", reasonCodes: [], evaluatedAt: now2(), authoritative: false },
-    participation: { mode: "CLAIM_THEN_PURCHASE", steps: [{ title: "\u9886\u53D6", description: "\u70B9\u51FB\u9886\u53D6\u540E\u81EA\u52A8\u5B58\u5165\u5361\u5305" }] }
-  },
-  {
-    offerRef: "demo:groupon:2001",
-    offerType: "GROUPON",
-    title: "\u9910\u996E\u53CC\u4EBA\u5957\u9910 5 \u6298",
-    subtitle: "mock \u6F14\u793A\u56E2\u8D2D",
-    tags: ["\u9910\u996E"],
-    validity: { start: now2(), end: inDays(15) },
-    facets: [{ kind: "GROUPON", requiredParticipants: 2 }],
-    availability: { status: "AVAILABLE", reasonCodes: [], evaluatedAt: now2(), authoritative: false },
-    participation: { mode: "CLAIM_THEN_PURCHASE", steps: [{ title: "\u8D2D\u4E70", description: "\u6309\u56E2\u8D2D\u4EF7\u4E0B\u5355" }] }
-  }
-];
-var DEMO_ENTITLEMENTS = [
-  {
-    entitlementRef: "demo:entitlement:1",
-    offerRef: "demo:coupon:1001",
-    title: "\u6EE1 100 \u51CF 20 \u5143\u5238",
-    entitlementType: "COUPON",
-    status: "EFFECTIVE",
-    codeMasked: "DEMO-****-1001"
-  }
-];
-var DEMO_ACTIVITIES = [
-  {
-    activityRef: "demo:activity:3001",
-    title: "\u793A\u4F8B\u5546\u573A\u5468\u5E74\u5E86",
-    subtitle: "mock \u6F14\u793A\u6D3B\u52A8",
-    registrationRequired: false,
-    offerRefs: ["demo:coupon:1001"]
-  }
-];
+var PROMOTION_CFG_DEFAULTS = {
+  couponTitle: "\u6EE1 100 \u51CF 20 \u5143\u5238",
+  couponValueCents: 2e3,
+  couponThresholdCents: 1e4,
+  couponValidityDays: 30,
+  grouponEnabled: true,
+  activityTitle: "\u793A\u4F8B\u5546\u573A\u5468\u5E74\u5E86"
+};
+var PROMOTION_CFG_INT_KEYS = ["couponValueCents", "couponThresholdCents", "couponValidityDays"];
 var MockPromotionServiceImpl = class {
+  /** 配置快照（fail-soft，构造期一次解析；键集 ≡ PROMOTION_CFG_DEFAULTS） */
+  cfg;
+  /** 供/资产/活动三表（构造期按 cfg 构建——请求级实例，成本可忽略） */
+  offers;
+  entitlements;
+  activities;
+  constructor(config = {}) {
+    this.cfg = resolveConfig(config, PROMOTION_CFG_DEFAULTS, PROMOTION_CFG_INT_KEYS);
+    const ts = now2();
+    const couponOffer = {
+      offerRef: "demo:coupon:1001",
+      offerType: "COUPON",
+      title: this.cfg.couponTitle,
+      subtitle: "\u5168\u573A\u901A\u7528\uFF08mock \u6F14\u793A\uFF09",
+      tags: ["\u901A\u7528"],
+      validity: { start: ts, end: inDays(this.cfg.couponValidityDays) },
+      facets: [{ kind: "COUPON", discountType: "AMOUNT", value: this.cfg.couponValueCents, thresholdCents: this.cfg.couponThresholdCents }],
+      availability: { status: "AVAILABLE", reasonCodes: [], evaluatedAt: ts, authoritative: false },
+      participation: { mode: "CLAIM_THEN_PURCHASE", steps: [{ title: "\u9886\u53D6", description: "\u70B9\u51FB\u9886\u53D6\u540E\u81EA\u52A8\u5B58\u5165\u5361\u5305" }] }
+    };
+    const grouponOffer = {
+      offerRef: "demo:groupon:2001",
+      offerType: "GROUPON",
+      title: "\u9910\u996E\u53CC\u4EBA\u5957\u9910 5 \u6298",
+      subtitle: "mock \u6F14\u793A\u56E2\u8D2D",
+      tags: ["\u9910\u996E"],
+      validity: { start: ts, end: inDays(15) },
+      facets: [{ kind: "GROUPON", requiredParticipants: 2 }],
+      availability: { status: "AVAILABLE", reasonCodes: [], evaluatedAt: ts, authoritative: false },
+      participation: { mode: "CLAIM_THEN_PURCHASE", steps: [{ title: "\u8D2D\u4E70", description: "\u6309\u56E2\u8D2D\u4EF7\u4E0B\u5355" }] }
+    };
+    this.offers = this.cfg.grouponEnabled ? [couponOffer, grouponOffer] : [couponOffer];
+    this.entitlements = [
+      {
+        entitlementRef: "demo:entitlement:1",
+        offerRef: "demo:coupon:1001",
+        title: this.cfg.couponTitle,
+        entitlementType: "COUPON",
+        status: "EFFECTIVE",
+        codeMasked: "DEMO-****-1001"
+      }
+    ];
+    this.activities = [
+      {
+        activityRef: "demo:activity:3001",
+        title: this.cfg.activityTitle,
+        subtitle: "mock \u6F14\u793A\u6D3B\u52A8",
+        registrationRequired: false,
+        offerRefs: ["demo:coupon:1001"]
+      }
+    ];
+  }
   async searchOffers(_q, input) {
     const keyword = input.keyword?.trim();
-    const items = keyword ? DEMO_OFFERS.filter((o) => o.title.includes(keyword) || o.tags.some((t) => t.includes(keyword))) : DEMO_OFFERS;
+    const items = keyword ? this.offers.filter((o) => o.title.includes(keyword) || o.tags.some((t) => t.includes(keyword))) : this.offers;
     return { items, hasMore: false };
   }
   async getOfferDetail(_q, input) {
-    if (input.offerRef) return DEMO_OFFERS.find((o) => o.offerRef === input.offerRef) ?? null;
+    if (input.offerRef) return this.offers.find((o) => o.offerRef === input.offerRef) ?? null;
     if (input.entitlementRef) {
-      const ent = DEMO_ENTITLEMENTS.find((e) => e.entitlementRef === input.entitlementRef);
-      if (ent?.offerRef) return DEMO_OFFERS.find((o) => o.offerRef === ent.offerRef) ?? null;
+      const ent = this.entitlements.find((e) => e.entitlementRef === input.entitlementRef);
+      if (ent?.offerRef) return this.offers.find((o) => o.offerRef === ent.offerRef) ?? null;
       return null;
     }
-    if (input.keyword) return DEMO_OFFERS.find((o) => o.title.includes(input.keyword)) ?? null;
+    if (input.keyword) return this.offers.find((o) => o.title.includes(input.keyword)) ?? null;
     return null;
   }
   async recommendOffers() {
-    return DEMO_OFFERS;
+    return this.offers;
   }
   async listEntitlements(_q, _input) {
-    return { items: DEMO_ENTITLEMENTS, hasMore: false };
+    return { items: this.entitlements, hasMore: false };
   }
   async getEntitlementDetail(_q, entitlementRef) {
-    return DEMO_ENTITLEMENTS.find((e) => e.entitlementRef === entitlementRef) ?? null;
+    return this.entitlements.find((e) => e.entitlementRef === entitlementRef) ?? null;
   }
   async listActivities() {
-    return { items: DEMO_ACTIVITIES, hasMore: false };
+    return { items: this.activities, hasMore: false };
   }
   async getActivityDetail(_q, activityRef) {
-    const activity = DEMO_ACTIVITIES.find((a) => a.activityRef === activityRef);
+    const activity = this.activities.find((a) => a.activityRef === activityRef);
     if (!activity) return null;
     return { ...activity, sessions: [], description: "mock \u6F14\u793A\u6D3B\u52A8\u8BE6\u60C5" };
   }
@@ -345,6 +428,16 @@ var MockPromotionServiceImpl = class {
 };
 
 // src/server/shopping.ts
+var SHOPPING_CFG_DEFAULTS = {
+  extraShopName: "",
+  // '' = 不追加门店（空串 = 缺省/不生效语义）
+  extraShopCategory: "\u9910\u996E",
+  extraShopFloor: "3 \u697C",
+  extraShopUnit: "304",
+  extraShopOpen: true
+};
+var SHOPPING_CFG_INT_KEYS = [];
+var SHOPPING_FLOORS = ["B1", "1 \u697C", "2 \u697C", "3 \u697C", "4 \u697C"];
 var DEMO_BUILDINGS = [
   {
     buildingName: "A \u680B",
@@ -425,14 +518,35 @@ function toFloorRecord(floor) {
   return { floorCode: floor.floorName, floorName: floor.floorName, businessCategories: cats, merchantCount: floor.shops.length };
 }
 var MockShoppingServiceImpl = class {
+  /** 配置快照（fail-soft，构造期一次解析；键集 ≡ SHOPPING_CFG_DEFAULTS） */
+  cfg;
   buildings;
   shops;
   categories;
-  constructor(seed = DEMO_BUILDINGS) {
-    this.buildings = seed;
-    this.shops = flattenShops(seed);
+  constructor(seed = DEMO_BUILDINGS, config = {}) {
+    this.cfg = resolveConfig(config, SHOPPING_CFG_DEFAULTS, SHOPPING_CFG_INT_KEYS);
+    const withExtra = this.withExtraShop(seed);
+    this.buildings = withExtra;
+    this.shops = flattenShops(withExtra);
     this.categories = aggregateCategories(this.shops);
   }
+  /** extraShopName 非空 → 指定楼层追加演示门店（名称 trim 判空 + 楼层白名单回退——消费点守卫） */
+  withExtraShop(seed) {
+    const name = this.cfg.extraShopName.trim();
+    if (!name) return seed;
+    const floor = SHOPPING_FLOORS.includes(this.cfg.extraShopFloor) ? this.cfg.extraShopFloor : "3 \u697C";
+    const extra = {
+      merchantId: "demo-shop-1013",
+      name,
+      businessCategories: [this.cfg.extraShopCategory],
+      unitName: this.cfg.extraShopUnit,
+      status: this.cfg.extraShopOpen ? { code: "enabled", label: "\u8425\u4E1A\u4E2D" } : { code: "disabled", label: "\u4F11\u606F\u4E2D" }
+    };
+    return seed.map((b) => ({
+      ...b,
+      floors: b.floors.map((f) => f.floorName === floor ? { ...f, shops: [...f.shops, extra] } : f)
+    }));
+  }
   // ===== ShopDirectoryQueryPort =====
   async searchShops(criteria) {
     const kws = (criteria.keywords ?? (criteria.keyword?.trim() ? [criteria.keyword.trim()] : [])).map((k) => k.trim().toLowerCase()).filter(Boolean);
@@ -496,19 +610,30 @@ var MockShoppingServiceImpl = class {
 // src/server/mall-info.ts
 var MOCK_MALL_INFO_PROVIDER = "mock";
 var MOCK_MALL_INFO_IMPL = "mock-mall-info@1";
+var MALL_INFO_CFG_DEFAULTS = {
+  name: "",
+  // '' 哨兵 = 动态别名回退
+  address: "\u793A\u4F8B\u5546\u573A\u5730\u5740\uFF08demo\uFF09",
+  latitude: 30,
+  longitude: 120
+};
+var MALL_INFO_CFG_INT_KEYS = [];
 var MALL_ID_RE = /^[\w-]{1,32}$/;
-var mockMallInfoFactory = () => ({
-  async getMallInfo(mallId) {
-    if (!MALL_ID_RE.test(mallId)) return void 0;
-    return {
-      mallId,
-      name: `\u793A\u4F8B\u5546\u573A\uFF08${mallId}\uFF09`,
-      address: "\u793A\u4F8B\u5546\u573A\u5730\u5740\uFF08demo\uFF09",
-      latitude: 30,
-      longitude: 120
-    };
-  }
-});
+var mockMallInfoFactory = (input) => {
+  const cfg = resolveConfig(input.config, MALL_INFO_CFG_DEFAULTS, MALL_INFO_CFG_INT_KEYS);
+  return {
+    async getMallInfo(mallId) {
+      if (!MALL_ID_RE.test(mallId)) return void 0;
+      return {
+        mallId,
+        name: cfg.name !== "" ? cfg.name : `\u793A\u4F8B\u5546\u573A\uFF08${mallId}\uFF09`,
+        address: cfg.address,
+        latitude: cfg.latitude,
+        longitude: cfg.longitude
+      };
+    }
+  };
+};
 
 // src/server/mock-enroll-route.ts
 import { Router } from "express";
@@ -558,14 +683,14 @@ var MOCK_MEMBER_IMPL = "mock-member@1";
 var MOCK_PARKING_IMPL = "mock-parking@1";
 var MOCK_PROMOTION_IMPL = "mock-promotion@1";
 var MOCK_SHOPPING_IMPL = "mock-shopping@1";
-var memberFactory = () => new MockMemberServiceImpl();
-var parkingFactory = (input) => new MockParkingServiceImpl(input.instanceId || "mall-demo");
-var promotionFactory = () => new MockPromotionServiceImpl();
+var memberFactory = (input) => new MockMemberServiceImpl({}, input.config);
+var parkingFactory = (input) => new MockParkingServiceImpl(input.instanceId || "mall-demo", input.config);
+var promotionFactory = (input) => new MockPromotionServiceImpl(input.config);
 var shoppingFactory = (input) => {
   if (input.service !== "shopping-guide.catalog" && input.service !== "shopping-guide.shops" && input.service !== "shopping-guide.categories" && input.service !== "shopping-guide.directory") {
     throw new Error(`mock guide \u5DE5\u5382\u4E0D\u4F9B\u7ED9\u69FD\uFF1A${input.service}`);
   }
-  return new MockShoppingServiceImpl();
+  return new MockShoppingServiceImpl(void 0, input.config);
 };
 var mallInfoFactory = (input) => mockMallInfoFactory(input);
 function createMockAlipayLoginExchange(integrations) {
@@ -610,6 +735,9 @@ var serverModule = {
   },
   cards,
   register(ctx) {
+    ctx.integrations?.declareProviderInstances?.("mock", [
+      { id: "mall-demo", name: "\u661F\u6CB3 Mock \u5C0F\u9547", attributes: { miniAppId: "mock-demo-app" } }
+    ]);
     ctx.integrations?.registerAdapter(MOCK_PROVIDER, MOCK_MEMBER_IMPL, memberFactory);
     ctx.integrations?.registerAdapter(MOCK_PROVIDER, MOCK_PARKING_IMPL, parkingFactory);
     ctx.integrations?.registerAdapter(MOCK_PROVIDER, MOCK_PROMOTION_IMPL, promotionFactory);

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@tbox.cn/app-provider-mock",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
-  "description": "商圈 Mock Provider 包（17 槽全 local:true：member×5 / parking×3 / promotion×4 / guide×4 + mall.info）：模板缺省开箱演示——免传输/凭据/实例配置，裸跑即完整 mock 演示。",
+  "description": "商圈 Mock Provider 包（17 槽全 local:true：member×5 / parking×3 / promotion×4 / guide×4 + mall.info）：模板缺省开箱演示——免传输/凭据/实例配置，裸跑即完整 mock 演示；全槽 config schema（schemas/×5 域共享）+ 内存 config 消费（改配置重启即变）。",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -14,9 +14,9 @@
     }
   },
   "dependencies": {
-    "@tbox.cn/app-sdk": "0.17.0",
-    "@tbox.cn/app-contracts": "0.9.0",
-    "@tbox.cn/app-contracts-mall": "0.9.0"
+    "@tbox.cn/app-sdk": "0.19.0",
+    "@tbox.cn/app-contracts": "0.10.0",
+    "@tbox.cn/app-contracts-mall": "0.10.0"
   },
   "devDependencies": {
     "@types/express": "4.17.25",
@@ -28,6 +28,7 @@
   },
   "files": [
     "dist",
+    "schemas",
     "src",
     "tests",
     "tbox.module.json",

package/schemas/mall-info.config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Mock 商场基础信息实例配置",
+  "type": "object",
+  "properties": {
+    "name": { "type": "string", "title": "商场名称（空串 = 动态别名「示例商场（mallId）」回退）", "default": "" },
+    "address": { "type": "string", "title": "商场地址", "default": "示例商场地址（demo）" },
+    "latitude": { "type": "number", "minimum": -90, "maximum": 90, "title": "纬度（分式合法）", "default": 30 },
+    "longitude": { "type": "number", "minimum": -180, "maximum": 180, "title": "经度（分式合法）", "default": 120 }
+  }
+}

package/schemas/member.config.json

@@ -0,0 +1,13 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Mock 会员域实例配置",
+  "type": "object",
+  "properties": {
+    "memberName": { "type": "string", "title": "会员名称（资料标签展示）", "default": "示例会员" },
+    "cardName": { "type": "string", "title": "会员卡名称（卡面 + 积分标签）", "default": "示例会员卡" },
+    "levelName": { "type": "string", "title": "等级名称（空串 = 不展示等级区）", "default": "" },
+    "initialPoints": { "type": "integer", "minimum": 0, "title": "初始积分（入会后余额；流水金额同源派生）", "default": 300 },
+    "enrollUrl": { "type": "string", "title": "入会落地页深链（alipays:// 或 H5）", "default": "alipays://platformapi/startapp?appId=demo&page=v/index/index" },
+    "loginUrl": { "type": "string", "title": "登录页深链（alipays:// 或 H5）", "default": "alipays://platformapi/startapp?appId=demo&page=v/login/index" }
+  }
+}

package/schemas/parking.config.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "Mock 停车域实例配置",
+  "type": "object",
+  "properties": {
+    "parkName": { "type": "string", "title": "停车场名称（信息卡标题 + 缴费记录）", "default": "示例停车场" },
+    "feeName": { "type": "string", "title": "费用项名称", "default": "停车费（3 小时）" },
+    "feeCents": { "type": "integer", "minimum": 0, "title": "停车费（分）", "default": 1500 },
+    "remainingSpaces": { "type": "integer", "minimum": 0, "title": "剩余车位", "default": 128 },
+    "firstHourRate": { "type": "string", "title": "首小时费率文案", "default": "免费" },
+    "memberBenefitEnabled": { "type": "boolean", "title": "会员折扣权益开关（关闭 = 权益列表少一项 + reprice 不变）", "default": true },
+    "memberBenefitDiscountCents": { "type": "integer", "minimum": 0, "title": "会员折扣权益预估减免（分）", "default": 75 },
+    "pointsBenefitEnabled": { "type": "boolean", "title": "积分抵扣权益开关", "default": true },
+    "invoiceEnabled": { "type": "boolean", "title": "开票入口开关（关闭 = 缴费卡无开票按钮）", "default": true },
+    "vehicleFloor": { "type": "string", "title": "寻车楼层", "default": "B1" },
+    "vehicleZone": { "type": "string", "title": "寻车区域", "default": "A 区" },
+    "vehicleSpaceNo": { "type": "string", "title": "寻车车位号", "default": "A-128" }
+  }
+}