@lemoncloud/clipbiz-goods-api 0.25.1215 → 0.25.1227

package/dist/modules/contracts/model.d.ts

@@ -11,6 +11,7 @@
  */
 import { CoreModel } from 'lemon-model';
 import $LUT, { ContractStereo, ContractState, DeliveryStereo, DeliveryState, ContractStateSet, DeliveryStateSet, Agreement } from './types';
+import { FileRef } from '../../service/backend-types';
 import { DealHead, DealModel } from '../deals/model';
 import { Cores } from 'lemon-core';
 /**
@@ -91,6 +92,8 @@ export interface ContractModel extends ContractHead, Model {
     sellerAgreed$?: Agreement;
     /** 판매업체(표준사업장) 약관 기록 */
     buyerAgreed$?: Agreement;
+    /** 첨부파일 목록 (backend-api 관리) */
+    files$$?: FileRef[];
     /**
      * (internal) detail info of deal
      */

package/dist/modules/events/model.d.ts

@@ -0,0 +1,53 @@
+/**
+ * `model.ts`
+ * - model definitions
+ *
+ * @author      Aiden <aiden@lemoncloud.io>
+ * @date        2025-12-28 initial version.
+ *
+ * @copyright   (C) 2025 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+import { CoreModel } from 'lemon-model';
+import $LUT, { EventStereo } from './types';
+/**
+ * type: `ModelType`
+ */
+export declare type ModelType = keyof typeof $LUT.ModelType;
+/**
+ * type: `Model`: common model
+ */
+export declare type Model = CoreModel<ModelType>;
+/**
+ * type: `EventModel` (이벤트)
+ * - 사용자 이벤트 로그 (검색, 클릭 등)
+ */
+export interface EventModel extends Model {
+    /** name of model */
+    name?: string;
+    /** stereo of model */
+    stereo?: EventStereo;
+    /** user-agent from header */
+    userAgent?: string;
+    /** client-ip when request */
+    clientIp?: string;
+    /** (optional) identity-id */
+    identityId?: string;
+}
+/**
+ * extract field names from models
+ * - only fields start with lowercase, or all upper.
+ */
+export declare const filterFields: (fields: string[], base?: string[]) => string[];
+/** field names from head */
+export declare const $HEAD: {};
+export declare const $FIELD: {
+    event: string[];
+};
+/** must export default as below */
+declare const _default: {
+    $HEAD: {};
+    $FIELD: {
+        event: string[];
+    };
+};
+export default _default;

package/dist/modules/events/types.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `types.ts`
+ * - basic types used in `proxy`
+ *
+ * @author      Aiden <aiden@lemoncloud.io>
+ * @date        2025-12-28 initial version.
+ *
+ * @copyright   (C) 2025 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+/**
+ * Lookup Table
+ *
+ * WARN! DO NOT EXPORT AS `$LUT`. use default export instead.
+ */
+declare const $LUT: {
+    /**
+     * Possible type of model.
+     */
+    ModelType: {
+        /** event model */
+        event: string;
+    };
+    /**
+     * 이벤트의 종류
+     */
+    EventStereo: {
+        '': string;
+        /** 검색 키워드 */
+        keyword: string;
+    };
+};
+/**
+ * type: `EventStereo`
+ */
+export declare type EventStereo = keyof typeof $LUT.EventStereo;
+/** must export $LUT as default */
+export default $LUT;

package/dist/modules/events/views.d.ts

@@ -0,0 +1,60 @@
+/**
+ * `views.ts`
+ * - type of views used in `transformer`
+ *
+ * @author      Aiden <aiden@lemoncloud.io>
+ * @date        2025-12-28 initial version.
+ *
+ * @copyright   (C) 2025 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+import { View, Body } from 'lemon-model';
+import { EventModel } from './model';
+import $LUT from './types';
+export * from './types';
+export default $LUT;
+/**
+ * type `EventView`
+ */
+export interface EventView extends View, Partial<EventModel> {
+}
+/**
+ * type `EventBody`
+ */
+export interface EventBody extends Body, Partial<EventView> {
+}
+/**
+ * type: `WordCount`
+ * - 키워드별 검색 횟수 집계 결과
+ */
+export interface WordCount {
+    /** 검색 키워드 */
+    word: string;
+    /** 검색 횟수 */
+    count: number;
+    /** 마지막 검색 시각 (timestamp) */
+    last: number;
+}
+/**
+ * type: `KeywordAggrBody`
+ * - 키워드 집계 API 요청 파라미터
+ */
+export interface KeywordAggrParam {
+    /** 검색할 키워드 수 (default: 10) */
+    limit?: number;
+    /** 검색할 기간 (default: 30일) */
+    days?: number;
+}
+/**
+ * type: `KeywordAggrResult`
+ * - 키워드 집계 API 응답 타입
+ */
+export interface KeywordAggrResult {
+    /** 전체 이벤트 수 */
+    total: number;
+    /** 이벤트 목록 (빈 배열) */
+    list: EventView[];
+    /** 키워드별 집계 결과 */
+    $aggr?: WordCount[];
+    /** 요청 파라미터 */
+    $param?: KeywordAggrParam;
+}

package/dist/modules/goods/model.d.ts

@@ -9,7 +9,7 @@
  *
  * Copyright (C) 2022 LemonCloud Co Ltd. - All Rights Reserved.
  */
-import { CoreModel, Cores } from 'lemon-model';
+import { CoreModel } from 'lemon-model';
 import $LUT, { CartStereo, ItemStereo, ItemUnitType, ProdStereo } from './types';
 import { CategoryHead } from '../categories/model';
 import { SiteHead, UserHead } from '../sites/model';
@@ -24,16 +24,8 @@ export declare type ModelType = keyof typeof $LUT.ModelType;
 /**
  * type: `Model`: common model interface
  * - modifier 정보 저장을 위해 확장됨 @251124
- *
- * TODO [Steve] 아래의 `$` 부분은 추후 `lemon-model` 쪽으로 이전 검토 필요. @251124
  */
-export interface Model extends CoreModel<ModelType> {
-    /**
-     * the modifier information
-     * - can't update manually.
-     */
-    readonly $?: Cores;
-}
+export declare type Model = CoreModel<ModelType>;
 /**
  * interface: `ItemHead`
  * - common head of item-model.

package/dist/service/backend-types.d.ts

@@ -19,16 +19,12 @@ declare const $LUT: {
      * Possible type of model.
      */
     ModelType: {
+        event: string;
         mock: string;
         test: string;
         callback: string;
         category: string;
         site: string;
-        /**
-         * Lookup Table
-         *
-         * WARN! DO NOT EXPORT AS `$LUT`. use default export instead.
-         */
         user: string;
         exam: string;
         contract: string;
@@ -62,6 +58,34 @@ export declare type ModelType = keyof typeof $LUT.ModelType;
  * type: `LanguageType`
  */
 export declare type LanguageType = keyof typeof $LUT.Languages;
+/**
+ * interface: `RefItem<T>`
+ * - 외부 참조 아이템의 베이스 타입
+ * @template T - 아이템 타입 (기본: string)
+ */
+export interface RefItem<T extends string = string> {
+    /** item-id */
+    id: string;
+    /** item-name */
+    name?: string;
+    /** item-type */
+    type?: T;
+}
+/**
+ * interface: `FileRef<T>`
+ * - 파일 참조 아이템
+ * @template T - 파일 타입 (기본: 'file')
+ */
+export interface FileRef extends RefItem<'file'> {
+    /** (optional) file URL */
+    url?: string;
+    /** (optional) thumbnail URL */
+    thumbnail?: string;
+    /** (optional) content size (MIME) */
+    contentType?: string;
+    /** (optional) content size (bytes) */
+    contentSize?: number;
+}
 /**
  * type: `StateActor`
  * - 모델의 상태(State)를 변경한 행위자 (Actor) 정보