@sayren/store-sdk 0.51.0 → 0.53.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/store-sdk",
-  "version": "0.51.0",
+  "version": "0.53.0",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {

package/src/schemas/coupon-selection.ts

@@ -1,6 +1,6 @@
 import { KRW_MONEY_RULES } from "./currency";
 import {
-  couponDiscountOf,
+  couponRuleDiscountOf,
   couponStackingOf,
   couponsCombinable,
   type PricingCoupon,
@@ -139,14 +139,19 @@ export function bestCouponSelection(input: CouponSelectionInput): CouponSelectio
   const orders = solo.filter((e) => e.candidate.coupon.rule.kind === "ORDER");
   const deliveries = solo.filter((e) => e.candidate.coupon.rule.kind === "DELIVERY");
   const lineIds = input.lines.map((line) => line.lineId);
-  const lineAmount = new Map(input.lines.map((line) => [line.lineId, line.amount]));
+  const lineById = new Map(input.lines.map((line) => [line.lineId, line]));
 
   /** 상품 쿠폰 한 장의 줄별 할인 — 대상 줄만, 줄 금액 기준 */
   const weightsOf = (entry: (typeof products)[number]) => {
     const eligible = new Set(entry.result?.eligibleLineIds ?? []);
     return lineIds.map((id) =>
       eligible.has(id)
-        ? couponDiscountOf(entry.candidate.coupon.rule.benefit, lineAmount.get(id) ?? 0, rules)
+        ? couponRuleDiscountOf(
+            entry.candidate.coupon.rule,
+            lineById.get(id)?.amount ?? 0,
+            lineById.get(id) ?? null,
+            rules,
+          )
         : 0,
     );
   };

package/src/schemas/coupon.ts

@@ -12,10 +12,12 @@ import {
 import { currencyCodeSchema } from "./currency";
 import {
   COUPON_CONDITIONS_DEFAULTS,
+  COUPON_REWARD_KINDS,
   COUPON_TARGET_LIST_MAX,
   couponBenefitSchema,
   couponConditionsSchema,
   couponKindSchema,
+  couponRewardSchema,
   couponTargetSchema,
 } from "./promotion";
 import { strictRequest } from "./strict";
@@ -103,6 +105,9 @@ const descriptions = {
     "발급 대상 트리(이슈 #222) — 셀러 지급·받기·회원가입 지급에서 누가 받을 수 있는가. 구매자 조건만. 코드 입력형에는 두지 않는다",
   stacking:
     "중복 사용 정책(이슈 #222). 생략하면 종류별 한 장·서로 결합·적립금과 함께. 결합은 양쪽 쿠폰이 모두 허용해야 성립한다",
+  reward:
+    "확장 혜택(구간 할인 `TIERED`·N+1 `BUY_X_GET_Y`·적립금 지급 `POINT`). 주면 `benefit`을 생략하고, 응답의 `benefit`은 가장 가까운 값이다. " +
+    "N+1은 상품 쿠폰만, 적립금 지급은 회원 전용 주문 쿠폰만이다. 수정에서 null이면 확장 혜택을 지운다(`benefit`이 필요하다)",
   issueStartsAt: "받기 시작 시각(받기 쿠폰만, 이슈 #222). 생략하면 사용 시작 시각을 따른다",
   issueEndsAt:
     "받기 종료 시각(받기 쿠폰만, 이 시각부터 못 받는다). 생략하면 사용 종료 시각을 따른다",
@@ -116,6 +121,7 @@ const ruleFields = {
   targetRules: couponTargetRulesSchema.optional().describe(descriptions.targetRules),
   audience: couponConditionTreeSchema.optional().describe(descriptions.audience),
   stacking: couponStackingSchema.optional().describe(descriptions.stacking),
+  reward: couponRewardSchema.nullable().optional().describe(descriptions.reward),
 };
 
 /**
@@ -141,6 +147,8 @@ export function couponRequestRuleIssues(body: {
   targetRules?: CouponRuleTrees["targetRules"];
   audience?: CouponRuleTrees["eligibility"];
   stacking?: { perOrderLimit: number };
+  reward?: { type: "TIERED" | "BUY_X_GET_Y" | "POINT" } | null;
+  benefit?: unknown;
   perMemberUseLimit?: number | null;
   dailyIssueLimit?: number | null;
   issueStartsAt?: string | null;
@@ -179,6 +187,27 @@ export function couponRequestRuleIssues(body: {
       ...(body.audience ? { audience: body.audience } : {}),
     }),
   );
+  if (!body.reward && body.benefit === undefined)
+    issues.push({ path: ["benefit"], message: "혜택(benefit 또는 reward)이 필요합니다" });
+  if (
+    body.reward &&
+    body.kind !== undefined &&
+    !(COUPON_REWARD_KINDS[body.reward.type] as readonly string[]).includes(body.kind)
+  )
+    issues.push({
+      path: ["reward", "type"],
+      message:
+        body.reward.type === "POINT"
+          ? "적립금 지급은 주문 쿠폰만 쓸 수 있습니다"
+          : body.reward.type === "BUY_X_GET_Y"
+            ? "N+1은 상품 쿠폰만 쓸 수 있습니다"
+            : "구간 할인은 배송비 쿠폰에 쓸 수 없습니다",
+    });
+  if (body.reward?.type === "POINT" && !conditions.memberOnly)
+    issues.push({
+      path: ["reward", "type"],
+      message: "적립금 지급은 회원 전용 쿠폰만 쓸 수 있습니다",
+    });
   if (body.stacking && body.stacking.perOrderLimit > 1 && body.kind !== "PRODUCT")
     issues.push({
       path: ["stacking", "perOrderLimit"],
@@ -250,7 +279,7 @@ export const createCouponRequestSchema = strictRequest(
       name: z.string().trim().min(1).max(60).describe(descriptions.name),
       description: z.string().max(300).nullable().optional().describe(descriptions.description),
       kind: couponKindSchema,
-      benefit: couponBenefitSchema,
+      benefit: couponBenefitSchema.optional().describe("혜택. `reward`를 주면 생략한다"),
       conditions: couponConditionsInputSchema
         .optional()
         .describe("사용 조건. 생략한 항목은 기본값(최소 금액 0, 회원 전용, 즉시할인과 중복 가능)"),
@@ -288,6 +317,8 @@ export const createCouponRequestSchema = strictRequest(
         ctx.addIssue({ code: "custom", path: [path], message });
       if (body.issueMethod === "CODE" && !body.code)
         issue("code", "코드 입력형 쿠폰은 코드가 필요합니다");
+      if (body.reward && body.benefit)
+        issue("benefit", "확장 혜택(reward)을 주면 benefit을 생략합니다");
       if (body.issueMethod === "VOUCHER" && !body.voucher)
         issue("voucher", "쿠폰 번호 쿠폰은 번호 설정이 필요합니다");
       if (body.issueMethod !== "VOUCHER" && body.voucher)
@@ -423,6 +454,11 @@ export const couponSchema = z.object({
     .optional()
     .default(COUPON_STACKING_DEFAULTS)
     .describe("중복 사용 정책(이슈 #222). 서버는 항상 싣는다"),
+  reward: couponRewardSchema
+    .nullable()
+    .optional()
+    .default(null)
+    .describe("확장 혜택. 없으면 null이고 `benefit`이 혜택이다. 서버는 항상 싣는다"),
   rulesOnly: z
     .boolean()
     .optional()

package/src/schemas/plans.ts

@@ -10,8 +10,8 @@ const limitOrContract = (description: string) =>
   z.number().int().nullable().describe(`${description}. null이면 계약(엔터프라이즈)·한도 없음`);
 
 /**
- * 요금제 기능 키 값 — 요금제 비교표·상점 플랫폼 요금제 화면이 쓴다. 키는 서버 판정의 기능 키와 같다(추가만 한다). 상위 요금제는 하위 요금제
- * 기능을 모두 포함한다
+ * 요금제 기능 키 값 — 요금제 비교표·상점 플랫폼 요금제 화면이 쓴다. 키는 서버 판정의 기능 키와 같다(추가만 한다 — 예외는 0.53에서 지운
+ * `limits.ai_credits_monthly`). 상위 요금제는 하위 요금제 기능을 모두 포함한다
  */
 export const planEntitlementsSchema = z
   .object({
@@ -24,6 +24,10 @@ export const planEntitlementsSchema = z
         "관리 API(개인 액세스 토큰·외부 앱 토큰 호출). 상점 플랫폼·CLI·MCP는 모든 요금제에서 쓴다",
       ),
     "features.analytics": z.boolean().describe("애널리틱스 화면·조회 API"),
+    "features.ai_assistant": z
+      .boolean()
+      .optional()
+      .describe("AI 상점 도우미. false면 새 실행을 시작할 수 없다(403 `PLAN_FEATURE_REQUIRED`)"),
     "limits.ai_reads_monthly": limitOrContract("MCP 읽기 월 한도"),
     "limits.ai_actions_monthly": limitOrContract(
       "MCP 쓰기(AI 작업) 월 한도 — 주문 처리는 막지 않는다",
@@ -34,9 +38,6 @@ export const planEntitlementsSchema = z
     "limits.private_apps": limitOrContract(
       "비공개 앱(이 상점 전용 앱) 설치 수(0이면 설치할 수 없다)",
     ),
-    "limits.ai_credits_monthly": limitOrContract(
-      "AI 상점 도우미 월 크레딧(1 크레딧 = 모델 원가 $0.01, 이월 없음)",
-    ),
     "limits.storefront_preview_hours_monthly": limitOrContract("편집 환경 시간(월, 시간)"),
     "limits.storefront_build_minutes_monthly": limitOrContract("빌드 시간(월, 분)"),
     "limits.storefront_requests_monthly": limitOrContract(

package/src/schemas/points.ts

@@ -180,6 +180,7 @@ export const POINT_LOT_SOURCES = [
   "ADJUST",
   "REFUND_RESTORE",
   "OPENING",
+  "COUPON",
 ] as const;
 export type PointLotSource = (typeof POINT_LOT_SOURCES)[number];
 
@@ -194,6 +195,7 @@ export const POINT_ENTRY_TYPES = [
   "EXPIRE",
   "ADJUST",
   "OPENING",
+  "EARN_COUPON",
 ] as const;
 export type PointEntryType = (typeof POINT_ENTRY_TYPES)[number];
 
@@ -257,7 +259,7 @@ export const responsePointEntryTypeSchema = z
   .describe(
     "유형. `EARN_REVIEW` 리뷰 적립 · `REVOKE_REVIEW` 리뷰 삭제 회수 · `EARN_PURCHASE` 구매 적립 · `EXPIRE` 소멸 · `ADJUST` 셀러 지급·차감 · " +
       "`OPENING` 기존 잔액 이전 · `USE_RESERVE` 결제 사용(결제 시작 때 빠짐) · `USE_RELEASE` 결제가 실패·만료되어 되돌림 · " +
-      "`REFUND_RESTORE` 취소·반품 환불로 반환. 값이 추가될 수 있어 문자열로 받는다",
+      "`REFUND_RESTORE` 취소·반품 환불로 반환 · `EARN_COUPON` 적립금 지급 쿠폰. 값이 추가될 수 있어 문자열로 받는다",
   );
 
 /** 원장 항목 — 셀러 조회용(사유·행위자 포함) */
@@ -283,7 +285,7 @@ export const pointLotSchema = z.object({
   lotId: z.string(),
   source: z
     .union([z.enum(POINT_LOT_SOURCES), z.string()])
-    .describe("출처. `REVIEW`·`PURCHASE`·`ADJUST`·`REFUND_RESTORE`·`OPENING` 등"),
+    .describe("출처. `REVIEW`·`PURCHASE`·`ADJUST`·`REFUND_RESTORE`·`OPENING`·`COUPON` 등"),
   amount: z.number().int().describe("적립한 금액"),
   remaining: z.number().int().describe("남은 금액"),
   expiresAt: z.string().nullable().describe("소멸 시각. null이면 소멸 없음"),