icms-api 0.1.6 → 0.1.7

package/dist/types/client.d.ts

@@ -110,7 +110,7 @@ export declare class ICMSClient {
     /** 获取所有货架（类目）列表 */
     loadGoodsShelves(): Promise<Array<GoodsCategory>>;
     /** 获取指定货架的商品列表 */
-    loadCategoryGoods(params: Readonly<{
+    loadCategoryGoods(params?: Readonly<{
         cateCode: string;
         count?: number;
     }>): Promise<Array<GoodsItem>>;

package/dist/types/server.d.ts

@@ -7,7 +7,7 @@ import { PhotoContent } from './types/cms-photo';
 import { VideoContent } from './types/cms-video';
 import { ActivityContent } from './types/cms-activity';
 import { Reviews, SubscribeUser, ContactUs } from './types/cms-message';
-import { SpecDescription, GoodsItem, GoodsCategory, GoodsTag } from './types/cms-mall';
+import { SpecDescription, GoodsItem, GoodsDetail, GoodsCategory, GoodsTag } from './types/cms-mall';
 export declare const helloURL: string;
 export declare class ICMSServer {
     private readonly http;
@@ -265,7 +265,7 @@ export declare class ICMSServer {
     /** 获取所有货架（类目）列表 */
     loadGoodsShelves(): Promise<Array<GoodsCategory>>;
     /** 获取指定货架的商品列表 */
-    loadCategoryGoods(params: Readonly<{
+    loadCategoryGoods(params?: Readonly<{
         cateCode: string;
         count?: number;
     }>): Promise<Array<GoodsItem>>;
@@ -274,4 +274,6 @@ export declare class ICMSServer {
         cateCode?: string;
         keyword?: string;
     } & PageParams>): Promise<PageInfo<GoodsItem>>;
+    /** 获取商品详情（含 detailContent HTML） */
+    getGoodsDetail(goodsListedId: string): Promise<GoodsDetail | undefined>;
 }

package/dist/types/types/cms-mall.d.ts

@@ -25,8 +25,14 @@ export interface GoodsImage {
 /** 商品视频 */
 export interface GoodsVideo {
     id?: string;
+    /** 视频名称 */
+    name?: string;
+    /** 视频描述 */
+    description?: string;
+    /** 封面图地址 */
+    coverUrl?: string;
+    /** 视频地址 */
     url?: string;
-    poster?: string;
 }
 /** 商品基础信息（用于列表展示） */
 export interface GoodsItem {
@@ -41,6 +47,10 @@ export interface GoodsItem {
     video?: GoodsVideo;
     tags?: string;
     hidden?: boolean;
+    /** 网站编号 */
+    websiteNo?: string;
+    /** 关联基础产品编码 */
+    proCode?: string;
     createTime?: string;
     lastUpdateTime?: string;
     /** 货架编码 */
@@ -48,6 +58,13 @@ export interface GoodsItem {
     /** 货架名称（后端 Transient 填充） */
     cateName?: string;
 }
+/** 商品详情（含 detailContent，由 getGoodsDetail 接口返回） */
+export interface GoodsDetail extends GoodsItem {
+    /** 详情内容（HTML，后端 showDetail() 将 detailContent 填充到 rawContent） */
+    rawContent?: string;
+    /** 商品规格（后端 showSpecInfo() 填充） */
+    specInfo?: SpecInfo;
+}
 /** 货架（商品类目） */
 export interface GoodsCategory {
     id: string;
@@ -66,3 +83,40 @@ export interface GoodsTag {
     name: string;
     websiteNo?: string;
 }
+/** 商品规格属性 */
+export interface SpecProps {
+    /** 属性编号 */
+    code: string;
+    /** 属性名称 */
+    name: string;
+    /** 售价 */
+    price: number;
+    /** 标识图标 */
+    iconUrl?: string;
+    /** 绑定的图片文件JSON */
+    images?: string;
+}
+/** 商品规格项 */
+export interface SpecItem {
+    /** 规格编号 */
+    code: string;
+    /** 规格名称 */
+    name: string;
+    /** 是否必选 */
+    required: boolean;
+    /** 是否可多选 */
+    multiple: boolean;
+    /** 规格说明代码 */
+    descCode?: string;
+    /** 启用图库绑定 */
+    imageLib: boolean;
+    /** 属性列表 */
+    props?: Array<SpecProps>;
+}
+/** 商品规格 */
+export interface SpecInfo {
+    /** 产品编码 */
+    productCode?: string;
+    /** 规格项列表 */
+    specificationItems?: Array<SpecItem>;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "icms-api",
   "private": false,
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "对iCMS内容管理系统API的封装，使用该API能快速使用iCMS搭建您的WebApp!",
   "type": "module",
   "main": "./dist/icms-api.cjs.js",