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

package/dist/runtime.js

@@ -0,0 +1,457 @@
+// src/scope.ts
+import { z } from "zod";
+var MALL_SCOPE_KEY = "mall";
+var mallScopeSchema = z.object({
+  miniAppId: z.string().min(1),
+  mallId: z.string().min(1),
+  subjectId: z.string().optional()
+});
+function parseMallScope(attributes) {
+  const raw = attributes?.[MALL_SCOPE_KEY];
+  if (!raw || typeof raw !== "object") return void 0;
+  const result = mallScopeSchema.safeParse(raw);
+  return result.success ? result.data : void 0;
+}
+function extractMallScope(ctx) {
+  return parseMallScope(ctx.attributes);
+}
+function requireMallScope(ctx) {
+  return ctx.attributes[MALL_SCOPE_KEY];
+}
+
+// src/assembly.ts
+function createMallRuntimeAssembly(controlPlane) {
+  const mallIds = new Set(controlPlane.malls.map((m) => m.mallId));
+  return {
+    extractScopeKey(ctx) {
+      const scope = extractMallScope(ctx);
+      if (!scope) throw new Error("Mall scope is required");
+      return scope.mallId;
+    },
+    validateScope(attributes) {
+      const scope = parseMallScope(attributes);
+      return scope !== void 0 && mallIds.has(scope.mallId);
+    },
+    buildScope(attributes) {
+      const scope = parseMallScope(attributes);
+      if (!scope) return {};
+      return { miniAppId: scope.miniAppId, mallId: scope.mallId };
+    },
+    extractMallScope,
+    requireMallScope,
+    controlPlane
+  };
+}
+
+// src/guard.ts
+import { z as z2 } from "zod";
+var mallLocationSchema = z2.object({
+  latitude: z2.string().min(1),
+  longitude: z2.string().min(1),
+  mallId: z2.string().optional(),
+  name: z2.string().optional()
+});
+function parseMallLocation(raw) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const result = mallLocationSchema.safeParse(raw);
+  return result.success ? result.data : void 0;
+}
+var mallUserRefSchema = z2.object({
+  userId: z2.string().min(1),
+  subjectId: z2.string().optional()
+});
+function parseMallUserRef(raw) {
+  if (!raw || typeof raw !== "object") return void 0;
+  const result = mallUserRefSchema.safeParse(raw);
+  return result.success ? result.data : void 0;
+}
+
+// src/shopping-guide/cards.ts
+import { z as z3 } from "zod";
+var httpsUrlSchema = z3.string().regex(/^https:\/\//).max(2048);
+var isoDateTimeSchema = z3.string().regex(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{3})?Z$/);
+var moneySchema = z3.object({
+  currency: z3.literal("CNY"),
+  amountMinor: z3.number().int().min(0),
+  display: z3.string().min(1)
+});
+var priceSummarySchema = z3.object({
+  sale: moneySchema.optional(),
+  original: moneySchema.optional(),
+  promotion: moneySchema.optional()
+});
+var evidenceSchema = z3.object({
+  code: z3.string().min(1),
+  label: z3.string().min(1),
+  value: z3.string().optional(),
+  observedAt: isoDateTimeSchema,
+  expiresAt: isoDateTimeSchema.optional(),
+  sourceKind: z3.enum(["catalog", "merchant", "mall", "policy"])
+});
+var reasonItemSchema = z3.object({ code: z3.string().min(1), label: z3.string().min(1) });
+var merchantLocationSchema = z3.object({
+  buildingName: z3.string().optional(),
+  floorName: z3.string().optional(),
+  unitName: z3.string().optional(),
+  displayText: z3.string().min(1),
+  poiId: z3.string().optional()
+});
+var merchantStatusSchema = z3.object({
+  code: z3.enum(["enabled", "disabled", "unknown"]),
+  label: z3.string().min(1),
+  observedAt: isoDateTimeSchema
+});
+var pageInfoSchema = z3.object({
+  page: z3.number().int().min(1),
+  pageSize: z3.number().int().min(1).max(100),
+  total: z3.number().int().min(0),
+  hasMore: z3.boolean()
+});
+var refinementSchema = z3.object({ label: z3.string().min(1), queryText: z3.string().min(1) });
+var actionDraftSchema = z3.object({
+  actionId: z3.string().min(1),
+  label: z3.string().min(1),
+  input: z3.record(z3.string(), z3.unknown()).optional()
+});
+var productListCardDataSchema = z3.object({
+  context: z3.enum(["recommendation", "search", "similar", "history"]),
+  summary: z3.string().optional(),
+  items: z3.array(
+    z3.object({
+      productId: z3.string().min(1),
+      name: z3.string().min(1),
+      imageUrl: httpsUrlSchema.optional(),
+      brand: z3.string().optional(),
+      categoryPath: z3.array(z3.string()),
+      price: priceSummarySchema,
+      availability: z3.object({
+        status: z3.enum(["in_stock", "out_of_stock", "limited", "unknown"]),
+        label: z3.string(),
+        marketable: z3.boolean(),
+        observedAt: isoDateTimeSchema
+      }),
+      merchant: z3.object({
+        merchantId: z3.string(),
+        name: z3.string(),
+        location: merchantLocationSchema.optional()
+      }),
+      badges: z3.array(z3.string()),
+      reasons: z3.array(reasonItemSchema).optional(),
+      evidence: z3.array(evidenceSchema).optional(),
+      caveats: z3.array(z3.string()),
+      itemActions: z3.array(actionDraftSchema)
+    })
+  ),
+  noResultsReason: z3.string().optional(),
+  pageInfo: pageInfoSchema.optional(),
+  refinements: z3.array(refinementSchema)
+});
+var merchantListCardDataSchema = z3.object({
+  context: z3.enum(["recommendation", "search"]),
+  summary: z3.string().optional(),
+  items: z3.array(
+    z3.object({
+      merchantId: z3.string(),
+      name: z3.string(),
+      logoUrl: httpsUrlSchema.optional(),
+      coverUrl: httpsUrlSchema.optional(),
+      brand: z3.string().optional(),
+      businessCategories: z3.array(z3.string()),
+      location: merchantLocationSchema,
+      status: merchantStatusSchema,
+      services: z3.array(z3.string()),
+      promotionFacts: z3.array(z3.string()),
+      reasons: z3.array(reasonItemSchema).optional(),
+      evidence: z3.array(evidenceSchema).optional(),
+      itemActions: z3.array(actionDraftSchema)
+    })
+  ),
+  noResultsReason: z3.string().optional(),
+  pageInfo: pageInfoSchema.optional(),
+  refinements: z3.array(refinementSchema)
+});
+var productDetailCardDataSchema = z3.object({
+  productId: z3.string().min(1),
+  name: z3.string().min(1),
+  description: z3.string().optional(),
+  imageUrls: z3.array(httpsUrlSchema),
+  brand: z3.string().optional(),
+  categoryPath: z3.array(z3.string()),
+  price: priceSummarySchema,
+  availability: z3.object({
+    status: z3.enum(["in_stock", "out_of_stock", "limited", "unknown"]),
+    label: z3.string(),
+    marketable: z3.boolean(),
+    observedAt: isoDateTimeSchema
+  }),
+  merchant: z3.object({
+    merchantId: z3.string(),
+    name: z3.string(),
+    location: merchantLocationSchema.optional()
+  }),
+  attributes: z3.array(z3.object({ name: z3.string(), value: z3.string() })),
+  promotionFacts: z3.array(z3.string()),
+  evidence: z3.array(evidenceSchema),
+  humanGuideAvailable: z3.boolean(),
+  itemActions: z3.array(actionDraftSchema)
+});
+var merchantDetailCardDataSchema = z3.object({
+  merchantId: z3.string(),
+  name: z3.string(),
+  logoUrl: httpsUrlSchema.optional(),
+  coverUrls: z3.array(httpsUrlSchema),
+  brand: z3.string().optional(),
+  businessCategories: z3.array(z3.string()),
+  location: merchantLocationSchema,
+  status: merchantStatusSchema,
+  description: z3.string().optional(),
+  contactInfo: z3.array(z3.object({ channel: z3.string(), value: z3.string() })).optional(),
+  services: z3.array(z3.string()),
+  promotionFacts: z3.array(z3.string()),
+  evidence: z3.array(evidenceSchema),
+  itemActions: z3.array(actionDraftSchema)
+});
+var categoryListCardDataSchema = z3.object({
+  categories: z3.array(
+    z3.object({
+      code: z3.string().min(1),
+      name: z3.string().min(1),
+      description: z3.string().optional(),
+      merchantCount: z3.number().int().min(0),
+      subCategories: z3.array(z3.object({ code: z3.string(), name: z3.string(), merchantCount: z3.number().int().min(0) })).optional()
+    })
+  ),
+  observedAt: isoDateTimeSchema
+});
+var productComparisonCardDataSchema = z3.object({
+  products: z3.array(
+    z3.object({
+      productId: z3.string().min(1),
+      name: z3.string().min(1),
+      imageUrl: httpsUrlSchema.optional(),
+      brand: z3.string().optional(),
+      price: priceSummarySchema,
+      availability: z3.object({
+        status: z3.enum(["in_stock", "out_of_stock", "limited", "unknown"]),
+        label: z3.string(),
+        marketable: z3.boolean(),
+        observedAt: isoDateTimeSchema
+      }),
+      merchant: z3.object({ merchantId: z3.string(), name: z3.string() }),
+      attributes: z3.array(z3.object({ name: z3.string(), value: z3.string() })),
+      caveats: z3.array(z3.string())
+    })
+  ),
+  observedAt: isoDateTimeSchema
+});
+var mallDirectoryCardDataSchema = z3.object({
+  mallId: z3.string(),
+  mallName: z3.string(),
+  buildings: z3.array(
+    z3.object({
+      buildingCode: z3.string(),
+      buildingName: z3.string(),
+      floors: z3.array(
+        z3.object({
+          floorCode: z3.string(),
+          floorName: z3.string(),
+          businessCategories: z3.array(z3.string()),
+          merchantCount: z3.number().int().min(0)
+        })
+      )
+    })
+  ),
+  observedAt: isoDateTimeSchema
+});
+var nearbyMallListCardDataSchema = z3.object({
+  query: z3.string().optional(),
+  malls: z3.array(
+    z3.object({
+      mallId: z3.string(),
+      name: z3.string(),
+      address: z3.string(),
+      distanceKm: z3.number().min(0).optional(),
+      status: z3.object({ code: z3.enum(["open", "closed", "unknown"]), label: z3.string() }),
+      itemActions: z3.array(actionDraftSchema)
+    })
+  )
+});
+var customerServiceFaqCardDataSchema = z3.object({
+  query: z3.string().min(1),
+  faqs: z3.array(
+    z3.object({
+      question: z3.string().min(1),
+      answer: z3.string().min(1),
+      category: z3.string().optional(),
+      relevanceScore: z3.number().min(0).max(1)
+    })
+  ),
+  noResultsReason: z3.string().optional()
+});
+var humanGuideListCardDataSchema = z3.object({
+  merchantId: z3.string(),
+  merchantName: z3.string(),
+  guides: z3.array(
+    z3.object({
+      guideId: z3.string(),
+      name: z3.string(),
+      title: z3.string().optional(),
+      avatarUrl: httpsUrlSchema.optional(),
+      contactInfo: z3.array(z3.object({ channel: z3.string(), value: z3.string() })).optional(),
+      available: z3.boolean(),
+      itemActions: z3.array(actionDraftSchema)
+    })
+  )
+});
+var locationHandoffCardDataSchema = z3.object({
+  merchantId: z3.string(),
+  merchantName: z3.string(),
+  location: merchantLocationSchema,
+  mapUrl: httpsUrlSchema.optional(),
+  navigation: z3.object({
+    provider: z3.enum(["amap", "builtin"]),
+    launchParams: z3.record(z3.string(), z3.string()).optional()
+  }).optional(),
+  itemActions: z3.array(actionDraftSchema)
+});
+var shoppingGuideCardDataSchemas = {
+  "product-list": productListCardDataSchema,
+  "product-detail": productDetailCardDataSchema,
+  "merchant-list": merchantListCardDataSchema,
+  "merchant-detail": merchantDetailCardDataSchema,
+  "category-list": categoryListCardDataSchema,
+  "product-comparison": productComparisonCardDataSchema,
+  "mall-directory": mallDirectoryCardDataSchema,
+  "nearby-mall-list": nearbyMallListCardDataSchema,
+  "customer-service-faq": customerServiceFaqCardDataSchema,
+  "human-guide-list": humanGuideListCardDataSchema,
+  "location-handoff": locationHandoffCardDataSchema
+};
+
+// src/member/cards.ts
+import { z as z4 } from "zod";
+var memberStateSchema = z4.enum(["active", "not_enrolled", "closed"]);
+var memberInfoCardDataSchema = z4.object({
+  userId: z4.string().min(1),
+  state: memberStateSchema,
+  displayName: z4.string().optional(),
+  avatarUrl: z4.string().optional(),
+  contactDisplay: z4.string().optional(),
+  memberRef: z4.string().optional(),
+  registeredAt: z4.string().optional(),
+  labels: z4.array(z4.object({ labelRef: z4.string(), name: z4.string() }))
+});
+var memberCardSummaryCardDataSchema = z4.object({
+  userId: z4.string().min(1),
+  cardRef: z4.string(),
+  cardDisplay: z4.string(),
+  status: z4.enum(["active", "inactive", "frozen", "expired", "unknown"]),
+  levelName: z4.string().optional(),
+  availablePoints: z4.number().int().min(0),
+  cardImageUrl: z4.string().optional()
+});
+var memberCouponListCardDataSchema = z4.object({
+  userId: z4.string().min(1),
+  items: z4.array(
+    z4.object({
+      couponRef: z4.string(),
+      title: z4.string(),
+      type: z4.enum(["amount", "discount", "gift", "parking", "unknown"]),
+      status: z4.enum(["effective", "used", "expired", "invalid", "unknown"]),
+      benefitText: z4.string().optional(),
+      thresholdText: z4.string().optional()
+    })
+  ),
+  total: z4.number().int().min(0)
+});
+var memberCouponDetailCardDataSchema = z4.object({
+  couponRef: z4.string(),
+  title: z4.string(),
+  type: z4.enum(["amount", "discount", "gift", "parking", "unknown"]),
+  status: z4.enum(["effective", "used", "expired", "invalid", "unknown"]),
+  description: z4.string().optional(),
+  benefitText: z4.string().optional(),
+  thresholdText: z4.string().optional()
+});
+var memberPointUsageListCardDataSchema = z4.object({
+  userId: z4.string().min(1),
+  balance: z4.number().int(),
+  level: z4.enum(["silver", "gold", "platinum"]),
+  items: z4.array(
+    z4.object({
+      usageRecordRef: z4.string(),
+      title: z4.string(),
+      amount: z4.string(),
+      usedAt: z4.string().optional(),
+      description: z4.string().optional()
+    })
+  ),
+  total: z4.number().int().min(0)
+});
+var memberEnrollmentFormCardDataSchema = z4.object({
+  userId: z4.string().min(1),
+  state: memberStateSchema,
+  /** 表单必填项（渲染端收集后经 componentAction member.enroll 提交） */
+  fields: z4.array(z4.object({ fieldId: z4.string(), label: z4.string(), required: z4.boolean() })),
+  actionId: z4.string()
+});
+var memberEnrollmentStatusCardDataSchema = z4.object({
+  userId: z4.string().min(1),
+  success: z4.boolean(),
+  memberRef: z4.string().optional(),
+  message: z4.string().optional(),
+  state: memberStateSchema
+});
+var memberCardDataSchemas = {
+  "member-info": memberInfoCardDataSchema,
+  "member-card-summary": memberCardSummaryCardDataSchema,
+  "member-coupon-list": memberCouponListCardDataSchema,
+  "member-coupon-detail": memberCouponDetailCardDataSchema,
+  "member-point-usage-list": memberPointUsageListCardDataSchema,
+  "member-enrollment-form": memberEnrollmentFormCardDataSchema,
+  "member-enrollment-status": memberEnrollmentStatusCardDataSchema
+};
+export {
+  MALL_SCOPE_KEY,
+  actionDraftSchema,
+  categoryListCardDataSchema,
+  createMallRuntimeAssembly,
+  customerServiceFaqCardDataSchema,
+  evidenceSchema,
+  extractMallScope,
+  httpsUrlSchema,
+  humanGuideListCardDataSchema,
+  isoDateTimeSchema,
+  locationHandoffCardDataSchema,
+  mallDirectoryCardDataSchema,
+  mallLocationSchema,
+  mallScopeSchema,
+  mallUserRefSchema,
+  memberCardDataSchemas,
+  memberCardSummaryCardDataSchema,
+  memberCouponDetailCardDataSchema,
+  memberCouponListCardDataSchema,
+  memberEnrollmentFormCardDataSchema,
+  memberEnrollmentStatusCardDataSchema,
+  memberInfoCardDataSchema,
+  memberPointUsageListCardDataSchema,
+  memberStateSchema,
+  merchantDetailCardDataSchema,
+  merchantListCardDataSchema,
+  merchantLocationSchema,
+  merchantStatusSchema,
+  moneySchema,
+  nearbyMallListCardDataSchema,
+  pageInfoSchema,
+  parseMallLocation,
+  parseMallScope,
+  parseMallUserRef,
+  priceSummarySchema,
+  productComparisonCardDataSchema,
+  productDetailCardDataSchema,
+  productListCardDataSchema,
+  reasonItemSchema,
+  refinementSchema,
+  requireMallScope,
+  shoppingGuideCardDataSchemas
+};

package/dist/scope.d.ts

@@ -0,0 +1,49 @@
+/**
+ * 商圈 scope（011 B2：TIER1 领域语义唯一真源）：
+ * MallScope 类型 + zod 解析 + RequestContext 提取器。
+ *
+ * 消费方（模块）只依赖本文件解析 attributes，不解析原始形状（011 B4）；
+ * TIER0（app-contracts）不出现任何 mall 语义（011 B1）。
+ */
+import { z } from 'zod';
+import type { RequestContext } from '@tbox.cn/app-contracts';
+/** attributes 键名（TIER0 槽位内 TIER1 自定键，单一来源） */
+export declare const MALL_SCOPE_KEY = "mall";
+/** 商圈 scope（客户端输入形状——HELLO context.attributes.mall；会话边界键：mallId） */
+export interface MallScope {
+    /** 小程序 appId（定位到具体小程序实例） */
+    miniAppId: string;
+    /** 商圈 id（会话边界：跨 mall 强制新会话，011 F3） */
+    mallId: string;
+    /** 可选主体 id（会员体系 subject） */
+    subjectId?: string;
+}
+/** 011 S7：服务端回显形状（= MallScope + 服务端生成的 sessionId；与输入形状分离） */
+export interface MallSessionScope extends MallScope {
+    sessionId: string;
+}
+export declare const mallScopeSchema: z.ZodObject<{
+    miniAppId: z.ZodString;
+    mallId: z.ZodString;
+    subjectId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    miniAppId: string;
+    mallId: string;
+    subjectId?: string | undefined;
+}, {
+    miniAppId: string;
+    mallId: string;
+    subjectId?: string | undefined;
+}>;
+/** 解析失败返回 undefined（不 throw），模块自行降级（011 B2 语义） */
+export declare function parseMallScope(attributes: Record<string, unknown> | undefined): MallScope | undefined;
+/** 从 RequestContext 提取 MallScope（parseMallScope 包装） */
+export declare function extractMallScope(ctx: RequestContext): MallScope | undefined;
+/** mall 领域运行上下文（attributes 含 mall 的 RequestContext 收窄，模块 handler 入参可用） */
+export type MallRequestContext = RequestContext & {
+    attributes: Record<string, unknown> & {
+        [MALL_SCOPE_KEY]: MallScope;
+    };
+};
+/** 从 MallRequestContext 取 MallScope（调用方已确认 scope 存在） */
+export declare function requireMallScope(ctx: MallRequestContext): MallScope;

package/dist/services/member.d.ts

@@ -1,19 +1,111 @@
 import type { Points } from '../domain/points';
 import type { DiscountRule } from '../domain/discount';
 /**
- * MemberQueryPort：消费方（parking / scenario）需要的 member 查询子集。
- * 结构类型子集接口——模块完整实现 extends 此接口，消费方仅依赖契约包（001 §5.3）。
+ * 会员域 Port（011 K2：6 Port 替换旧 MemberQueryPort/MemberSettlementPort，breaking 0.2.0）。
+ * 结构类型子集接口——模块完整实现 extends 本接口，消费方仅依赖契约包。
  */
-export interface MemberQueryPort {
+/** 会员状态（含未入会/关闭） */
+export type MemberState = 'active' | 'not_enrolled' | 'closed';
+export interface MemberAccountSnapshot {
+    readonly state: MemberState;
+    readonly memberRef?: string;
+    readonly primaryMallCardNo?: string;
+    readonly registeredAt?: string;
+    readonly observedAt: string;
+}
+export interface MemberAccountPort {
+    getAccount(userId: string): Promise<MemberAccountSnapshot>;
+}
+export interface MemberProfileSnapshot {
+    readonly displayName?: string;
+    readonly avatarUrl?: string;
+    readonly contactDisplay?: string;
+    readonly birthday?: string;
+    readonly gender?: 'unknown' | 'unspecified' | 'male' | 'female';
+    readonly labels: ReadonlyArray<{
+        readonly labelRef: string;
+        readonly name: string;
+    }>;
+    readonly observedAt: string;
+}
+export interface MemberProfilePort {
+    getProfile(userId: string): Promise<MemberProfileSnapshot>;
+}
+export interface MemberCardSnapshot {
+    readonly cardRef: string;
+    readonly cardDisplay: string;
+    readonly status: 'active' | 'inactive' | 'frozen' | 'expired' | 'unknown';
+    readonly levelName?: string;
+    readonly cardImageUrl?: string;
+    readonly observedAt: string;
+}
+export interface MemberCardPort {
+    getCard(userId: string): Promise<MemberCardSnapshot | null>;
+}
+export interface MemberBenefitsSnapshot {
+    readonly availablePoints: number;
+    readonly usedPoints?: number;
+    readonly expiringPoints?: number;
+    readonly levelName?: string;
+    readonly observedAt: string;
+}
+export interface MemberBenefitsPort {
+    /** 积分查询（替代旧 MemberQueryPort.queryPoints） */
     queryPoints(userId: string): Promise<Points>;
+    /** 权益快照 */
+    getBenefits(userId: string): Promise<MemberBenefitsSnapshot>;
+    /** 积分流水（points 卡数据源） */
+    listPointUsage(userId: string, page: number, pageSize: number): Promise<{
+        items: ReadonlyArray<PointUsageRecord>;
+        total: number;
+    }>;
+    /** 折扣查询（替代旧 MemberQueryPort.queryDiscount） */
     queryDiscount(userId: string): Promise<DiscountRule | undefined>;
-}
-/**
- * MemberSettlementPort：跨模块写操作（scenario 编排 + 补偿用）。
- * 幂等键由调用方（scenario handler）生成。
- */
-export interface MemberSettlementPort {
+    /** 结算写（替代旧 MemberSettlementPort；幂等键由调用方生成） */
     deductPoints(userId: string, amount: number, idempotencyKey: string): Promise<boolean>;
     refundPoints(userId: string, amount: number, idempotencyKey: string): Promise<boolean>;
     awardPoints(userId: string, amount: number): Promise<boolean>;
 }
+export interface PointUsageRecord {
+    readonly usageRecordRef: string;
+    readonly title: string;
+    /** 字符串化金额（D11 展示层统一字符串） */
+    readonly amount: string;
+    readonly usedAt?: string;
+    readonly description?: string;
+}
+export interface MemberCouponSnapshot {
+    readonly couponRef: string;
+    readonly title: string;
+    readonly type: 'amount' | 'discount' | 'gift' | 'parking' | 'unknown';
+    readonly status: 'effective' | 'used' | 'expired' | 'invalid' | 'unknown';
+    readonly description?: string;
+    readonly benefitText?: string;
+    readonly thresholdText?: string;
+}
+export interface MemberCouponPort {
+    listCoupons(userId: string, page: number, pageSize: number): Promise<{
+        items: ReadonlyArray<MemberCouponSnapshot>;
+        total: number;
+    }>;
+    getCoupon(userId: string, couponRef: string): Promise<MemberCouponSnapshot | null>;
+}
+export interface MemberEnrollmentPort {
+    /** 入会（授权回调后调用；幂等：已入会返回成功） */
+    enroll(input: {
+        userId: string;
+        name?: string;
+        phone?: string;
+    }): Promise<{
+        success: boolean;
+        memberRef?: string;
+        error?: string;
+    }>;
+    /** 授权回调补签（alipay-user-profile 授权结果 → 会员资料落库） */
+    completeAuthorization(input: {
+        userId: string;
+        scopes: readonly string[];
+    }): Promise<{
+        success: boolean;
+    }>;
+}