@yorkjs/hive-biz 0.1.9 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yorkjs/hive-biz",
-  "version": "0.1.9",
+  "version": "0.2.0",
   "description": "util function",
   "main": "dist/hive-biz.esm.js",
   "module": "dist/hive-biz.esm.js",

package/types/coupon/constant.d.ts

@@ -36,6 +36,18 @@ export declare const COUPON_STATUS_EXPIRED = 4;
 export declare const COUPON_STATUS_CANCELED = 5;
 /** 券实例状态：已锁定。对齐 coupon.status */
 export declare const COUPON_STATUS_LOCKED = 6;
+/** 券模板状态：草稿。对齐 coupon_template.status */
+export declare const COUPON_TEMPLATE_STATUS_DRAFT = 1;
+/** 券模板状态：已上线。对齐 coupon_template.status */
+export declare const COUPON_TEMPLATE_STATUS_ONLINE = 2;
+/** 券模板状态：已下线。对齐 coupon_template.status */
+export declare const COUPON_TEMPLATE_STATUS_OFFLINE = 3;
+/** 券模板状态：已过期。对齐 coupon_template.status */
+export declare const COUPON_TEMPLATE_STATUS_EXPIRED = 4;
+/** 接口没给 available_error 时，按已知状态补不可用原因 */
+export declare const COUPON_TEMPLATE_STATUS_UNAVAILABLE_ERROR: Record<number, string>;
+/** 券实例独有状态：已注销 / 已锁定。数字不与模板冲突 */
+export declare const COUPON_STATUS_UNAVAILABLE_ERROR: Record<number, string>;
 /** 可用券展开：使用规则等额外信息 */
 export declare const COUPON_EXPAND_TYPE_EXTRA = "extra";
 /** 不可用券展开：本单不可用原因 */

package/types/coupon/couponUtil.d.ts

@@ -2,10 +2,17 @@ import { CouponExpandType, CouponExpireMode, CouponFormatItem, ICoupon, ICouponK
 /** id 统一转字符串再比，避免 number / string 回显对不上 */
 export declare function isSameCouponId(a?: string | number, b?: string | number): boolean;
 /**
- * 选出 available。
- * 只看 availableError（对齐 available_error）：有值不可用，空则可用。
+ * 可用态。
+ * 1. availableError 有值：一定不可用
+ * 2. 带了 status 则只有 2（已上线 / 已生效）可用
+ * 3. 没带 status：没有 availableError 则可用（兼容列表只筛 status、项上不回传该字段）
  */
-export declare function resolveCouponAvailable(coupon: Pick<ICoupon, 'availableError'>): boolean;
+export declare function resolveCouponAvailable(coupon: Pick<ICoupon, 'availableError' | 'status'>): boolean;
+/**
+ * 展开用的不可用原因。
+ * 接口 availableError 优先；没有时按已知状态补文案（草稿/下线/过期/注销/锁定），其它灰态不展开。
+ */
+export declare function resolveCouponAvailableError(coupon: Pick<ICoupon, 'availableError' | 'status'>): string;
 /**
  * 原始列表 → 标准 ICoupon。
  * 有 formatItem 就逐项转换（返回空则跳过）；没有则把项当作已是 ICoupon。
@@ -62,7 +69,7 @@ export declare function getCouponExpandType(coupon: ICoupon): CouponExpandType;
 export declare function getCouponExpandLines(coupon: ICoupon): string[];
 /**
  * ICoupon → 票面数据。选券弹层和单独挂 CouponCard 共用。
- * selected / expanded 由调用方控制，available 由 availableError 推出。
+ * selected / expanded 由调用方控制，available 由 availableError + status 推出。
  */
 export declare function formatCouponViewItem(coupon: ICoupon, state?: {
     selected?: boolean;

package/types/coupon/type.d.ts

@@ -29,9 +29,10 @@ export interface ICoupon {
     /** 券名称，对齐 title */
     title: string;
     /**
-     * 券实例状态，对齐 coupon.status：
-     * 1 待生效 / 2 已生效 / 3 已使用 / 4 已过期 / 5 已注销 / 6 已锁定。
-     * 不参与灰态；能不能选只看 availableError。
+     * 券状态，对齐 coupon.status / coupon_template.status。
+     * 模板：1 草稿 / 2 已上线 / 3 已下线 / 4 已过期。
+     * 仅在带了 status 时：为 2 且没有 availableError 才可选；availableError 优先于 status。
+     * 没带 status 且没有 availableError 时视为可用。
      */
     status: number;
     /**
@@ -93,7 +94,8 @@ export interface ICoupon {
     useLimitCountMonthly?: number;
     /**
      * 本单不可用原因，对齐 available_error。
-     * 有值则灰态不可选并展示原因，空则可用。
+     * 有值则一定不可用（优先于 status），并作为展开原因。
+     * 接口没返回时，按 status 补原因（草稿 / 已下线 / 已过期 / 已注销 / 已锁定）。
      */
     availableError?: string;
     /**
@@ -125,7 +127,7 @@ export interface ICouponViewItem {
     selected: boolean;
     /** 当前是否展开详情 */
     expanded: boolean;
-    /** 是否可选、非灰态。由 availableError 推出 */
+    /** 是否可选、非灰态。availableError 优先，否则 status 为 2 才可用 */
     available: boolean;
     /** 票面左侧前缀，满减为 ¥，折扣为空 */
     amountPrefix: string;