@tbox.cn/app-provider-mock 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 tbox.cn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,9 @@
+# @tbox.cn/app-provider-mock
+
+商圈 Mock Provider 包（provider 拆包 F1b）：全槽 local 供给（member×5 / parking×3 /
+promotion×4 / shopping-guide×4 + mall.info，17 槽全 local:true——免传输/凭据/实例配置）。
+
+- 实现自持（R3-1：dag 铁律禁 provider 依赖业务模块）：mock 数据内聚于本包，member 卡面文案
+  中立化（"示例会员卡"）；shopping 域为静态 seed 派生（门店/类目/楼层目录）。
+- 模板缺省绑定（F2）：裸跑即完整 mock 演示——免业务凭据，不免模型密钥。
+- 装配走 `tbox-app module add`（provider 即无卡模块）。

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Mock Provider 包入口（provider 拆包 F1b）。
+ * 服务端能力经 `./server` 子路径（与官方 provider 包同构）。
+ */
+declare const providerId = "provider-mock";
+
+export { providerId };

package/dist/index.js

@@ -0,0 +1,5 @@
+// src/index.ts
+var providerId = "provider-mock";
+export {
+  providerId
+};

package/dist/server/index.d.ts

@@ -0,0 +1,246 @@
+import { ServiceAdapterFactory, ServerContext } from '@tbox.cn/app-sdk/server';
+import { MemberAccountPort, MemberProfilePort, MemberCardPort, MemberBenefitsPort, MemberEnrollmentPort, MemberAccountSnapshot, MemberProfileSnapshot, MemberCardSnapshot, Points, MemberBenefitsSnapshot, PointUsageRecord, DiscountRule, MemberEnrollmentInput, MemberEnrollmentResult, MemberEnrollmentFormDefinition, ParkingQueryPort, ParkingPaymentPort, ParkingVehiclePort, ParkingQueryContext, QuoteSnapshot, ParkingVehicle, ParkingRecordPage, ParkingPaymentRecord, ParkingInfo, ParkingBenefit, ParkingLocation, PromotionOfferQueryPort, PromotionEntitlementPort, PromotionActivityPort, PromotionAcquisitionPort, PromotionQueryContext, PromotionSearchInput, PromotionOfferPage, PromotionOffer, PromotionEntitlementPage, PromotionEntitlement, PromotionActivityPage, PromotionActivityDetail, PromotionOperation, CatalogQueryPort, ShopDirectoryQueryPort, CommercialCategoryQueryPort, MallDirectoryQueryPort, ShopSearchCriteria, ShoppingPage, ShopRecord, ShoppingQueryContext, CategoryRecord, MallDirectoryRecord, ProductSearchCriteria, ProductRecord, ProductFacetsRecord } from '@tbox.cn/app-contracts-mall';
+import { Router } from 'express';
+
+/**
+ * Mock member 实现（provider-mock 自持——R3-1 裁决：provider 不得依赖业务模块，实现自持
+ * 而非包装 module-member InMemory）。演示面最小集：开户/卡面/积分/流水/入会闭环
+ * （demo ref 恒 `demo:` 前缀，厂商中立）。
+ */
+
+type MockMemberService = MemberAccountPort & MemberProfilePort & MemberCardPort & MemberBenefitsPort & MemberEnrollmentPort;
+/** mock 壳侧登录用户（换码器固定身份；mock 语义 = 单 demo 用户/部署） */
+declare const MOCK_SHELL_USER_ID = "demo-user";
+/** 入会落地（幂等）：enroll 路由/enroll() 共用；余额缺省 300；登录成功即清除登出态 */
+declare function enrollMockMember(userId: string): void;
+declare function isMockMemberEnrolled(userId: string): boolean;
+/** 登出标记（mock 档登出态模拟：仅对已入会用户有意义；重登录即清除） */
+declare function logoutMockMember(userId: string): void;
+declare function isMockMemberLoggedOut(userId: string): boolean;
+/** 测试复位（沿 __resetAuthClientSingleton 先例——模块级共享状态可重置） */
+declare function __resetMockMemberState(): void;
+declare class MockMemberServiceImpl implements MockMemberService {
+    /**
+     * 开卡入会落地页深链（module-member MemberService.enrollUrl 接口面——CTA 卡深链为可选
+     * 透传素材，mock 出厂面恒配 demo 值）。demo 值厂商中立（appId=demo），点击在壳内
+     * navigateTo 失败即无害降级。
+     */
+    readonly enrollUrl = "alipays://platformapi/startapp?appId=demo&page=v/index/index";
+    /** 登录页深链（同上，可选透传素材；供未登录引导卡跳转）。 */
+    readonly loginUrl = "alipays://platformapi/startapp?appId=demo&page=v/login/index";
+    /** 默认访客（无种子）：demo-user 初始 not_enrolled，经入会闭环翻为 active */
+    constructor(initial?: Record<string, number>);
+    getAccount(userId: string): Promise<MemberAccountSnapshot>;
+    getProfile(_userId: string): Promise<MemberProfileSnapshot>;
+    getCard(userId: string): Promise<MemberCardSnapshot | null>;
+    queryPoints(userId: string): Promise<Points>;
+    getBenefits(_userId: string): Promise<MemberBenefitsSnapshot>;
+    listPointUsage(_userId: string, page: number, pageSize: number): Promise<{
+        items: PointUsageRecord[];
+        total: number;
+    }>;
+    queryDiscount(): Promise<DiscountRule | undefined>;
+    deductPoints(userId: string, amount: number, _key: string): Promise<boolean>;
+    refundPoints(userId: string, amount: number, _key: string): Promise<boolean>;
+    awardPoints(userId: string, amount: number): Promise<boolean>;
+    enroll(input: MemberEnrollmentInput): Promise<MemberEnrollmentResult>;
+    getEnrollmentStatus(userId: string, _attemptRef: string): Promise<{
+        status: "active";
+        memberRef: string;
+        reason?: undefined;
+    } | {
+        status: "failed";
+        reason: string;
+        memberRef?: undefined;
+    }>;
+    /** 入会表单定义（模块 queryEnrollmentForm 工具消费；无参对齐 InMemory 先例） */
+    getEnrollmentFormDefinition(): Promise<MemberEnrollmentFormDefinition>;
+}
+
+/**
+ * Mock parking 实现（provider-mock 自持——R3-1 裁决）。演示面最小集：报价/车辆/记录/
+ * 综合信息/权益/寻车 + 三步支付链 mock 闭环（reconcile 恒 PAID 收口）。demo ref 恒
+ * `demo:` 前缀，厂商中立；车牌未提供时以演示车（demo-plate）兜底。
+ */
+
+type MockParkingService = ParkingQueryPort & ParkingPaymentPort & ParkingVehiclePort;
+declare class MockParkingServiceImpl implements MockParkingService {
+    private vehicles;
+    private records;
+    constructor(mallId?: string);
+    private mallId;
+    queryFee(q: ParkingQueryContext, input: {
+        plateNo?: string;
+        vehicleRef?: string;
+    }): Promise<readonly QuoteSnapshot[]>;
+    listVehicles(): Promise<{
+        bound: readonly ParkingVehicle[];
+    }>;
+    listPaymentRecords(_q: ParkingQueryContext, page: number, pageSize: number): Promise<ParkingRecordPage>;
+    getPaymentRecordDetail(_q: ParkingQueryContext, recordRef: string): Promise<ParkingPaymentRecord>;
+    getInvoiceSettings(): Promise<{
+        parkingInvoiceEnabled: boolean;
+    }>;
+    listInvoiceableOrders(_q: ParkingQueryContext, page: number, pageSize: number): Promise<ParkingRecordPage>;
+    queryParkingInfo(_q: ParkingQueryContext, kind: ParkingInfo['kind']): Promise<ParkingInfo>;
+    queryApplicableBenefits(_q: ParkingQueryContext, _plateNo: string): Promise<readonly ParkingBenefit[]>;
+    locateVehicle(_q: ParkingQueryContext, _plateNo: string): Promise<ParkingLocation | null>;
+    createOrder(_q: ParkingQueryContext, quoteRef: string): Promise<{
+        payOrderId?: string;
+        paymentRef: string;
+    }>;
+    getOrderInfo(_q: ParkingQueryContext, _paymentRef: string): Promise<{
+        orderInfo?: string;
+        channel: string;
+        payableFeeCents: number | undefined;
+    }>;
+    getPaymentSign(_q: ParkingQueryContext, _paymentRef: string): Promise<{
+        orderInfo: string;
+    }>;
+    uploadResult(): Promise<void>;
+    reconcile(_q: ParkingQueryContext, _paymentRef: string): Promise<'PAID' | 'PAYING' | 'CANCELLED' | 'UNKNOWN'>;
+    reprice(q: ParkingQueryContext, quoteRef: string, benefitRefs: readonly string[]): Promise<QuoteSnapshot>;
+    applyInvoice(_q: ParkingQueryContext, recordRef: string): Promise<void>;
+    bindVehicle(_q: ParkingQueryContext, plateNo: string): Promise<ParkingVehicle>;
+    unbindVehicle(_q: ParkingQueryContext, input: {
+        plateNo?: string;
+        vehicleRef?: string;
+    }): Promise<void>;
+}
+
+/**
+ * Mock promotion 实现（provider-mock 自持——R3-1 裁决）。演示面最小集：搜索/精查/推荐/
+ * 资产列表/活动列表/领取闭环（acquire 恒 SUCCEEDED）。demo ref 恒 `demo:` 前缀，厂商中立。
+ */
+
+type MockPromotionService = PromotionOfferQueryPort & PromotionEntitlementPort & PromotionActivityPort & PromotionAcquisitionPort;
+declare class MockPromotionServiceImpl implements MockPromotionService {
+    searchOffers(_q: PromotionQueryContext, input: PromotionSearchInput): Promise<PromotionOfferPage>;
+    getOfferDetail(_q: PromotionQueryContext, input: {
+        offerRef?: string;
+        entitlementRef?: string;
+        keyword?: string;
+    }): Promise<PromotionOffer | null>;
+    recommendOffers(): Promise<readonly PromotionOffer[]>;
+    listEntitlements(_q: PromotionQueryContext, _input: PromotionSearchInput): Promise<PromotionEntitlementPage>;
+    getEntitlementDetail(_q: PromotionQueryContext, entitlementRef: string): Promise<PromotionEntitlement | null>;
+    listActivities(): Promise<PromotionActivityPage>;
+    getActivityDetail(_q: PromotionQueryContext, activityRef: string): Promise<PromotionActivityDetail | null>;
+    listActivityCategories(): Promise<{
+        categoryId: string;
+        name: string;
+    }[]>;
+    acquire(_q: PromotionQueryContext, input: {
+        offerRef: string;
+        externalMemberRef: string;
+        idempotencyKey: string;
+    }): Promise<PromotionOperation>;
+    getOperation(_q: PromotionQueryContext, operationRef: string): Promise<PromotionOperation | null>;
+}
+
+/**
+ * Mock shopping 实现（provider-mock 自持——R3-1 裁决：provider 不得依赖业务模块）。
+ * 演示面：门店/类目/楼层目录（remote 检索域四键形状的 catalog/shop/category/directory）。
+ *
+ * 设计决策：
+ * - 单一真源：DEMO_BUILDINGS 楼栋→楼层→门店 seed；类目/楼层业态/计数派生聚合；
+ *   floorCode/buildingCode 派生同值（code=name，消除 mall-context id ↔ search-shops
+ *   过滤键隐式映射）。
+ * - 纯 mock：静态数组 + 内存过滤，零 IO、零外部依赖（不依赖知识库/TBOX_API_KEY/datasetId）。
+ * - merchantId 连字符格式（demo-shop-NNNN）：LLM 从卡片 value 提取友好；getShop 入参 trim。
+ * - catalog 空实现（对齐真实档 C 端）：演示面不覆盖商品目录，门店链路为演示重点。
+ * - 构造器接受 seed（默认 DEMO_BUILDINGS）：测试可注入定制数据。
+ */
+
+interface ShopSeed {
+    merchantId: string;
+    name: string;
+    brand?: string;
+    businessCategories: string[];
+    unitName: string;
+    status: {
+        code: 'enabled' | 'disabled';
+        label: string;
+    };
+}
+interface DemoFloor {
+    floorName: string;
+    shops: ShopSeed[];
+}
+interface DemoBuilding {
+    buildingName: string;
+    floors: DemoFloor[];
+}
+declare class MockShoppingServiceImpl implements CatalogQueryPort, ShopDirectoryQueryPort, CommercialCategoryQueryPort, MallDirectoryQueryPort {
+    private readonly buildings;
+    private readonly shops;
+    private readonly categories;
+    constructor(seed?: readonly DemoBuilding[]);
+    searchShops(criteria: ShopSearchCriteria): Promise<ShoppingPage<ShopRecord>>;
+    getShop(shopId: string, _ctx: ShoppingQueryContext): Promise<ShopRecord | null>;
+    listCategories(_ctx: ShoppingQueryContext): Promise<readonly CategoryRecord[]>;
+    getDirectory(ctx: ShoppingQueryContext): Promise<MallDirectoryRecord | null>;
+    searchProducts(criteria: ProductSearchCriteria): Promise<ShoppingPage<ProductRecord>>;
+    getProduct(_productId: string, _ctx: ShoppingQueryContext): Promise<ProductRecord | null>;
+    getFacets(_criteria: ProductSearchCriteria): Promise<ProductFacetsRecord>;
+}
+
+declare const MOCK_MALL_INFO_PROVIDER = "mock";
+declare const MOCK_MALL_INFO_IMPL = "mock-mall-info@1";
+/** mock mall.info adapter 工厂（对齐真实厂商 adapter 工厂形态） */
+declare const mockMallInfoFactory: ServiceAdapterFactory;
+
+/**
+ * Mock 入会落地点路由（入会体验闭环 C5）：POST /api/m/provider-mock/demo/member-enroll。
+ *
+ * 容器 mock-enrollment 页（dev 脚手架）与 curl 联调共用：
+ * - body `{userId?}`：缺省 MOCK_SHELL_USER_ID（mock 页无参——与真实 gate 无参协议面一致；
+ *   curl 可定向翻 dev_h5 等浏览器 dev 用户造会员态调试）。
+ * - 幂等（Set.add / 余额保守写）；NODE_ENV=production → 503（provider-mock 不进生产装配，双保险）。
+ * - 经全局 /api 鉴权（AUTH_MODE 缺省 required）——调用方须携 dev-login 令牌；
+ *   匿名写显式拒绝（不随 AUTH_MODE 放宽）。
+ * - doctor naked-write-route：/demo 前缀在白名单内（webhook/upload/demo/run）。
+ *
+ * 决策逻辑抽纯函数 resolveMockEnroll（单测直达，路由层只做 HTTP 形状映射）。
+ */
+
+declare function createMockEnrollRouter(): Router;
+
+/**
+ * Mock Provider 包服务端入口（provider 拆包 F1b）。
+ *
+ * 17 槽 local 供给（member×5 / parking×3 / promotion×4 / guide×4 + mall.info；manifest
+ * contributes.providers.slots，local:true）：F2 模块 ports
+ * slot 一行化后经 createIntegrationsRegistry.resolveService 解析——local 短路免传输/
+ * 凭据/实例配置。实现自持（R3-1：provider 不得依赖业务模块——workspace-dag 铁律），
+ * demo ref 恒 `demo:` 前缀，厂商中立。
+ *
+ * F1b 阶段形态：adapter 工厂注册经 ctx.integrations（F2 模板装配 createIntegrationsRegistry
+ * 接线后生效）；F1b 前模块仍走探测链，本包装配无行为影响。shopping-guide 槽四键形状
+ * （catalog 空 + shop/category/directory 纯 mock 数据）；assistance/navigation 本地知识库域
+ * 归模块本地 adapter，不属 provider 供给面。
+ *
+ * 入会体验闭环（C5）追加两件：
+ * - scoped mock 换码器（ctx.authExchanges）：固定 demo-user、GUEST/MEMBER 双形态对齐
+ *   真实厂商换码协议（潜客 token=''+openid ↔ 会员 token+memberId）——mock 档冷登走与
+ *   真实档同一条换码链，H5 侧代码零分叉。刻意不实现 devExternalCredentials：dev-login
+ *   走协议 fail-soft 无 claim 签发（login-routes 三层解析能力口缺席即跳过）。
+ * - mock 入会落地路由（ctx.routes）：POST /demo/member-enroll（容器 mock-enrollment 页
+ *   回调 + curl 联调）。
+ */
+
+declare const MOCK_PROVIDER = "mock";
+declare const MOCK_MEMBER_IMPL = "mock-member@1";
+declare const MOCK_PARKING_IMPL = "mock-parking@1";
+declare const MOCK_PROMOTION_IMPL = "mock-promotion@1";
+declare const MOCK_SHOPPING_IMPL = "mock-shopping@1";
+
+declare const serverModule: {
+    declaration: {
+        moduleId: string;
+    };
+    cards: {};
+    register(ctx: ServerContext): void;
+};
+
+export { MOCK_MALL_INFO_IMPL, MOCK_MALL_INFO_PROVIDER, MOCK_MEMBER_IMPL, MOCK_PARKING_IMPL, MOCK_PROMOTION_IMPL, MOCK_PROVIDER, MOCK_SHELL_USER_ID, MOCK_SHOPPING_IMPL, MockMemberServiceImpl, MockParkingServiceImpl, MockPromotionServiceImpl, MockShoppingServiceImpl, __resetMockMemberState, createMockEnrollRouter, enrollMockMember, isMockMemberEnrolled, isMockMemberLoggedOut, logoutMockMember, mockMallInfoFactory, serverModule };