@sayren/store-sdk 0.30.3 → 0.30.4

package/dist/index.mjs

@@ -92,6 +92,7 @@ const writePreviewSchema = z.object({
 		type: z.string(),
 		id: z.string().nullable()
 	}),
+	targetName: z.string().nullable().optional().describe("대상 이름(상품명·쿠폰명·흐름 이름·구매자 이름 등). 읽을 수 없으면 null"),
 	changes: z.array(z.object({
 		field: z.string().describe("바뀌는 필드"),
 		before: z.unknown().describe("현재 값. 새로 만드는 요청이거나 읽을 수 없으면 null"),
@@ -119,6 +120,7 @@ const approvalRequestSchema = z.object({
 	approvalId: z.string().describe("승인 요청 ID"),
 	status: approvalStatusSchema,
 	operationId: z.string().describe("보류된 오퍼레이션 ID"),
+	operationName: z.string().nullable().optional().describe("작업 이름(예: 흐름 게시, 구매자 적립금 지급·차감). API 문서의 요약과 같다. 모르면 null"),
 	method: z.string().describe("HTTP 메서드"),
 	path: z.string().describe("요청 경로와 쿼리"),
 	body: z.unknown().describe("요청 본문. 승인하면 이 본문 그대로 실행한다. 없으면 null"),
@@ -1441,7 +1443,7 @@ const POINT_ADJUSTMENT_MAX = 1e7;
 const pointAdjustmentRequestSchema = z.object({
 	amount: z.number().int().min(-1e7).max(POINT_ADJUSTMENT_MAX).refine((value) => value !== 0, "0원은 조정할 수 없습니다").describe("지급은 양수, 차감은 음수(원)"),
 	reason: z.string().trim().min(1).max(200).describe("사유(필수). 구매자에게는 보이지 않는다"),
-	expiresAt: z.iso.datetime({ offset: true }).optional().describe("지급분의 소멸 시각. 생략하면 정책 유효 기간으로 정한다. 차감에는 주지 않는다")
+	expiresAt: z.iso.datetime({ offset: true }).optional().describe("지급분의 소멸 시각. 생략하면 정책 유효 기간(`expiryDays`)으로 정한다. **정책 유효 기간이 없으면 지급에 필수다**(없으면 400 `POINT_EXPIRY_REQUIRED`). 차감에는 주지 않는다")
 }).refine((value) => !(value.amount < 0 && value.expiresAt), {
 	message: "차감에는 소멸 시각을 줄 수 없습니다",
 	path: ["expiresAt"]
@@ -2742,8 +2744,8 @@ const commerceFlowSummarySchema = z.object({
 	flowId: z.string(),
 	key: z.string().describe("상점 안 유일한 키"),
 	name: z.string(),
-	progression: z.enum(["ITEM", "ORDER_GROUP"]),
-	fulfillmentMethods: z.array(z.string()),
+	progression: z.enum(["ITEM", "ORDER_GROUP"]).describe("진행 단위 — 지금 게시 버전의 값(초안 `definition.requires.progression`을 게시 때 고정한다). 주문상품은 주문 시점 버전의 값을 따른다"),
+	fulfillmentMethods: z.array(z.string()).describe("이행 방식 — 지금 게시 버전의 `definition.requires.fulfillmentMethods`"),
 	presetKey: z.string().nullable().describe("설치한 프리셋(설치 뒤 연결되지 않는다)"),
 	presetVersion: z.number().int().nullable(),
 	activeVersion: z.number().int().nullable().describe("게시된 버전. 새 주문이 따른다"),

package/package.json

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

package/src/schemas/audit.ts

@@ -155,6 +155,11 @@ export const writePreviewSchema = z.object({
   method: z.string(),
   path: z.string(),
   target: z.object({ type: z.string(), id: z.string().nullable() }),
+  targetName: z
+    .string()
+    .nullable()
+    .optional()
+    .describe("대상 이름(상품명·쿠폰명·흐름 이름·구매자 이름 등). 읽을 수 없으면 null"),
   changes: z
     .array(
       z.object({
@@ -195,6 +200,13 @@ export const approvalRequestSchema = z.object({
   approvalId: z.string().describe("승인 요청 ID"),
   status: approvalStatusSchema,
   operationId: z.string().describe("보류된 오퍼레이션 ID"),
+  operationName: z
+    .string()
+    .nullable()
+    .optional()
+    .describe(
+      "작업 이름(예: 흐름 게시, 구매자 적립금 지급·차감). API 문서의 요약과 같다. 모르면 null",
+    ),
   method: z.string().describe("HTTP 메서드"),
   path: z.string().describe("요청 경로와 쿼리"),
   body: z.unknown().describe("요청 본문. 승인하면 이 본문 그대로 실행한다. 없으면 null"),

package/src/schemas/commerce-flow.ts

@@ -214,8 +214,14 @@ export const commerceFlowSummarySchema = z.object({
   flowId: z.string(),
   key: z.string().describe("상점 안 유일한 키"),
   name: z.string(),
-  progression: z.enum(["ITEM", "ORDER_GROUP"]),
-  fulfillmentMethods: z.array(z.string()),
+  progression: z
+    .enum(["ITEM", "ORDER_GROUP"])
+    .describe(
+      "진행 단위 — 지금 게시 버전의 값(초안 `definition.requires.progression`을 게시 때 고정한다). 주문상품은 주문 시점 버전의 값을 따른다",
+    ),
+  fulfillmentMethods: z
+    .array(z.string())
+    .describe("이행 방식 — 지금 게시 버전의 `definition.requires.fulfillmentMethods`"),
   presetKey: z.string().nullable().describe("설치한 프리셋(설치 뒤 연결되지 않는다)"),
   presetVersion: z.number().int().nullable(),
   activeVersion: z.number().int().nullable().describe("게시된 버전. 새 주문이 따른다"),

package/src/schemas/points.ts

@@ -331,7 +331,9 @@ export const pointAdjustmentRequestSchema = z
     expiresAt: z.iso
       .datetime({ offset: true })
       .optional()
-      .describe("지급분의 소멸 시각. 생략하면 정책 유효 기간으로 정한다. 차감에는 주지 않는다"),
+      .describe(
+        "지급분의 소멸 시각. 생략하면 정책 유효 기간(`expiryDays`)으로 정한다. **정책 유효 기간이 없으면 지급에 필수다**(없으면 400 `POINT_EXPIRY_REQUIRED`). 차감에는 주지 않는다",
+      ),
   })
   .refine((value) => !(value.amount < 0 && value.expiresAt), {
     message: "차감에는 소멸 시각을 줄 수 없습니다",