@tbox.cn/app-contracts-mall 0.2.0 → 0.9.0

package/dist/shopping-guide/ports.d.ts

@@ -1,216 +0,0 @@
-/**
- * 导购域 Port 接口（011 S7：shopping-guide 6 Port，TIER1 结构类型子集）。
- * 模块完整实现 extends 本接口；消费方（其他模块）仅依赖契约包。
- */
-import type { MallRequestContext, MallScope } from '../scope';
-export interface ShoppingQueryContext {
-    /** mall scope（session 绑定） */
-    readonly scope: MallScope;
-    /** 当前主体（会员体系 subjectId；匿名缺省） */
-    readonly subjectId?: string;
-    /** 请求上下文（handler 内可用；跨模块消费方仅依赖本契约） */
-    readonly requestContext: MallRequestContext;
-}
-export interface ShoppingPage<T> {
-    readonly items: readonly T[];
-    readonly page: number;
-    readonly pageSize: number;
-    readonly total: number;
-    readonly hasMore: boolean;
-}
-export interface ProductSearchCriteria {
-    readonly ctx: ShoppingQueryContext;
-    readonly keyword?: string;
-    readonly keywords?: readonly string[];
-    readonly categoryCode?: string;
-    readonly brandCode?: string;
-    readonly minPriceMinor?: number;
-    readonly maxPriceMinor?: number;
-    readonly floorCode?: string;
-    readonly buildingCode?: string;
-    readonly page: number;
-    readonly pageSize: number;
-    readonly marketableOnly?: boolean;
-}
-export interface CatalogQueryPort {
-    searchProducts(criteria: ProductSearchCriteria): Promise<ShoppingPage<ProductRecord>>;
-    getProduct(productId: string, ctx: ShoppingQueryContext): Promise<ProductRecord | null>;
-    getFacets(criteria: ProductSearchCriteria): Promise<ProductFacetsRecord>;
-}
-export interface ProductRecord {
-    readonly productId: string;
-    readonly name: string;
-    readonly description?: string;
-    readonly imageUrls: readonly string[];
-    readonly brand?: string;
-    readonly categoryPath: readonly string[];
-    readonly price: {
-        readonly sale?: MoneyRecord;
-        readonly original?: MoneyRecord;
-        readonly promotion?: MoneyRecord;
-    };
-    readonly availability: {
-        readonly status: 'in_stock' | 'out_of_stock' | 'limited' | 'unknown';
-        readonly label: string;
-        readonly marketable: boolean;
-        readonly observedAt: string;
-    };
-    readonly merchant: {
-        readonly merchantId: string;
-        readonly name: string;
-        readonly location?: MerchantLocationRecord;
-    };
-    readonly labels: readonly string[];
-    readonly attributes: ReadonlyArray<{
-        readonly name: string;
-        readonly value: string;
-    }>;
-    readonly promotionFacts: readonly string[];
-    readonly observedAt: string;
-}
-export interface MoneyRecord {
-    readonly currency: 'CNY';
-    readonly amountMinor: number;
-    readonly display: string;
-}
-export interface MerchantLocationRecord {
-    readonly buildingName?: string;
-    readonly floorName?: string;
-    readonly unitName?: string;
-    readonly displayText: string;
-    readonly poiId?: string;
-}
-export interface ProductFacetsRecord {
-    readonly brands: ReadonlyArray<{
-        readonly code: string;
-        readonly name: string;
-        readonly count: number;
-    }>;
-    readonly categories: ReadonlyArray<{
-        readonly code: string;
-        readonly name: string;
-        readonly count: number;
-    }>;
-    readonly priceRanges: ReadonlyArray<{
-        readonly minMinor: number;
-        readonly maxMinor: number;
-        readonly displayLabel: string;
-        readonly count: number;
-    }>;
-    readonly floors: ReadonlyArray<{
-        readonly code: string;
-        readonly displayName: string;
-        readonly count: number;
-    }>;
-}
-export interface MerchantSearchCriteria {
-    readonly ctx: ShoppingQueryContext;
-    readonly keyword?: string;
-    readonly keywords?: readonly string[];
-    readonly brandCode?: string;
-    readonly businessCategory?: string;
-    readonly floorCode?: string;
-    readonly buildingCode?: string;
-    readonly page: number;
-    readonly pageSize: number;
-}
-export interface MerchantDirectoryQueryPort {
-    searchMerchants(criteria: MerchantSearchCriteria): Promise<ShoppingPage<MerchantRecord>>;
-    getMerchant(merchantId: string, ctx: ShoppingQueryContext): Promise<MerchantRecord | null>;
-}
-export interface MerchantRecord {
-    readonly merchantId: string;
-    readonly name: string;
-    readonly logoUrl?: string;
-    readonly coverUrls: readonly string[];
-    readonly brand?: string;
-    readonly businessCategories: readonly string[];
-    readonly location: MerchantLocationRecord;
-    readonly status: {
-        readonly code: 'enabled' | 'disabled' | 'unknown';
-        readonly label: string;
-        readonly observedAt: string;
-    };
-    readonly description?: string;
-    readonly contactInfo?: ReadonlyArray<{
-        readonly channel: string;
-        readonly value: string;
-    }>;
-    readonly services: readonly string[];
-    readonly promotionFacts: readonly string[];
-    readonly observedAt: string;
-}
-export interface CommercialCategoryQueryPort {
-    listCategories(ctx: ShoppingQueryContext): Promise<readonly CategoryRecord[]>;
-}
-export interface CategoryRecord {
-    readonly code: string;
-    readonly name: string;
-    readonly description?: string;
-    readonly merchantCount: number;
-    readonly subCategories?: ReadonlyArray<{
-        readonly code: string;
-        readonly name: string;
-        readonly merchantCount: number;
-    }>;
-}
-export interface MallDirectoryQueryPort {
-    getDirectory(ctx: ShoppingQueryContext): Promise<MallDirectoryRecord | null>;
-}
-export interface MallDirectoryRecord {
-    readonly mallId: string;
-    readonly mallName: string;
-    readonly buildings: ReadonlyArray<{
-        readonly buildingCode: string;
-        readonly buildingName: string;
-        readonly floors: ReadonlyArray<{
-            readonly floorCode: string;
-            readonly floorName: string;
-            readonly businessCategories: readonly string[];
-            readonly merchantCount: number;
-        }>;
-    }>;
-    readonly observedAt: string;
-}
-export interface FaqEntry {
-    readonly question: string;
-    readonly answer: string;
-    readonly category?: string;
-    readonly relevanceScore: number;
-}
-export interface AssistanceQueryPort {
-    searchFaq(ctx: ShoppingQueryContext, query: string, topK?: number): Promise<readonly FaqEntry[]>;
-    searchKnowledge(ctx: ShoppingQueryContext, query: string, topK?: number): Promise<readonly KnowledgeEntry[]>;
-    listHumanGuides(merchantId: string, ctx: ShoppingQueryContext): Promise<readonly HumanGuideRecord[]>;
-}
-export interface KnowledgeEntry {
-    readonly content: string;
-    readonly title?: string;
-    readonly score: number;
-}
-export interface HumanGuideRecord {
-    readonly guideId: string;
-    readonly name: string;
-    readonly title?: string;
-    readonly avatarUrl?: string;
-    readonly contactInfo?: ReadonlyArray<{
-        readonly channel: string;
-        readonly value: string;
-    }>;
-    readonly available: boolean;
-}
-export interface NavigationPort {
-    getLocation(merchantId: string, ctx: ShoppingQueryContext): Promise<MerchantLocationRecord | null>;
-    listNearbyMalls(ctx: ShoppingQueryContext, query?: string): Promise<readonly NearbyMallRecord[]>;
-    listBrowsingHistory(ctx: ShoppingQueryContext, page: number, pageSize: number): Promise<ShoppingPage<ProductRecord>>;
-}
-export interface NearbyMallRecord {
-    readonly mallId: string;
-    readonly name: string;
-    readonly address: string;
-    readonly distanceKm?: number;
-    readonly status: {
-        readonly code: 'open' | 'closed' | 'unknown';
-        readonly label: string;
-    };
-}