@bi-nova/services 1.7.0-beta.202609181052 → 1.7.0-beta.202609231820

package/README.md

@@ -1,6 +1,6 @@
 # @bi-nova/services
 
-跨平台广告服务 SDK，以 NovaSDK 插件形式提供京东保险口令、京东金融现金贷等业务服务。
+跨平台广告服务 SDK，以 NovaSDK 插件形式提供京东保险口令、京东金融现金贷、平台大会员等业务服务。
 
 支持环境：微信小程序、支付宝小程序、Taro、H5（浏览器）。
 
@@ -36,6 +36,8 @@ nova.use(createServices({
 const result = await nova.jd.handleJdInsurance({ equipmentValue: '...' })
 ```
 
+平台大会员接入请参阅 [平台大会员服务接入指南](/services/global-vip)。
+
 
 ## 登录态 token 管理
 

package/dist/index.d.mts

@@ -472,7 +472,7 @@ declare function handleDyAuthDebitSignFlowWithRawPayInfo(): Promise<BuildResultR
  * @Author: wutao
  * @Date: 2026-03-30
  * @LastEditors: wutao
- * @LastEditTime: 2026-07-07 15:47:52
+ * @LastEditTime: 2026-09-21 18:22:11
  *
  * 错误码分段规则：
  * - 0: 成功
@@ -482,7 +482,8 @@ declare function handleDyAuthDebitSignFlowWithRawPayInfo(): Promise<BuildResultR
  * - 2200-2999: 预留其他京东业务
  * - 3000-3099: 抖音支付业务
  * - 3000-3999: 预留其他抖音业务
- * - 4000+: 预留其他平台业务
+ * - 4000-4099: 平台大会员业务
+ * - 4100+: 预留其他平台业务
  *
  * 命名规范：<业务模块>__<具体场景>
  * 示例：JD_CASH_LOAN__RTA_FAILED
@@ -619,13 +620,50 @@ declare enum DyErrorCode {
  * 抖音业务错误信息映射
  */
 declare const DyErrorMessage: Record<number, string>;
+/**
+ * 平台大会员业务错误码枚举
+ */
+declare enum GlobalVipErrorCode {
+    /** 缺少设备编号 */
+    GLOBAL_VIP__MISSING_EQUIPMENT_VALUE = 4001,
+    /** 缺少设备类型 */
+    GLOBAL_VIP__MISSING_EQUIPMENT_TYPE = 4002,
+    /** 无效的客户端类型 */
+    GLOBAL_VIP__INVALID_CLIENT_TYPE = 4003,
+    /** 入口资格查询失败 */
+    GLOBAL_VIP__ENTRANCE_CHECK_FAILED = 4004,
+    /** 未获取到卡类型 */
+    GLOBAL_VIP__MISSING_SUBSCRIBE_TYPE = 4005,
+    /** 订阅配置查询失败 */
+    GLOBAL_VIP__CONFIG_FAILED = 4006,
+    /** 订阅配置无效 */
+    GLOBAL_VIP__INVALID_CONFIG = 4007,
+    /** 会员状态查询失败 */
+    GLOBAL_VIP__STATE_QUERY_FAILED = 4008,
+    /** 用户已开通会员 */
+    GLOBAL_VIP__ALREADY_ACTIVE = 4009,
+    /** 签约请求失败 */
+    GLOBAL_VIP__SIGN_FAILED = 4010,
+    /** 签约结果无效 */
+    GLOBAL_VIP__INVALID_SIGN_RESULT = 4011,
+    /** 权益查询失败 */
+    GLOBAL_VIP__BENEFIT_QUERY_FAILED = 4012,
+    /** 曝光记录失败 */
+    GLOBAL_VIP__EXPOSURE_FAILED = 4013,
+    /** 抖音优惠资格查询失败 */
+    GLOBAL_VIP__DISCOUNT_CHECK_FAILED = 4014,
+    /** 签约结果轮询失败 */
+    GLOBAL_VIP__POLL_FAILED = 4015
+}
+/** 平台大会员业务错误信息映射 */
+declare const GlobalVipErrorMessage: Record<GlobalVipErrorCode, string>;
 
 /**
  * @Description: 广告配置接口类型定义
  * @Author: wutao
  * @Date: 2026-04-21
  * @LastEditors: wutao
- * @LastEditTime: 2026-09-14 17:19:39
+ * @LastEditTime: 2026-09-23 10:24:19
  */
 /**
  * 展示广告类型
@@ -817,7 +855,7 @@ interface AdvertConfigItem {
 }
 /** 产品 UI 配置展示模式 */
 type ProductConfigDisplayMode = 'banner' | 'popup' | 'half_screen' | 'mask';
-/** 产品 UI 配置接入系统编码 */
+/** 产品 UI 配置接入系统编码（预留） */
 type ProductConfigSystemCode = 'lyy' | 'third';
 /** 产品 UI 配置动作 */
 interface ProductConfigAction {
@@ -851,6 +889,7 @@ interface ProductConfigApiData {
     id: number | string;
     placementId?: string;
     productCode?: string;
+    /** 预留系统编码，不参与配置有效性判断 */
     systemCode?: ProductConfigSystemCode;
     providerCode?: string;
     channelCode?: string;
@@ -945,7 +984,7 @@ declare function getDisplayAdConfig(options: GetDisplayAdOptions): Promise<Build
  * @Author wutao
  * @Date 2026-09-09
  * @LastEditors wutao
- * @LastEditTime 2026-09-14 17:19:39
+ * @LastEditTime 2026-09-23 10:24:19
  */
 /** 产品投放位展示形态 */
 type ProductDisplayMode = 'banner' | 'popup' | 'half_screen';
@@ -975,7 +1014,6 @@ interface ProductPlacementAction {
     businessCode?: string;
     appId?: string;
     path?: string;
-    url?: string;
     params: Record<string, string | number | boolean>;
 }
 /** 标准化产品投放位配置 */
@@ -987,7 +1025,8 @@ interface ProductPlacementConfig {
     placementId: string;
     /** 接口返回的内部产品编码 */
     productCode?: string;
-    systemType: ProductSystemType;
+    /** 预留系统类型，仅在接口返回可识别的 systemCode 时提供 */
+    systemType?: ProductSystemType;
     providerCode?: string;
     channelCode?: string;
     /** 接口返回的内部场景编码 */
@@ -1016,7 +1055,7 @@ interface ProductPlacementResult {
  * @Author wutao
  * @Date 2026-09-09
  * @LastEditors wutao
- * @LastEditTime 2026-09-15 12:02:24
+ * @LastEditTime 2026-09-23 10:24:19
  */
 
 /**
@@ -1034,4 +1073,183 @@ declare function normalizeProductConfig(productConfig: ProductConfigApiData | nu
  */
 declare function getProductConfig(options: GetProductConfigOptions): Promise<BuildResultReturn<ProductPlacementResult>>;
 
-export { type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, type GetProductConfigOptions, type HandleDyAuthDebitSignFlowResult, type HandleDyJsapiPayFlowParams, type HandleDyJsapiPayFlowResult, type HandleDyPayCommandFlowParams, type HandleDyPayCommandFlowResult, type HandleDyPayFlowParams, type HandleDyPayFlowResult, JdErrorCode, JdErrorMessage, type JdInsuranceExternalOptions, type JdInsuranceOptions, type JdInsuranceResult, type JdjrCashLoanExternalOptions, type JdjrCashLoanOptions, type ProductDisplayMode, type ProductPlacementAction, type ProductPlacementActionType, type ProductPlacementConfig, type ProductPlacementCreative, type ProductPlacementPanelStyle, type ProductPlacementResult, type ProductSystemType, type ServicesOptions, createServices, getDisplayAdConfig, getDyPayRtaData, getProductConfig, handleDyAuthDebitSignFlow, handleDyAuthDebitSignFlowWithRawPayInfo, handleDyJsapiPayFlow, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData, normalizeProductConfig };
+/**
+ * @Description: 平台大会员 API 类型定义
+ * @Author: wutao
+ * @Date: 2026-09-21
+ * @LastEditors: wutao
+ * @LastEditTime: 2026-09-22 16:02:56
+ */
+
+/** 平台大会员卡等级 */
+type GlobalVipSubscribeType = 'silver' | 'gold' | 'black' | 'diamond';
+/** 平台大会员签约渠道 */
+type GlobalVipChannel = 'OfficialYq' | 'WxOfficial' | 'dyNpp' | 'DySgp';
+/**
+ * 发起签约的客户端类型
+ * - `wechat`：微信 H5
+ * - `wxMini`：微信小程序
+ * - `aliMini`：支付宝小程序
+ * - `aliPay`：支付宝 H5
+ */
+type GlobalVipClientType = 'aliMini' | 'aliPay' | 'wxMini' | 'wechat';
+/** 自动扣费类型 */
+type GlobalVipDebitType = 'alipay' | 'aliPay' | 'wechat';
+
+/**
+ * @Description: 平台大会员服务类型定义
+ * @Author: wutao
+ * @Date: 2026-09-21
+ * @LastEditors: wutao
+ * @LastEditTime: 2026-09-23 18:05:01
+ */
+
+/** 当前操作系统 */
+type GlobalVipOs = 'ios' | 'android' | 'other';
+/** 平台大会员业务入口 */
+type GlobalVipSource = 'homePopup' | 'homeBanner' | 'virtualPosition' | 'shopCartBottom' | 'packageCell' | string;
+/** 宿主可展示的平台大会员入口 */
+interface GlobalVipEntrances {
+    window: boolean;
+    banner: boolean;
+    package: boolean;
+    cart: boolean;
+}
+/** 平台大会员签约配置 */
+interface GlobalVipSubscribeConfig {
+    subscribeType: GlobalVipSubscribeType;
+    channelCode: GlobalVipChannel;
+    payAmount: number;
+    firstPayAmount: number;
+    renewAmount: number;
+    effectiveDate: number;
+    tryDay: number;
+    totalBenefitAmount: number;
+    firstBenefitAmount: number;
+    closeButtonPopSecond: number;
+    /** 是否为抖音新用户；抖音新用户可享受新客优惠。 */
+    canEnjoyDiscount: boolean;
+}
+/** 平台大会员完整入口上下文 */
+interface GlobalVipEntryContext {
+    canPurchase: boolean;
+    active: boolean;
+    memberState: number | null;
+    subscribeType: GlobalVipSubscribeType | null;
+    entrances: GlobalVipEntrances;
+    config: GlobalVipSubscribeConfig | null;
+}
+/** 归一化后的平台大会员状态 */
+type GlobalVipMemberStatus = 'inactive' | 'active' | 'refunded' | 'trial' | 'unknown';
+/** 平台大会员订阅状态 */
+interface GlobalVipSubscribeState {
+    /** 原始订阅状态：`1` 已扣费，`2` 已退款，`3` 体验期。 */
+    state: number | null;
+    /** 是否已具备有效会员权益；已扣费和体验期均为 `true`。 */
+    active: boolean;
+    status: GlobalVipMemberStatus;
+}
+/** 平台大会员签约后交由宿主执行的标准动作 */
+type GlobalVipSubscribeAction = {
+    type: 'already_active';
+    state: GlobalVipSubscribeState;
+} | {
+    type: 'command';
+    channel: 'dyNpp' | 'DySgp';
+    command: string;
+    orderNo?: string;
+} | {
+    type: 'mini_program';
+    channel: 'OfficialYq' | 'WxOfficial';
+    appId: string;
+    path: string;
+    extraData?: Record<string, unknown>;
+    orderNo?: string;
+} | {
+    type: 'h5';
+    channel: GlobalVipChannel;
+    url: string;
+    orderNo?: string;
+} | {
+    type: 'douyin_transfer';
+    channel: 'dyNpp' | 'DySgp';
+    payUrl: string;
+    transferUrl: string;
+    shouldExitMiniProgram: boolean;
+    orderNo?: string;
+};
+/** 获取入口上下文参数 */
+interface GetGlobalVipEntryContextOptions {
+    equipmentValue: string;
+    equipmentTypeValue: string;
+    /** 客户端类型：`wechat` 为微信 H5，`wxMini` 为微信小程序，`aliMini` 为支付宝小程序。 */
+    clientType: GlobalVipClientType;
+    phone?: string;
+}
+/** 查询权益到账状态参数 */
+interface CheckGlobalVipBenefitOptions {
+    equipmentValue: string;
+}
+/** 平台大会员权益到账状态 */
+interface GlobalVipBenefitResult {
+    received: boolean;
+    rawData?: unknown;
+}
+/** 发起平台大会员签约流程参数 */
+interface HandleGlobalVipSubscribeOptions {
+    equipmentValue: string;
+    equipmentTypeValue: string;
+    phone?: string;
+    /** 客户端类型：`wechat` 为微信 H5，`wxMini` 为微信小程序，`aliMini` 为支付宝小程序。 */
+    clientType: GlobalVipClientType;
+    debitType: GlobalVipDebitType;
+    os: GlobalVipOs;
+    source?: GlobalVipSource;
+    returnUrl: string;
+    config?: GlobalVipSubscribeConfig;
+    douyinTransferUrl?: string;
+    fromTransferPage?: boolean;
+    /** 微信签约所需 AppId；微信 H5 未传时按当前 services 环境使用内置 AppId。 */
+    wechatAppId?: string;
+}
+/** 签约回跳轮询参数 */
+interface PollGlobalVipSubscribeResultOptions {
+    equipmentValue: string;
+    maxAttempts?: number;
+    interval?: number;
+    checkBenefit?: boolean;
+}
+/** 签约回跳轮询结果 */
+interface GlobalVipSubscribeResult {
+    active: boolean;
+    benefitReceived: boolean;
+    memberState: number | null;
+    attempts: number;
+}
+/** 挂载到 nova.globalVip 的公开服务契约 */
+interface GlobalVipService {
+    getEntryContext(options: GetGlobalVipEntryContextOptions): Promise<BuildResultReturn<GlobalVipEntryContext>>;
+    getSubscribeState(): Promise<BuildResultReturn<GlobalVipSubscribeState>>;
+    checkBenefit(options: CheckGlobalVipBenefitOptions): Promise<BuildResultReturn<GlobalVipBenefitResult>>;
+    recordExposure(): Promise<BuildResultReturn<boolean>>;
+    handleSubscribeFlow(options: HandleGlobalVipSubscribeOptions): Promise<BuildResultReturn<GlobalVipSubscribeAction>>;
+    pollSubscribeResult(options: PollGlobalVipSubscribeResultOptions): Promise<BuildResultReturn<GlobalVipSubscribeResult>>;
+    clearCache(): void;
+}
+
+/** 查询并归一化当前用户的平台大会员状态。 */
+declare function getSubscribeState(): Promise<BuildResultReturn<GlobalVipSubscribeState>>;
+/** 一次性获取入口资格、会员状态、入口开关与订阅配置。 */
+declare function getEntryContext(options: GetGlobalVipEntryContextOptions): Promise<BuildResultReturn<GlobalVipEntryContext>>;
+/** 查询平台大会员权益是否已到账。 */
+declare function checkBenefit(options: CheckGlobalVipBenefitOptions): Promise<BuildResultReturn<GlobalVipBenefitResult>>;
+/** 记录一次后端平台大会员曝光。 */
+declare function recordExposure(): Promise<BuildResultReturn<boolean>>;
+/** 创建签约并将渠道响应归一化为宿主动作。 */
+declare function handleSubscribeFlow(options: HandleGlobalVipSubscribeOptions): Promise<BuildResultReturn<GlobalVipSubscribeAction>>;
+/** 签约回跳后轮询会员状态与权益到账状态。 */
+declare function pollSubscribeResult(options: PollGlobalVipSubscribeResultOptions): Promise<BuildResultReturn<GlobalVipSubscribeResult>>;
+/** 清除平台大会员入口与订阅配置缓存。 */
+declare function clearCache(): void;
+
+export { type CheckGlobalVipBenefitOptions, type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, type GetGlobalVipEntryContextOptions, type GetProductConfigOptions, type GlobalVipBenefitResult, type GlobalVipChannel, type GlobalVipClientType, type GlobalVipDebitType, type GlobalVipEntrances, type GlobalVipEntryContext, GlobalVipErrorCode, GlobalVipErrorMessage, type GlobalVipMemberStatus, type GlobalVipOs, type GlobalVipService, type GlobalVipSource, type GlobalVipSubscribeAction, type GlobalVipSubscribeConfig, type GlobalVipSubscribeResult, type GlobalVipSubscribeState, type GlobalVipSubscribeType, type HandleDyAuthDebitSignFlowResult, type HandleDyJsapiPayFlowParams, type HandleDyJsapiPayFlowResult, type HandleDyPayCommandFlowParams, type HandleDyPayCommandFlowResult, type HandleDyPayFlowParams, type HandleDyPayFlowResult, type HandleGlobalVipSubscribeOptions, JdErrorCode, JdErrorMessage, type JdInsuranceExternalOptions, type JdInsuranceOptions, type JdInsuranceResult, type JdjrCashLoanExternalOptions, type JdjrCashLoanOptions, type PollGlobalVipSubscribeResultOptions, type ProductDisplayMode, type ProductPlacementAction, type ProductPlacementActionType, type ProductPlacementConfig, type ProductPlacementCreative, type ProductPlacementPanelStyle, type ProductPlacementResult, type ProductSystemType, type ServicesOptions, checkBenefit, clearCache, createServices, getDisplayAdConfig, getDyPayRtaData, getEntryContext, getProductConfig, getSubscribeState, handleDyAuthDebitSignFlow, handleDyAuthDebitSignFlowWithRawPayInfo, handleDyJsapiPayFlow, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, handleSubscribeFlow, normalizeDisplayAdData, normalizeProductConfig, pollSubscribeResult, recordExposure };

package/dist/index.d.ts

@@ -472,7 +472,7 @@ declare function handleDyAuthDebitSignFlowWithRawPayInfo(): Promise<BuildResultR
  * @Author: wutao
  * @Date: 2026-03-30
  * @LastEditors: wutao
- * @LastEditTime: 2026-07-07 15:47:52
+ * @LastEditTime: 2026-09-21 18:22:11
  *
  * 错误码分段规则：
  * - 0: 成功
@@ -482,7 +482,8 @@ declare function handleDyAuthDebitSignFlowWithRawPayInfo(): Promise<BuildResultR
  * - 2200-2999: 预留其他京东业务
  * - 3000-3099: 抖音支付业务
  * - 3000-3999: 预留其他抖音业务
- * - 4000+: 预留其他平台业务
+ * - 4000-4099: 平台大会员业务
+ * - 4100+: 预留其他平台业务
  *
  * 命名规范：<业务模块>__<具体场景>
  * 示例：JD_CASH_LOAN__RTA_FAILED
@@ -619,13 +620,50 @@ declare enum DyErrorCode {
  * 抖音业务错误信息映射
  */
 declare const DyErrorMessage: Record<number, string>;
+/**
+ * 平台大会员业务错误码枚举
+ */
+declare enum GlobalVipErrorCode {
+    /** 缺少设备编号 */
+    GLOBAL_VIP__MISSING_EQUIPMENT_VALUE = 4001,
+    /** 缺少设备类型 */
+    GLOBAL_VIP__MISSING_EQUIPMENT_TYPE = 4002,
+    /** 无效的客户端类型 */
+    GLOBAL_VIP__INVALID_CLIENT_TYPE = 4003,
+    /** 入口资格查询失败 */
+    GLOBAL_VIP__ENTRANCE_CHECK_FAILED = 4004,
+    /** 未获取到卡类型 */
+    GLOBAL_VIP__MISSING_SUBSCRIBE_TYPE = 4005,
+    /** 订阅配置查询失败 */
+    GLOBAL_VIP__CONFIG_FAILED = 4006,
+    /** 订阅配置无效 */
+    GLOBAL_VIP__INVALID_CONFIG = 4007,
+    /** 会员状态查询失败 */
+    GLOBAL_VIP__STATE_QUERY_FAILED = 4008,
+    /** 用户已开通会员 */
+    GLOBAL_VIP__ALREADY_ACTIVE = 4009,
+    /** 签约请求失败 */
+    GLOBAL_VIP__SIGN_FAILED = 4010,
+    /** 签约结果无效 */
+    GLOBAL_VIP__INVALID_SIGN_RESULT = 4011,
+    /** 权益查询失败 */
+    GLOBAL_VIP__BENEFIT_QUERY_FAILED = 4012,
+    /** 曝光记录失败 */
+    GLOBAL_VIP__EXPOSURE_FAILED = 4013,
+    /** 抖音优惠资格查询失败 */
+    GLOBAL_VIP__DISCOUNT_CHECK_FAILED = 4014,
+    /** 签约结果轮询失败 */
+    GLOBAL_VIP__POLL_FAILED = 4015
+}
+/** 平台大会员业务错误信息映射 */
+declare const GlobalVipErrorMessage: Record<GlobalVipErrorCode, string>;
 
 /**
  * @Description: 广告配置接口类型定义
  * @Author: wutao
  * @Date: 2026-04-21
  * @LastEditors: wutao
- * @LastEditTime: 2026-09-14 17:19:39
+ * @LastEditTime: 2026-09-23 10:24:19
  */
 /**
  * 展示广告类型
@@ -817,7 +855,7 @@ interface AdvertConfigItem {
 }
 /** 产品 UI 配置展示模式 */
 type ProductConfigDisplayMode = 'banner' | 'popup' | 'half_screen' | 'mask';
-/** 产品 UI 配置接入系统编码 */
+/** 产品 UI 配置接入系统编码（预留） */
 type ProductConfigSystemCode = 'lyy' | 'third';
 /** 产品 UI 配置动作 */
 interface ProductConfigAction {
@@ -851,6 +889,7 @@ interface ProductConfigApiData {
     id: number | string;
     placementId?: string;
     productCode?: string;
+    /** 预留系统编码，不参与配置有效性判断 */
     systemCode?: ProductConfigSystemCode;
     providerCode?: string;
     channelCode?: string;
@@ -945,7 +984,7 @@ declare function getDisplayAdConfig(options: GetDisplayAdOptions): Promise<Build
  * @Author wutao
  * @Date 2026-09-09
  * @LastEditors wutao
- * @LastEditTime 2026-09-14 17:19:39
+ * @LastEditTime 2026-09-23 10:24:19
  */
 /** 产品投放位展示形态 */
 type ProductDisplayMode = 'banner' | 'popup' | 'half_screen';
@@ -975,7 +1014,6 @@ interface ProductPlacementAction {
     businessCode?: string;
     appId?: string;
     path?: string;
-    url?: string;
     params: Record<string, string | number | boolean>;
 }
 /** 标准化产品投放位配置 */
@@ -987,7 +1025,8 @@ interface ProductPlacementConfig {
     placementId: string;
     /** 接口返回的内部产品编码 */
     productCode?: string;
-    systemType: ProductSystemType;
+    /** 预留系统类型，仅在接口返回可识别的 systemCode 时提供 */
+    systemType?: ProductSystemType;
     providerCode?: string;
     channelCode?: string;
     /** 接口返回的内部场景编码 */
@@ -1016,7 +1055,7 @@ interface ProductPlacementResult {
  * @Author wutao
  * @Date 2026-09-09
  * @LastEditors wutao
- * @LastEditTime 2026-09-15 12:02:24
+ * @LastEditTime 2026-09-23 10:24:19
  */
 
 /**
@@ -1034,4 +1073,183 @@ declare function normalizeProductConfig(productConfig: ProductConfigApiData | nu
  */
 declare function getProductConfig(options: GetProductConfigOptions): Promise<BuildResultReturn<ProductPlacementResult>>;
 
-export { type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, type GetProductConfigOptions, type HandleDyAuthDebitSignFlowResult, type HandleDyJsapiPayFlowParams, type HandleDyJsapiPayFlowResult, type HandleDyPayCommandFlowParams, type HandleDyPayCommandFlowResult, type HandleDyPayFlowParams, type HandleDyPayFlowResult, JdErrorCode, JdErrorMessage, type JdInsuranceExternalOptions, type JdInsuranceOptions, type JdInsuranceResult, type JdjrCashLoanExternalOptions, type JdjrCashLoanOptions, type ProductDisplayMode, type ProductPlacementAction, type ProductPlacementActionType, type ProductPlacementConfig, type ProductPlacementCreative, type ProductPlacementPanelStyle, type ProductPlacementResult, type ProductSystemType, type ServicesOptions, createServices, getDisplayAdConfig, getDyPayRtaData, getProductConfig, handleDyAuthDebitSignFlow, handleDyAuthDebitSignFlowWithRawPayInfo, handleDyJsapiPayFlow, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData, normalizeProductConfig };
+/**
+ * @Description: 平台大会员 API 类型定义
+ * @Author: wutao
+ * @Date: 2026-09-21
+ * @LastEditors: wutao
+ * @LastEditTime: 2026-09-22 16:02:56
+ */
+
+/** 平台大会员卡等级 */
+type GlobalVipSubscribeType = 'silver' | 'gold' | 'black' | 'diamond';
+/** 平台大会员签约渠道 */
+type GlobalVipChannel = 'OfficialYq' | 'WxOfficial' | 'dyNpp' | 'DySgp';
+/**
+ * 发起签约的客户端类型
+ * - `wechat`：微信 H5
+ * - `wxMini`：微信小程序
+ * - `aliMini`：支付宝小程序
+ * - `aliPay`：支付宝 H5
+ */
+type GlobalVipClientType = 'aliMini' | 'aliPay' | 'wxMini' | 'wechat';
+/** 自动扣费类型 */
+type GlobalVipDebitType = 'alipay' | 'aliPay' | 'wechat';
+
+/**
+ * @Description: 平台大会员服务类型定义
+ * @Author: wutao
+ * @Date: 2026-09-21
+ * @LastEditors: wutao
+ * @LastEditTime: 2026-09-23 18:05:01
+ */
+
+/** 当前操作系统 */
+type GlobalVipOs = 'ios' | 'android' | 'other';
+/** 平台大会员业务入口 */
+type GlobalVipSource = 'homePopup' | 'homeBanner' | 'virtualPosition' | 'shopCartBottom' | 'packageCell' | string;
+/** 宿主可展示的平台大会员入口 */
+interface GlobalVipEntrances {
+    window: boolean;
+    banner: boolean;
+    package: boolean;
+    cart: boolean;
+}
+/** 平台大会员签约配置 */
+interface GlobalVipSubscribeConfig {
+    subscribeType: GlobalVipSubscribeType;
+    channelCode: GlobalVipChannel;
+    payAmount: number;
+    firstPayAmount: number;
+    renewAmount: number;
+    effectiveDate: number;
+    tryDay: number;
+    totalBenefitAmount: number;
+    firstBenefitAmount: number;
+    closeButtonPopSecond: number;
+    /** 是否为抖音新用户；抖音新用户可享受新客优惠。 */
+    canEnjoyDiscount: boolean;
+}
+/** 平台大会员完整入口上下文 */
+interface GlobalVipEntryContext {
+    canPurchase: boolean;
+    active: boolean;
+    memberState: number | null;
+    subscribeType: GlobalVipSubscribeType | null;
+    entrances: GlobalVipEntrances;
+    config: GlobalVipSubscribeConfig | null;
+}
+/** 归一化后的平台大会员状态 */
+type GlobalVipMemberStatus = 'inactive' | 'active' | 'refunded' | 'trial' | 'unknown';
+/** 平台大会员订阅状态 */
+interface GlobalVipSubscribeState {
+    /** 原始订阅状态：`1` 已扣费，`2` 已退款，`3` 体验期。 */
+    state: number | null;
+    /** 是否已具备有效会员权益；已扣费和体验期均为 `true`。 */
+    active: boolean;
+    status: GlobalVipMemberStatus;
+}
+/** 平台大会员签约后交由宿主执行的标准动作 */
+type GlobalVipSubscribeAction = {
+    type: 'already_active';
+    state: GlobalVipSubscribeState;
+} | {
+    type: 'command';
+    channel: 'dyNpp' | 'DySgp';
+    command: string;
+    orderNo?: string;
+} | {
+    type: 'mini_program';
+    channel: 'OfficialYq' | 'WxOfficial';
+    appId: string;
+    path: string;
+    extraData?: Record<string, unknown>;
+    orderNo?: string;
+} | {
+    type: 'h5';
+    channel: GlobalVipChannel;
+    url: string;
+    orderNo?: string;
+} | {
+    type: 'douyin_transfer';
+    channel: 'dyNpp' | 'DySgp';
+    payUrl: string;
+    transferUrl: string;
+    shouldExitMiniProgram: boolean;
+    orderNo?: string;
+};
+/** 获取入口上下文参数 */
+interface GetGlobalVipEntryContextOptions {
+    equipmentValue: string;
+    equipmentTypeValue: string;
+    /** 客户端类型：`wechat` 为微信 H5，`wxMini` 为微信小程序，`aliMini` 为支付宝小程序。 */
+    clientType: GlobalVipClientType;
+    phone?: string;
+}
+/** 查询权益到账状态参数 */
+interface CheckGlobalVipBenefitOptions {
+    equipmentValue: string;
+}
+/** 平台大会员权益到账状态 */
+interface GlobalVipBenefitResult {
+    received: boolean;
+    rawData?: unknown;
+}
+/** 发起平台大会员签约流程参数 */
+interface HandleGlobalVipSubscribeOptions {
+    equipmentValue: string;
+    equipmentTypeValue: string;
+    phone?: string;
+    /** 客户端类型：`wechat` 为微信 H5，`wxMini` 为微信小程序，`aliMini` 为支付宝小程序。 */
+    clientType: GlobalVipClientType;
+    debitType: GlobalVipDebitType;
+    os: GlobalVipOs;
+    source?: GlobalVipSource;
+    returnUrl: string;
+    config?: GlobalVipSubscribeConfig;
+    douyinTransferUrl?: string;
+    fromTransferPage?: boolean;
+    /** 微信签约所需 AppId；微信 H5 未传时按当前 services 环境使用内置 AppId。 */
+    wechatAppId?: string;
+}
+/** 签约回跳轮询参数 */
+interface PollGlobalVipSubscribeResultOptions {
+    equipmentValue: string;
+    maxAttempts?: number;
+    interval?: number;
+    checkBenefit?: boolean;
+}
+/** 签约回跳轮询结果 */
+interface GlobalVipSubscribeResult {
+    active: boolean;
+    benefitReceived: boolean;
+    memberState: number | null;
+    attempts: number;
+}
+/** 挂载到 nova.globalVip 的公开服务契约 */
+interface GlobalVipService {
+    getEntryContext(options: GetGlobalVipEntryContextOptions): Promise<BuildResultReturn<GlobalVipEntryContext>>;
+    getSubscribeState(): Promise<BuildResultReturn<GlobalVipSubscribeState>>;
+    checkBenefit(options: CheckGlobalVipBenefitOptions): Promise<BuildResultReturn<GlobalVipBenefitResult>>;
+    recordExposure(): Promise<BuildResultReturn<boolean>>;
+    handleSubscribeFlow(options: HandleGlobalVipSubscribeOptions): Promise<BuildResultReturn<GlobalVipSubscribeAction>>;
+    pollSubscribeResult(options: PollGlobalVipSubscribeResultOptions): Promise<BuildResultReturn<GlobalVipSubscribeResult>>;
+    clearCache(): void;
+}
+
+/** 查询并归一化当前用户的平台大会员状态。 */
+declare function getSubscribeState(): Promise<BuildResultReturn<GlobalVipSubscribeState>>;
+/** 一次性获取入口资格、会员状态、入口开关与订阅配置。 */
+declare function getEntryContext(options: GetGlobalVipEntryContextOptions): Promise<BuildResultReturn<GlobalVipEntryContext>>;
+/** 查询平台大会员权益是否已到账。 */
+declare function checkBenefit(options: CheckGlobalVipBenefitOptions): Promise<BuildResultReturn<GlobalVipBenefitResult>>;
+/** 记录一次后端平台大会员曝光。 */
+declare function recordExposure(): Promise<BuildResultReturn<boolean>>;
+/** 创建签约并将渠道响应归一化为宿主动作。 */
+declare function handleSubscribeFlow(options: HandleGlobalVipSubscribeOptions): Promise<BuildResultReturn<GlobalVipSubscribeAction>>;
+/** 签约回跳后轮询会员状态与权益到账状态。 */
+declare function pollSubscribeResult(options: PollGlobalVipSubscribeResultOptions): Promise<BuildResultReturn<GlobalVipSubscribeResult>>;
+/** 清除平台大会员入口与订阅配置缓存。 */
+declare function clearCache(): void;
+
+export { type CheckGlobalVipBenefitOptions, type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, type GetGlobalVipEntryContextOptions, type GetProductConfigOptions, type GlobalVipBenefitResult, type GlobalVipChannel, type GlobalVipClientType, type GlobalVipDebitType, type GlobalVipEntrances, type GlobalVipEntryContext, GlobalVipErrorCode, GlobalVipErrorMessage, type GlobalVipMemberStatus, type GlobalVipOs, type GlobalVipService, type GlobalVipSource, type GlobalVipSubscribeAction, type GlobalVipSubscribeConfig, type GlobalVipSubscribeResult, type GlobalVipSubscribeState, type GlobalVipSubscribeType, type HandleDyAuthDebitSignFlowResult, type HandleDyJsapiPayFlowParams, type HandleDyJsapiPayFlowResult, type HandleDyPayCommandFlowParams, type HandleDyPayCommandFlowResult, type HandleDyPayFlowParams, type HandleDyPayFlowResult, type HandleGlobalVipSubscribeOptions, JdErrorCode, JdErrorMessage, type JdInsuranceExternalOptions, type JdInsuranceOptions, type JdInsuranceResult, type JdjrCashLoanExternalOptions, type JdjrCashLoanOptions, type PollGlobalVipSubscribeResultOptions, type ProductDisplayMode, type ProductPlacementAction, type ProductPlacementActionType, type ProductPlacementConfig, type ProductPlacementCreative, type ProductPlacementPanelStyle, type ProductPlacementResult, type ProductSystemType, type ServicesOptions, checkBenefit, clearCache, createServices, getDisplayAdConfig, getDyPayRtaData, getEntryContext, getProductConfig, getSubscribeState, handleDyAuthDebitSignFlow, handleDyAuthDebitSignFlowWithRawPayInfo, handleDyJsapiPayFlow, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, handleSubscribeFlow, normalizeDisplayAdData, normalizeProductConfig, pollSubscribeResult, recordExposure };