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

package/dist/index.d.mts

@@ -158,15 +158,13 @@ declare function handleJdjrCashLoanExt(options: JdjrCashLoanExternalOptions): Pr
  * @Author: wutao
  * @Date: 2026-03-26
  * @LastEditors: wutao
- * @LastEditTime: 2026-03-26
+ * @LastEditTime: 2026-09-14 17:19:39
  */
 
 /** 京东保险服务选项接口 */
 interface JdInsuranceOptions {
     /** 设备ID */
-    equipmentId: string;
-    /** 操作系统 */
-    os?: string;
+    equipmentValue: string;
     /** 手机号 */
     phone?: string;
     /** 入口标识 */
@@ -205,11 +203,7 @@ interface JdInsuranceResult extends JumpConfig {
  * @returns {string} [return.data.appId] - 小程序appId（仅mini_program模式）
  * @returns {string} [return.data.path] - 小程序路径（仅mini_program模式）
  */
-declare function handleJdInsurance(options: {
-    equipmentValue: string;
-    phone?: string;
-    entrance?: string;
-}): Promise<BuildResultReturn>;
+declare function handleJdInsurance(options: JdInsuranceOptions): Promise<BuildResultReturn>;
 /**
  * 处理外部京东保险服务（外部对接版）
  * @param {object} businessParams - 业务参数
@@ -631,7 +625,7 @@ declare const DyErrorMessage: Record<number, string>;
  * @Author: wutao
  * @Date: 2026-04-21
  * @LastEditors: wutao
- * @LastEditTime: 2026-09-03 18:00:19
+ * @LastEditTime: 2026-09-14 17:19:39
  */
 /**
  * 展示广告类型
@@ -821,6 +815,56 @@ interface AdvertConfigItem {
     /** 扩展字段 */
     [key: string]: any;
 }
+/** 产品 UI 配置展示模式 */
+type ProductConfigDisplayMode = 'banner' | 'popup' | 'half_screen' | 'mask';
+/** 产品 UI 配置接入系统编码 */
+type ProductConfigSystemCode = 'lyy' | 'third';
+/** 产品 UI 配置动作 */
+interface ProductConfigAction {
+    type?: 'business' | 'mini_program' | 'internal' | 'web' | 'api' | 'none';
+    businessCode?: string;
+    appId?: string;
+    path?: string;
+    url?: string;
+    params?: Record<string, any>;
+    [key: string]: any;
+}
+/** 产品 UI 展示配置 */
+interface ProductConfigDisplayConfig {
+    image?: string;
+    bannerImageUrl?: string;
+    popupImageUrl?: string;
+    title?: string;
+    description?: string;
+    buttonText?: string;
+    badgeText?: string;
+    skinCode?: string;
+    heightRatio?: number;
+    closeable?: boolean;
+    maskClosable?: boolean;
+    showAgreement?: boolean;
+    action?: ProductConfigAction;
+    [key: string]: any;
+}
+/** 按 ID 查询返回的产品 UI 配置 */
+interface ProductConfigApiData {
+    id: number | string;
+    placementId?: string;
+    productCode?: string;
+    systemCode?: ProductConfigSystemCode;
+    providerCode?: string;
+    channelCode?: string;
+    sceneCode?: string;
+    displayMode?: ProductConfigDisplayMode;
+    displayConfig?: ProductConfigDisplayConfig;
+    status?: 0 | 1;
+    isDeleted?: 0 | 1;
+    version?: number;
+    creator?: string;
+    updater?: string;
+    createTime?: string;
+    updateTime?: string;
+}
 
 /**
  * @Description: 展示广告服务类型定义
@@ -896,4 +940,98 @@ declare function normalizeDisplayAdData(advertConfigs: AdvertConfigItem[], fallb
  */
 declare function getDisplayAdConfig(options: GetDisplayAdOptions): Promise<BuildResultReturn<DisplayAdResult>>;
 
-export { type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, 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 ServicesOptions, createServices, getDisplayAdConfig, getDyPayRtaData, handleDyAuthDebitSignFlow, handleDyAuthDebitSignFlowWithRawPayInfo, handleDyJsapiPayFlow, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData };
+/**
+ * @Description 产品投放位服务类型定义
+ * @Author wutao
+ * @Date 2026-09-09
+ * @LastEditors wutao
+ * @LastEditTime 2026-09-14 17:19:39
+ */
+/** 产品投放位展示形态 */
+type ProductDisplayMode = 'banner' | 'popup' | 'half_screen';
+/** 产品业务系统类型 */
+type ProductSystemType = 'lyy' | 'third_party';
+/** 产品投放位动作类型 */
+type ProductPlacementActionType = 'business' | 'mini_program' | 'internal' | 'web' | 'api' | 'none';
+/** 产品投放位素材 */
+interface ProductPlacementCreative {
+    imageUrl?: string;
+    title?: string;
+    description?: string;
+    buttonText?: string;
+    badgeText?: string;
+}
+/** 产品投放位面板样式 */
+interface ProductPlacementPanelStyle {
+    skinCode: 'default' | 'vip_gold' | 'insurance_blue';
+    heightRatio: number;
+    closeable: boolean;
+    maskClosable: boolean;
+    showAgreement: boolean;
+}
+/** 产品投放位业务动作 */
+interface ProductPlacementAction {
+    type: ProductPlacementActionType;
+    businessCode?: string;
+    appId?: string;
+    path?: string;
+    url?: string;
+    params: Record<string, string | number | boolean>;
+}
+/** 标准化产品投放位配置 */
+interface ProductPlacementConfig {
+    schemaVersion: number;
+    /** 组件查询使用的广告 ID */
+    adId: number | string;
+    configId: string | number;
+    placementId: string;
+    /** 接口返回的内部产品编码 */
+    productCode?: string;
+    systemType: ProductSystemType;
+    providerCode?: string;
+    channelCode?: string;
+    /** 接口返回的内部场景编码 */
+    sceneCode?: string;
+    displayMode: ProductDisplayMode;
+    creative: ProductPlacementCreative;
+    panelStyle: ProductPlacementPanelStyle;
+    action: ProductPlacementAction;
+}
+/** 按广告 ID 获取产品 UI 配置参数 */
+interface GetProductConfigOptions {
+    /** 产品 UI 配置主键，也就是组件传入的广告 ID */
+    id: number | string;
+}
+/** 产品投放位配置服务结果 */
+interface ProductPlacementResult {
+    show: boolean;
+    id: number | string;
+    placementId?: string;
+    config: ProductPlacementConfig | null;
+    reason: 'matched' | 'noConfig';
+}
+
+/**
+ * @Description 按广告 ID 返回的产品 UI 配置标准化处理
+ * @Author wutao
+ * @Date 2026-09-09
+ * @LastEditors wutao
+ * @LastEditTime 2026-09-15 12:02:24
+ */
+
+/**
+ * 把按广告 ID 查询到的产品配置转换为 UI 标准配置
+ * @param productConfig 接口返回的产品 UI 配置
+ * @param expectedId 请求的广告 ID，用于防止响应错配
+ * @returns 标准化配置；不可展示或配置非法时返回 null
+ */
+declare function normalizeProductConfig(productConfig: ProductConfigApiData | null | undefined, expectedId: number | string): ProductPlacementConfig | null;
+
+/**
+ * 按广告 ID 获取并标准化产品 UI 配置
+ * @param options 查询参数
+ * @returns 标准化产品 UI 配置结果
+ */
+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 };

package/dist/index.d.ts

@@ -158,15 +158,13 @@ declare function handleJdjrCashLoanExt(options: JdjrCashLoanExternalOptions): Pr
  * @Author: wutao
  * @Date: 2026-03-26
  * @LastEditors: wutao
- * @LastEditTime: 2026-03-26
+ * @LastEditTime: 2026-09-14 17:19:39
  */
 
 /** 京东保险服务选项接口 */
 interface JdInsuranceOptions {
     /** 设备ID */
-    equipmentId: string;
-    /** 操作系统 */
-    os?: string;
+    equipmentValue: string;
     /** 手机号 */
     phone?: string;
     /** 入口标识 */
@@ -205,11 +203,7 @@ interface JdInsuranceResult extends JumpConfig {
  * @returns {string} [return.data.appId] - 小程序appId（仅mini_program模式）
  * @returns {string} [return.data.path] - 小程序路径（仅mini_program模式）
  */
-declare function handleJdInsurance(options: {
-    equipmentValue: string;
-    phone?: string;
-    entrance?: string;
-}): Promise<BuildResultReturn>;
+declare function handleJdInsurance(options: JdInsuranceOptions): Promise<BuildResultReturn>;
 /**
  * 处理外部京东保险服务（外部对接版）
  * @param {object} businessParams - 业务参数
@@ -631,7 +625,7 @@ declare const DyErrorMessage: Record<number, string>;
  * @Author: wutao
  * @Date: 2026-04-21
  * @LastEditors: wutao
- * @LastEditTime: 2026-09-03 18:00:19
+ * @LastEditTime: 2026-09-14 17:19:39
  */
 /**
  * 展示广告类型
@@ -821,6 +815,56 @@ interface AdvertConfigItem {
     /** 扩展字段 */
     [key: string]: any;
 }
+/** 产品 UI 配置展示模式 */
+type ProductConfigDisplayMode = 'banner' | 'popup' | 'half_screen' | 'mask';
+/** 产品 UI 配置接入系统编码 */
+type ProductConfigSystemCode = 'lyy' | 'third';
+/** 产品 UI 配置动作 */
+interface ProductConfigAction {
+    type?: 'business' | 'mini_program' | 'internal' | 'web' | 'api' | 'none';
+    businessCode?: string;
+    appId?: string;
+    path?: string;
+    url?: string;
+    params?: Record<string, any>;
+    [key: string]: any;
+}
+/** 产品 UI 展示配置 */
+interface ProductConfigDisplayConfig {
+    image?: string;
+    bannerImageUrl?: string;
+    popupImageUrl?: string;
+    title?: string;
+    description?: string;
+    buttonText?: string;
+    badgeText?: string;
+    skinCode?: string;
+    heightRatio?: number;
+    closeable?: boolean;
+    maskClosable?: boolean;
+    showAgreement?: boolean;
+    action?: ProductConfigAction;
+    [key: string]: any;
+}
+/** 按 ID 查询返回的产品 UI 配置 */
+interface ProductConfigApiData {
+    id: number | string;
+    placementId?: string;
+    productCode?: string;
+    systemCode?: ProductConfigSystemCode;
+    providerCode?: string;
+    channelCode?: string;
+    sceneCode?: string;
+    displayMode?: ProductConfigDisplayMode;
+    displayConfig?: ProductConfigDisplayConfig;
+    status?: 0 | 1;
+    isDeleted?: 0 | 1;
+    version?: number;
+    creator?: string;
+    updater?: string;
+    createTime?: string;
+    updateTime?: string;
+}
 
 /**
  * @Description: 展示广告服务类型定义
@@ -896,4 +940,98 @@ declare function normalizeDisplayAdData(advertConfigs: AdvertConfigItem[], fallb
  */
 declare function getDisplayAdConfig(options: GetDisplayAdOptions): Promise<BuildResultReturn<DisplayAdResult>>;
 
-export { type DisplayAdResult, DyErrorCode, DyErrorMessage, ENV_TYPE, EXTERNAL_ENV_TYPE, type GetDisplayAdOptions, 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 ServicesOptions, createServices, getDisplayAdConfig, getDyPayRtaData, handleDyAuthDebitSignFlow, handleDyAuthDebitSignFlowWithRawPayInfo, handleDyJsapiPayFlow, handleDyPayCommandFlow, handleDyPayFlow, handleJdInsurance, handleJdInsuranceExt, handleJdjrCashLoanExt, handleJdjrCashLoanFlow, normalizeDisplayAdData };
+/**
+ * @Description 产品投放位服务类型定义
+ * @Author wutao
+ * @Date 2026-09-09
+ * @LastEditors wutao
+ * @LastEditTime 2026-09-14 17:19:39
+ */
+/** 产品投放位展示形态 */
+type ProductDisplayMode = 'banner' | 'popup' | 'half_screen';
+/** 产品业务系统类型 */
+type ProductSystemType = 'lyy' | 'third_party';
+/** 产品投放位动作类型 */
+type ProductPlacementActionType = 'business' | 'mini_program' | 'internal' | 'web' | 'api' | 'none';
+/** 产品投放位素材 */
+interface ProductPlacementCreative {
+    imageUrl?: string;
+    title?: string;
+    description?: string;
+    buttonText?: string;
+    badgeText?: string;
+}
+/** 产品投放位面板样式 */
+interface ProductPlacementPanelStyle {
+    skinCode: 'default' | 'vip_gold' | 'insurance_blue';
+    heightRatio: number;
+    closeable: boolean;
+    maskClosable: boolean;
+    showAgreement: boolean;
+}
+/** 产品投放位业务动作 */
+interface ProductPlacementAction {
+    type: ProductPlacementActionType;
+    businessCode?: string;
+    appId?: string;
+    path?: string;
+    url?: string;
+    params: Record<string, string | number | boolean>;
+}
+/** 标准化产品投放位配置 */
+interface ProductPlacementConfig {
+    schemaVersion: number;
+    /** 组件查询使用的广告 ID */
+    adId: number | string;
+    configId: string | number;
+    placementId: string;
+    /** 接口返回的内部产品编码 */
+    productCode?: string;
+    systemType: ProductSystemType;
+    providerCode?: string;
+    channelCode?: string;
+    /** 接口返回的内部场景编码 */
+    sceneCode?: string;
+    displayMode: ProductDisplayMode;
+    creative: ProductPlacementCreative;
+    panelStyle: ProductPlacementPanelStyle;
+    action: ProductPlacementAction;
+}
+/** 按广告 ID 获取产品 UI 配置参数 */
+interface GetProductConfigOptions {
+    /** 产品 UI 配置主键，也就是组件传入的广告 ID */
+    id: number | string;
+}
+/** 产品投放位配置服务结果 */
+interface ProductPlacementResult {
+    show: boolean;
+    id: number | string;
+    placementId?: string;
+    config: ProductPlacementConfig | null;
+    reason: 'matched' | 'noConfig';
+}
+
+/**
+ * @Description 按广告 ID 返回的产品 UI 配置标准化处理
+ * @Author wutao
+ * @Date 2026-09-09
+ * @LastEditors wutao
+ * @LastEditTime 2026-09-15 12:02:24
+ */
+
+/**
+ * 把按广告 ID 查询到的产品配置转换为 UI 标准配置
+ * @param productConfig 接口返回的产品 UI 配置
+ * @param expectedId 请求的广告 ID，用于防止响应错配
+ * @returns 标准化配置；不可展示或配置非法时返回 null
+ */
+declare function normalizeProductConfig(productConfig: ProductConfigApiData | null | undefined, expectedId: number | string): ProductPlacementConfig | null;
+
+/**
+ * 按广告 ID 获取并标准化产品 UI 配置
+ * @param options 查询参数
+ * @returns 标准化产品 UI 配置结果
+ */
+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 };