@bi-nova/ui-weapp 1.2.1 → 1.3.0-beta.202609181052

package/src/product-placement/action-executor.js

@@ -0,0 +1,293 @@
+/**
+ * @Description 产品投放位动作执行器
+ * @Author wutao
+ * @Date 2026-09-14
+ * @LastEditors wutao
+ * @LastEditTime 2026-09-15 12:02:24
+ */
+const { executeNavigationAction } = require('../shared/action-executor')
+
+/** 产品投放位动作错误码 */
+const ACTION_ERROR_CODES = {
+  invalidAction: 'PRODUCT_PLACEMENT_ACTION_INVALID',
+  miniProgramFail: 'PRODUCT_PLACEMENT_NAVIGATE_MINI_PROGRAM_FAIL',
+  internalFail: 'PRODUCT_PLACEMENT_NAVIGATE_FAIL',
+  apiRequestFail: 'PRODUCT_PLACEMENT_API_REQUEST_FAIL',
+  unsupportedApi: 'PRODUCT_PLACEMENT_ACTION_API_UNSUPPORTED'
+}
+
+/**
+ * 上报业务动作执行错误
+ * @param {Record<string, any>} options 执行参数
+ * @param {string} errCode 错误码
+ * @param {string} errMsg 错误信息
+ * @returns {false}
+ */
+function emitBusinessError(options, errCode, errMsg) {
+  if (typeof options.onError === 'function') {
+    options.onError({ errCode, errMsg })
+  }
+
+  return false
+}
+
+/**
+ * 获取当前标准化业务编码
+ * @param {Record<string, any>} options 执行参数
+ * @returns {string} 小写业务编码
+ */
+function getBusinessCode(options) {
+  return String(
+    options.action && options.action.businessCode || ''
+  ).trim().toLowerCase()
+}
+
+/**
+ * 处理京东保险服务结果
+ * @param {Record<string, any>} options 执行参数
+ * @param {Record<string, any>} result 服务结果
+ * @returns {void}
+ */
+function handleJdInsuranceResult(options, result) {
+  const businessCode = getBusinessCode(options)
+
+  if (!result || result.code !== 0) {
+    emitBusinessError(
+      options,
+      'PRODUCT_PLACEMENT_BUSINESS_EXECUTE_FAIL',
+      result && result.message || '京东保险服务执行失败'
+    )
+    return
+  }
+
+  const data = result.data || {}
+
+  if (data.type === 'copy_success') {
+    const wxApi = typeof wx === 'undefined' ? null : wx
+
+    if (wxApi && typeof wxApi.showToast === 'function') {
+      wxApi.showToast({
+        title: result.message || '口令已复制',
+        icon: 'success'
+      })
+    }
+
+    if (typeof options.onSuccess === 'function') {
+      options.onSuccess({
+        actionType: 'business',
+        businessCode,
+        resultType: 'copy_success'
+      })
+    }
+    return
+  }
+
+  if (data.type === 'mini_program') {
+    executeNavigationAction({
+      ...options,
+      action: {
+        type: 'mini_program',
+        appId: data.appId,
+        path: data.path
+      },
+      errorCodes: ACTION_ERROR_CODES,
+      onSuccess(detail) {
+        if (typeof options.onSuccess === 'function') {
+          options.onSuccess({
+            ...detail,
+            actionType: 'business',
+            businessCode
+          })
+        }
+      }
+    })
+    return
+  }
+
+  if (data.type === 'h5') {
+    executeNavigationAction({
+      ...options,
+      action: {
+        type: 'web',
+        url: data.url
+      },
+      errorCodes: ACTION_ERROR_CODES,
+      onSuccess(detail) {
+        if (typeof options.onSuccess === 'function') {
+          options.onSuccess({
+            ...detail,
+            actionType: 'business',
+            businessCode
+          })
+        }
+      }
+    })
+    return
+  }
+
+  emitBusinessError(
+    options,
+    'PRODUCT_PLACEMENT_BUSINESS_RESULT_INVALID',
+    `京东保险服务返回了不支持的结果类型：${data.type || 'empty'}`
+  )
+}
+
+/**
+ * 执行京东保险内部服务
+ * @param {Record<string, any>} options 执行参数
+ * @returns {boolean}
+ */
+function executeJdInsurance(options) {
+  const sdk = options.sdk
+  const actionContext = options.actionContext || {}
+  const equipmentValue = String(actionContext.equipmentValue || '').trim()
+  const phone = String(actionContext.phone || '').trim()
+  const entrance = String(actionContext.entrance || '').trim()
+
+  if (!equipmentValue) {
+    return emitBusinessError(
+      options,
+      'PRODUCT_PLACEMENT_BUSINESS_PARAM_INVALID',
+      '京东保险服务缺少必要参数：equipmentValue'
+    )
+  }
+
+  if (!sdk || !sdk.jd || typeof sdk.jd.handleJdInsurance !== 'function') {
+    return emitBusinessError(
+      options,
+      'PRODUCT_PLACEMENT_BUSINESS_SERVICE_NOT_READY',
+      '未获取到京东保险服务，请升级并初始化 @bi-nova/services'
+    )
+  }
+
+  Promise.resolve(sdk.jd.handleJdInsurance({
+    equipmentValue,
+    ...(phone ? { phone } : {}),
+    ...(entrance ? { entrance } : {})
+  })).then((result) => {
+    handleJdInsuranceResult(options, result)
+  }).catch((error) => {
+    emitBusinessError(
+      options,
+      'PRODUCT_PLACEMENT_BUSINESS_EXECUTE_EXCEPTION',
+      error && error.message || '京东保险服务执行异常'
+    )
+  })
+
+  return true
+}
+
+/**
+ * 执行京东保险外部对接服务
+ * @param {Record<string, any>} options 执行参数
+ * @returns {boolean}
+ */
+function executeJdInsuranceExt(options) {
+  const sdk = options.sdk
+  const actionContext = options.actionContext || {}
+  const thirdPlatform = String(actionContext.thirdPlatform || '').trim()
+  const thirdPlatformUserId = String(actionContext.thirdPlatformUserId || '').trim()
+  const thirdPlatformEquipmentValue = String(
+    actionContext.thirdPlatformEquipmentValue || ''
+  ).trim()
+  const phone = String(actionContext.phone || '').trim()
+  const extendData = actionContext.extendData
+  const missingParamNames = [
+    ['thirdPlatform', thirdPlatform],
+    ['thirdPlatformUserId', thirdPlatformUserId],
+    ['thirdPlatformEquipmentValue', thirdPlatformEquipmentValue]
+  ].filter((item) => !item[1]).map((item) => item[0])
+
+  if (missingParamNames.length) {
+    return emitBusinessError(
+      options,
+      'PRODUCT_PLACEMENT_BUSINESS_PARAM_INVALID',
+      `京东保险外部对接服务缺少必要参数：${missingParamNames.join('、')}`
+    )
+  }
+
+  if (!sdk || !sdk.jd || typeof sdk.jd.handleJdInsuranceExt !== 'function') {
+    return emitBusinessError(
+      options,
+      'PRODUCT_PLACEMENT_BUSINESS_SERVICE_NOT_READY',
+      '未获取到京东保险外部对接服务，请升级并初始化 @bi-nova/services'
+    )
+  }
+
+  Promise.resolve(sdk.jd.handleJdInsuranceExt({
+    thirdPlatform,
+    thirdPlatformUserId,
+    thirdPlatformEquipmentValue,
+    ...(phone ? { phone } : {}),
+    ...(extendData && typeof extendData === 'object' && !Array.isArray(extendData)
+      ? { extendData: { ...extendData } }
+      : {})
+  })).then((result) => {
+    handleJdInsuranceResult(options, result)
+  }).catch((error) => {
+    emitBusinessError(
+      options,
+      'PRODUCT_PLACEMENT_BUSINESS_EXECUTE_EXCEPTION',
+      error && error.message || '京东保险外部对接服务执行异常'
+    )
+  })
+
+  return true
+}
+
+/** 产品业务动作白名单 */
+const BUSINESS_ACTION_HANDLERS = {
+  jd_insurance: executeJdInsurance,
+  jd_insurance_ext: executeJdInsuranceExt
+}
+
+/**
+ * 执行产品业务动作
+ * @param {Record<string, any>} options 执行参数
+ * @returns {boolean}
+ */
+function executeBusinessAction(options) {
+  const businessCode = getBusinessCode(options)
+  const handler = BUSINESS_ACTION_HANDLERS[businessCode]
+
+  if (!businessCode || typeof handler !== 'function') {
+    return emitBusinessError(
+      options,
+      'PRODUCT_PLACEMENT_BUSINESS_UNSUPPORTED',
+      `不支持的产品业务：${businessCode || 'empty'}`
+    )
+  }
+
+  return handler(options)
+}
+
+/**
+ * 执行产品投放位标准动作
+ * @param {Object} options 动作执行参数
+ * @param {Record<string, any>} options.action 标准动作配置
+ * @param {Record<string, any>} [options.sdk] Nova SDK 实例
+ * @param {Record<string, any>} [options.actionContext] 宿主动作运行时上下文
+ * @param {Record<string, any>} [options.apiRequestParams] 动态接口运行时参数
+ * @param {(detail: Record<string, any>) => void} [options.onOpenWebview] WebView 回调
+ * @param {(detail: Record<string, any>) => void} [options.onSuccess] 成功回调
+ * @param {(detail: {errCode: string, errMsg: string}) => void} [options.onError] 失败回调
+ * @returns {boolean} 是否已进入动作执行流程
+ */
+function executeProductPlacementAction(options) {
+  const action = options && options.action || {}
+
+  if (action.type === 'business') {
+    return executeBusinessAction(options)
+  }
+
+  return executeNavigationAction({
+    ...options,
+    errorCodes: ACTION_ERROR_CODES
+  })
+}
+
+module.exports = {
+  ACTION_ERROR_CODES,
+  BUSINESS_ACTION_HANDLERS,
+  executeProductPlacementAction
+}

package/src/product-placement/banner/index.js

@@ -0,0 +1,106 @@
+/**
+ * @Description 产品投放位 Banner 展示组件
+ * @Author wutao
+ * @Date 2026-09-08
+ * @LastEditors wutao
+ * @LastEditTime 2026-09-08 17:55:14
+ */
+Component({
+  properties: {
+    creative: { type: Object, value: null },
+    panelStyle: { type: Object, value: null },
+    actionable: { type: Boolean, value: false },
+    actionLoading: { type: Boolean, value: false }
+  },
+  data: {
+    ready: false
+  },
+  lifetimes: {
+    attached() {
+      this.syncCreative(this.properties.creative)
+    },
+    detached() {
+      this.clearReadyTimer()
+    }
+  },
+  observers: {
+    creative(nextCreative) {
+      this.syncCreative(nextCreative)
+    }
+  },
+  methods: {
+    /**
+     * 素材不包含图片时，在视图完成更新后直接进入可展示状态
+     * @param {Record<string, string> | null} creative 标准化素材
+     * @returns {void}
+     */
+    syncCreative(creative) {
+      this.clearReadyTimer()
+      this.setData({ ready: false })
+
+      if (creative && creative.imageUrl) return
+
+      this.readyTimer = setTimeout(() => this.notifyReady('content'), 0)
+    },
+
+    /** 清理延迟就绪任务 */
+    clearReadyTimer() {
+      if (!this.readyTimer) return
+
+      clearTimeout(this.readyTimer)
+      this.readyTimer = null
+    },
+
+    /**
+     * 通知上层组件素材已经可以展示
+     * @param {string} mediaType 素材类型
+     * @returns {void}
+     */
+    notifyReady(mediaType) {
+      if (this.data.ready) return
+
+      this.setData({ ready: true })
+      this.triggerEvent('ready', { mediaType })
+    },
+
+    /** 处理图片加载完成 */
+    handleImageLoad() {
+      this.notifyReady('image')
+    },
+
+    /**
+     * 处理图片加载失败
+     * @param {Record<string, any>} event 小程序图片错误事件
+     * @returns {void}
+     */
+    handleImageError(event) {
+      const rawDetail = event && event.detail || {}
+
+      this.triggerEvent('error', {
+        errCode: 'PRODUCT_PLACEMENT_BANNER_IMAGE_LOAD_FAIL',
+        errMsg: '产品 Banner 图片加载失败',
+        errorType: 'MEDIA_LOAD_FAIL',
+        rawErrCode: rawDetail.errCode,
+        rawErrMsg: rawDetail.errMsg
+      })
+    },
+
+    /** 处理关闭按钮点击 */
+    handleClose() {
+      this.triggerEvent('close', { reason: 'closeButton' })
+    },
+
+    /**
+     * 处理可点击区域操作
+     * @param {Record<string, any>} event 点击事件
+     * @returns {void}
+     */
+    handleAction(event) {
+      if (!this.properties.actionable || this.properties.actionLoading) return
+
+      this.triggerEvent('action', {
+        source: event && event.currentTarget && event.currentTarget.dataset.source || 'surface'
+      })
+    }
+  }
+})

package/src/product-placement/banner/index.json

@@ -0,0 +1,3 @@
+{
+  "component": true
+}

package/src/product-placement/banner/index.wxml

@@ -0,0 +1,48 @@
+<!--
+  @Description 产品投放位 Banner 展示组件模板
+  @Author wutao
+  @Date 2026-09-08
+  @LastEditors wutao
+  @LastEditTime 2026-09-14 14:44:07
+-->
+<view class="bi-product-banner {{panelStyle.skinClass}}">
+  <view
+    class="bi-product-banner__surface {{actionable ? 'bi-product-banner__surface--actionable' : ''}}"
+    data-source="surface"
+    bindtap="handleAction"
+  >
+    <image
+      wx:if="{{creative.imageUrl}}"
+      class="bi-product-banner__image"
+      src="{{creative.imageUrl}}"
+      mode="widthFix"
+      bindload="handleImageLoad"
+      binderror="handleImageError"
+    />
+
+    <view wx:if="{{creative.title || creative.description || creative.buttonText}}" class="bi-product-banner__body">
+      <view class="bi-product-banner__copy">
+        <text wx:if="{{creative.badgeText}}" class="bi-product-banner__badge">{{creative.badgeText}}</text>
+        <text wx:if="{{creative.title}}" class="bi-product-banner__title">{{creative.title}}</text>
+        <text wx:if="{{creative.description}}" class="bi-product-banner__description">{{creative.description}}</text>
+      </view>
+      <button
+        wx:if="{{creative.buttonText}}"
+        class="bi-product-banner__button {{!actionable || actionLoading ? 'bi-product-banner__button--disabled' : ''}}"
+        data-source="button"
+        loading="{{actionLoading}}"
+        disabled="{{!actionable || actionLoading}}"
+        catchtap="handleAction"
+      >
+        {{creative.buttonText}}
+      </button>
+    </view>
+  </view>
+
+  <button
+    wx:if="{{panelStyle.closeable}}"
+    class="bi-product-banner__close"
+    aria-label="关闭产品投放位"
+    catchtap="handleClose"
+  >×</button>
+</view>

package/src/product-placement/banner/index.wxss

@@ -0,0 +1,133 @@
+/*
+ * @Description 产品投放位 Banner 展示组件样式
+ * @Author wutao
+ * @Date 2026-09-08
+ * @LastEditors wutao
+ * @LastEditTime 2026-09-14 14:44:07
+ */
+:host {
+  display: block;
+  width: 100%;
+}
+
+.bi-product-banner {
+  position: relative;
+  overflow: hidden;
+  box-sizing: border-box;
+  width: 100%;
+  border-radius: 16rpx;
+  background: #ffffff;
+  box-shadow: 0 8rpx 24rpx rgba(15, 23, 42, 0.08);
+}
+
+.bi-product-banner__surface--actionable {
+  cursor: pointer;
+}
+
+.bi-product-banner__surface {
+  width: 100%;
+}
+
+.bi-product-banner__image {
+  display: block;
+  width: 100%;
+  height: auto;
+}
+
+.bi-product-banner__body {
+  display: flex;
+  align-items: center;
+  box-sizing: border-box;
+  min-height: 132rpx;
+  padding: 24rpx 28rpx;
+}
+
+.bi-product-banner__copy {
+  display: flex;
+  flex: 1;
+  min-width: 0;
+  flex-direction: column;
+}
+
+.bi-product-banner__badge {
+  align-self: flex-start;
+  padding: 2rpx 10rpx;
+  border-radius: 6rpx;
+  background: #fff0e8;
+  color: #fa541c;
+  font-size: 20rpx;
+  line-height: 32rpx;
+}
+
+.bi-product-banner__title {
+  margin-top: 8rpx;
+  overflow: hidden;
+  color: #1f2329;
+  font-size: 30rpx;
+  font-weight: 600;
+  line-height: 42rpx;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.bi-product-banner__description {
+  display: -webkit-box;
+  overflow: hidden;
+  color: #646a73;
+  font-size: 24rpx;
+  line-height: 34rpx;
+  -webkit-box-orient: vertical;
+  -webkit-line-clamp: 2;
+}
+
+.bi-product-banner__button {
+  flex: 0 0 auto;
+  box-sizing: border-box;
+  min-width: 144rpx;
+  height: 64rpx;
+  margin: 0;
+  margin-left: 24rpx;
+  padding: 0 24rpx;
+  border-radius: 32rpx;
+  background: #1677ff;
+  color: #ffffff;
+  font-size: 24rpx;
+  font-weight: 500;
+  line-height: 64rpx;
+}
+
+.bi-product-banner__button::after,
+.bi-product-banner__close::after {
+  border: none;
+}
+
+.bi-product-banner__close {
+  position: absolute;
+  top: 12rpx;
+  right: 12rpx;
+  z-index: 2;
+  width: 48rpx;
+  height: 48rpx;
+  margin: 0;
+  padding: 0;
+  border-radius: 50%;
+  background: rgba(0, 0, 0, 0.42);
+  color: #ffffff;
+  font-size: 34rpx;
+  font-weight: 300;
+  line-height: 44rpx;
+}
+
+.bi-product-skin--vip-gold .bi-product-banner__button {
+  background: linear-gradient(135deg, #efc77e 0%, #b8893f 100%);
+  color: #35230b;
+}
+
+.bi-product-skin--insurance-blue .bi-product-banner__button {
+  background: #246bfd;
+}
+
+.bi-product-banner__button.bi-product-banner__button--disabled {
+  background: #a9c9f7;
+  color: rgba(255, 255, 255, 0.9);
+}

package/src/product-placement/half-screen/index.js

@@ -0,0 +1,129 @@
+/**
+ * @Description 产品投放位底部半屏组件
+ * @Author wutao
+ * @Date 2026-09-08
+ * @LastEditors wutao
+ * @LastEditTime 2026-09-08 17:55:14
+ */
+Component({
+  properties: {
+    creative: { type: Object, value: null },
+    panelStyle: { type: Object, value: null },
+    actionable: { type: Boolean, value: false },
+    actionLoading: { type: Boolean, value: false },
+    zIndex: { type: Number, value: 999 }
+  },
+  data: {
+    ready: false,
+    panelHeight: 68
+  },
+  lifetimes: {
+    attached() {
+      this.syncPanelStyle(this.properties.panelStyle)
+      this.syncCreative(this.properties.creative)
+    },
+    detached() {
+      this.clearReadyTimer()
+    }
+  },
+  observers: {
+    creative(nextCreative) {
+      this.syncCreative(nextCreative)
+    },
+    panelStyle(nextPanelStyle) {
+      this.syncPanelStyle(nextPanelStyle)
+    }
+  },
+  methods: {
+    /**
+     * 同步半屏高度，输入值已经由统一入口限制在安全范围
+     * @param {Record<string, any> | null} panelStyle 标准化面板样式
+     * @returns {void}
+     */
+    syncPanelStyle(panelStyle) {
+      const heightRatio = Number(panelStyle && panelStyle.heightRatio)
+      this.setData({
+        panelHeight: Number.isFinite(heightRatio) ? Math.round(heightRatio * 100) : 68
+      })
+    },
+
+    /**
+     * 同步半屏素材状态
+     * @param {Record<string, string> | null} creative 标准化素材
+     * @returns {void}
+     */
+    syncCreative(creative) {
+      this.clearReadyTimer()
+      this.setData({ ready: false })
+
+      if (creative && creative.imageUrl) return
+
+      this.readyTimer = setTimeout(() => this.notifyReady('content'), 0)
+    },
+
+    /** 清理延迟就绪任务 */
+    clearReadyTimer() {
+      if (!this.readyTimer) return
+
+      clearTimeout(this.readyTimer)
+      this.readyTimer = null
+    },
+
+    /**
+     * 通知上层组件半屏已经可以展示
+     * @param {string} mediaType 素材类型
+     * @returns {void}
+     */
+    notifyReady(mediaType) {
+      if (this.data.ready) return
+
+      this.setData({ ready: true })
+      this.triggerEvent('ready', { mediaType })
+    },
+
+    /** 处理图片加载完成 */
+    handleImageLoad() {
+      this.notifyReady('image')
+    },
+
+    /**
+     * 处理图片加载失败
+     * @param {Record<string, any>} event 小程序图片错误事件
+     * @returns {void}
+     */
+    handleImageError(event) {
+      const rawDetail = event && event.detail || {}
+
+      this.triggerEvent('error', {
+        errCode: 'PRODUCT_PLACEMENT_HALF_SCREEN_IMAGE_LOAD_FAIL',
+        errMsg: '产品半屏图片加载失败',
+        errorType: 'MEDIA_LOAD_FAIL',
+        rawErrCode: rawDetail.errCode,
+        rawErrMsg: rawDetail.errMsg
+      })
+    },
+
+    /** 处理关闭按钮点击 */
+    handleClose() {
+      this.triggerEvent('close', { reason: 'closeButton' })
+    },
+
+    /** 处理遮罩关闭事件 */
+    handleMaskClose() {
+      this.triggerEvent('close', { reason: 'mask' })
+    },
+
+    /**
+     * 处理产品动作
+     * @param {Record<string, any>} event 点击事件
+     * @returns {void}
+     */
+    handleAction(event) {
+      if (!this.properties.actionable || this.properties.actionLoading) return
+
+      this.triggerEvent('action', {
+        source: event && event.currentTarget && event.currentTarget.dataset.source || 'button'
+      })
+    }
+  }
+})