@sayren/store-sdk 0.29.6 → 0.29.7

package/dist/index.d.mts

@@ -165,9 +165,9 @@ export declare const auditLogPageSchema: z.ZodObject<{
 }, z.core.$strip>;
 export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
 export declare const agentPolicyDecisionSchema: z.ZodEnum<{
-  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   DENIED: "DENIED";
   ALLOW: "ALLOW";
+  APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
 }>;
 export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
 export declare const writePreviewSchema: z.ZodObject<{
@@ -190,9 +190,9 @@ export type WritePreview = z.infer<typeof writePreviewSchema>;
 export declare const writeDryRunResultSchema: z.ZodObject<{
   dryRun: z.ZodLiteral<true>;
   decision: z.ZodEnum<{
-    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
     DENIED: "DENIED";
     ALLOW: "ALLOW";
+    APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
   }>;
   reason: z.ZodNullable<z.ZodString>;
   preview: z.ZodObject<{
@@ -2022,10 +2022,15 @@ export declare const couponStatusSchema: z.ZodEnum<{
   ENDED: "ENDED";
 }>;
 export type CouponStatus = z.infer<typeof couponStatusSchema>;
-/** 지금 만들 수 있는 발급 방식 — 다운로드·가입 자동 지급은 뒤 단계다 */
+/**
+ * 발급 방식 — 코드 입력·셀러 지급·다운로드(구매자가 받기)·회원가입 자동 지급(이슈 #110).
+ * 응답(`couponSchema.issueMethod`)은 값이 늘 수 있어 문자열로 받는다. 이 enum은 요청 검증용이다.
+ */
 export declare const couponIssueMethodSchema: z.ZodEnum<{
   MANUAL: "MANUAL";
   CODE: "CODE";
+  DOWNLOAD: "DOWNLOAD";
+  SIGNUP: "SIGNUP";
 }>;
 export type CouponIssueMethod = z.infer<typeof couponIssueMethodSchema>;
 /** 코드 형식 — 영문·숫자·`-`·`_` 6~30자. 대소문자를 구분하지 않고 서버가 대문자로 저장한다 */
@@ -2078,6 +2083,8 @@ export declare const createCouponRequestSchema: z.ZodObject<{
   issueMethod: z.ZodEnum<{
     MANUAL: "MANUAL";
     CODE: "CODE";
+    DOWNLOAD: "DOWNLOAD";
+    SIGNUP: "SIGNUP";
   }>;
   code: z.ZodOptional<z.ZodString>;
   startsAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
@@ -2196,6 +2203,8 @@ export declare const couponListQuerySchema: z.ZodObject<{
   issueMethod: z.ZodOptional<z.ZodEnum<{
     MANUAL: "MANUAL";
     CODE: "CODE";
+    DOWNLOAD: "DOWNLOAD";
+    SIGNUP: "SIGNUP";
   }>>;
   q: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -2206,6 +2215,7 @@ export declare const couponIssueSchema: z.ZodObject<{
   couponId: z.ZodString;
   customerId: z.ZodString;
   customerName: z.ZodNullable<z.ZodString>;
+  source: z.ZodOptional<z.ZodString>;
   status: z.ZodString;
   validFrom: z.ZodString;
   validUntil: z.ZodNullable<z.ZodString>;
@@ -2284,6 +2294,7 @@ export declare const customerCouponSchema: z.ZodObject<{
   couponId: z.ZodString;
   customerId: z.ZodString;
   customerName: z.ZodNullable<z.ZodString>;
+  source: z.ZodOptional<z.ZodString>;
   status: z.ZodString;
   validFrom: z.ZodString;
   validUntil: z.ZodNullable<z.ZodString>;
@@ -2384,8 +2395,8 @@ export type ConsentAction = z.infer<typeof consentActionSchema>;
  * `RECONSENT` 약관 개정 재동의 · `MEMBER_UPDATE` 구매자가 직접 변경 · `SELLER` 셀러가 처리
  */
 export declare const consentSourceSchema: z.ZodEnum<{
-  SELLER: "SELLER";
   SIGNUP: "SIGNUP";
+  SELLER: "SELLER";
   SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
   DELEGATED: "DELEGATED";
   RECONSENT: "RECONSENT";
@@ -2407,8 +2418,8 @@ export declare const customerConsentSchema: z.ZodObject<{
     AGREED: "AGREED";
   }>;
   source: z.ZodEnum<{
-    SELLER: "SELLER";
     SIGNUP: "SIGNUP";
+    SELLER: "SELLER";
     SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
     DELEGATED: "DELEGATED";
     RECONSENT: "RECONSENT";
@@ -10325,7 +10336,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         version: string | null;
         documentUrl: string | null;
         action: "WITHDRAWN" | "AGREED";
-        source: "SELLER" | "SIGNUP" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE";
+        source: "SIGNUP" | "SELLER" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE";
         occurredAt: string;
       }[];
     }>;
@@ -10348,6 +10359,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         value: number;
         maxDiscountAmount: number | null;
       };
+      source?: string | undefined;
     }[]>;
     withdraw: (customerId: string, body: WithdrawCustomerRequest) => Promise<void>;
   };
@@ -10669,6 +10681,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
         usedOrderId: string | null;
         issuedAt: string;
         revokedAt: string | null;
+        source?: string | undefined;
       }[];
     }>;
     redemptions: (couponId: string, params?: PageParams & {
@@ -10716,6 +10729,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
       usedOrderId: string | null;
       issuedAt: string;
       revokedAt: string | null;
+      source?: string | undefined;
     }>;
   };
   customerInquiries: {

package/dist/index.mjs

@@ -2984,8 +2984,16 @@ const couponStatusSchema = z.enum([
 	"PAUSED",
 	"ENDED"
 ]).describe("쿠폰 상태. `ACTIVE`=사용 중, `PAUSED`=중지(재개 가능), `ENDED`=종료(되돌릴 수 없음)");
-/** 지금 만들 수 있는 발급 방식 — 다운로드·가입 자동 지급은 뒤 단계다 */
-const couponIssueMethodSchema = z.enum(["CODE", "MANUAL"]).describe("발급 방식. `CODE`=구매자가 주문서에 코드를 입력한다, `MANUAL`=셀러가 회원을 골라 지급한다");
+/**
+* 발급 방식 — 코드 입력·셀러 지급·다운로드(구매자가 받기)·회원가입 자동 지급(이슈 #110).
+* 응답(`couponSchema.issueMethod`)은 값이 늘 수 있어 문자열로 받는다. 이 enum은 요청 검증용이다.
+*/
+const couponIssueMethodSchema = z.enum([
+	"CODE",
+	"MANUAL",
+	"DOWNLOAD",
+	"SIGNUP"
+]).describe("발급 방식. `CODE`=구매자가 주문서에 코드를 입력한다, `MANUAL`=셀러가 회원을 골라 지급한다, `DOWNLOAD`=구매자가 스토어프론트에서 받는다, `SIGNUP`=회원가입 때 자동으로 지급한다");
 /** 코드 형식 — 영문·숫자·`-`·`_` 6~30자. 대소문자를 구분하지 않고 서버가 대문자로 저장한다 */
 const COUPON_CODE_PATTERN = /^[A-Za-z0-9_-]{6,30}$/;
 /** 코드 정규화 — 대문자, 앞뒤 공백 제거. 입력·저장·조회가 같은 함수를 쓴다 */
@@ -2999,10 +3007,10 @@ const descriptions$1 = {
 	code: "쿠폰 코드 — 발급 방식이 `CODE`일 때 필수. 영문·숫자·`-`·`_` 6~30자, 대소문자 구분 없음(대문자로 저장). 상점 안에서 유일하다",
 	startsAt: "사용 시작 시각(ISO 8601, 시간대 포함). 생략하면 바로 쓸 수 있다",
 	endsAt: "사용 종료 시각(ISO 8601, 시간대 포함). 이 시각부터 못 쓴다. 생략하면 제한이 없다. 이미 지급한 쿠폰의 유효 기간은 지급 때 정해지므로 뒤에 종료일을 늦춰도 늘어나지 않는다",
-	validDaysAfterIssue: "발급 후 유효 일수 — 셀러 지급(`MANUAL`) 쿠폰만. 쿠폰 종료일과 둘 중 먼저 끝나는 쪽이 적용된다",
-	totalIssueLimit: "총 발급 수 한도. 생략하면 무제한",
+	validDaysAfterIssue: "발급 후 유효 일수 — 발급형(`MANUAL`·`DOWNLOAD`·`SIGNUP`) 쿠폰만. 쿠폰 종료일과 둘 중 먼저 끝나는 쪽이 적용된다",
+	totalIssueLimit: "총 발급 수 한도. 생략하면 무제한. 다운로드·회원가입 쿠폰은 한도에 닿으면 더 발급하지 않는다",
 	totalUseLimit: "총 사용 수 한도. 결제 중인 예약도 센다. 생략하면 무제한",
-	perMemberIssueLimit: "1인 발급 수 한도(셀러 지급). 생략하면 1인 1장",
+	perMemberIssueLimit: "1인 발급 수 한도(셀러 지급·다운로드). 생략하면 1인 1장. 회원가입 쿠폰은 1장 고정이라 1만 받는다",
 	perMemberUseLimit: "1인 사용 수 한도(코드 입력형). 생략하면 무제한. 비회원에게 여는 쿠폰은 둘 수 없다"
 };
 /** 조건 입력 — 생략한 항목은 기본값(`COUPON_CONDITIONS_DEFAULTS`)이다 */
@@ -3046,8 +3054,9 @@ const createCouponRequestSchema = z.strictObject({
 	if (body.issueMethod === "CODE" && !body.code) issue("code", "코드 입력형 쿠폰은 코드가 필요합니다");
 	if (body.issueMethod !== "CODE" && body.code) issue("code", "코드는 코드 입력형 쿠폰에만 둡니다");
 	if (body.issueMethod === "CODE" && body.validDaysAfterIssue != null) issue("validDaysAfterIssue", "발급 후 유효 일수는 셀러 지급 쿠폰에만 둡니다");
-	if (body.issueMethod === "CODE" && body.perMemberIssueLimit != null) issue("perMemberIssueLimit", "1인 발급 수 한도는 셀러 지급 쿠폰에만 둡니다");
-	if (body.issueMethod === "MANUAL" && body.perMemberUseLimit != null) issue("perMemberUseLimit", "셀러 지급 쿠폰은 발급 한 장이 한 번 쓰입니다. 1인 발급 수 한도를 쓰십시오");
+	if (body.issueMethod === "CODE" && body.perMemberIssueLimit != null) issue("perMemberIssueLimit", "1인 발급 수 한도는 발급형 쿠폰에만 둡니다");
+	if (body.issueMethod === "SIGNUP" && body.perMemberIssueLimit != null && body.perMemberIssueLimit !== 1) issue("perMemberIssueLimit", "회원가입 쿠폰은 1인 1장입니다");
+	if (body.issueMethod !== "CODE" && body.perMemberUseLimit != null) issue("perMemberUseLimit", "발급형 쿠폰은 발급 한 장이 한 번 쓰입니다. 1인 발급 수 한도를 사용하십시오");
 	if (!(body.conditions?.memberOnly ?? COUPON_CONDITIONS_DEFAULTS.memberOnly) && (body.issueMethod !== "CODE" || body.perMemberUseLimit != null)) issue("conditions", "비회원에게 여는 쿠폰은 코드 입력형이면서 1인 사용 한도가 없어야 합니다");
 	if (body.startsAt && body.endsAt && Date.parse(body.endsAt) <= Date.parse(body.startsAt)) issue("endsAt", "종료 시각은 시작 시각보다 뒤여야 합니다");
 });
@@ -3079,7 +3088,7 @@ const couponSchema = z.object({
 	benefit: couponBenefitSchema,
 	conditions: couponConditionsSchema,
 	target: couponTargetSchema,
-	issueMethod: z.string().describe("발급 방식. 현재 값은 `CODE`·`MANUAL`이고 값이 추가될 수 있어 문자열로 받는다(다운로드·가입 자동 지급 예정)"),
+	issueMethod: z.string().describe("발급 방식. 현재 값은 `CODE`·`MANUAL`·`DOWNLOAD`(구매자가 받기)·`SIGNUP`(회원가입 자동 지급)이고 값이 추가될 수 있어 문자열로 받는다"),
 	code: z.string().nullable().describe("쿠폰 코드(대문자). 코드 입력형이 아니면 null"),
 	startsAt: z.string().nullable(),
 	endsAt: z.string().nullable(),
@@ -3112,6 +3121,7 @@ const couponIssueSchema = z.object({
 	couponId: z.string(),
 	customerId: z.string(),
 	customerName: z.string().nullable().describe("구매자 이름. 탈퇴한 구매자는 null"),
+	source: z.string().optional().describe("발급 경로(이슈 #110). 현재 값은 `MANUAL`(셀러 지급)·`DOWNLOAD`(구매자가 받음)·`SIGNUP`(회원가입 자동 지급)이고 값이 추가될 수 있다. 서버는 항상 싣는다"),
 	status: couponIssueStatusSchema,
 	validFrom: z.string(),
 	validUntil: z.string().nullable(),

package/package.json

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

package/src/schemas/coupon.ts

@@ -23,11 +23,15 @@ export const couponStatusSchema = z
   .describe("쿠폰 상태. `ACTIVE`=사용 중, `PAUSED`=중지(재개 가능), `ENDED`=종료(되돌릴 수 없음)");
 export type CouponStatus = z.infer<typeof couponStatusSchema>;
 
-/** 지금 만들 수 있는 발급 방식 — 다운로드·가입 자동 지급은 뒤 단계다 */
+/**
+ * 발급 방식 — 코드 입력·셀러 지급·다운로드(구매자가 받기)·회원가입 자동 지급(이슈 #110).
+ * 응답(`couponSchema.issueMethod`)은 값이 늘 수 있어 문자열로 받는다. 이 enum은 요청 검증용이다.
+ */
 export const couponIssueMethodSchema = z
-  .enum(["CODE", "MANUAL"])
+  .enum(["CODE", "MANUAL", "DOWNLOAD", "SIGNUP"])
   .describe(
-    "발급 방식. `CODE`=구매자가 주문서에 코드를 입력한다, `MANUAL`=셀러가 회원을 골라 지급한다",
+    "발급 방식. `CODE`=구매자가 주문서에 코드를 입력한다, `MANUAL`=셀러가 회원을 골라 지급한다, " +
+      "`DOWNLOAD`=구매자가 스토어프론트에서 받는다, `SIGNUP`=회원가입 때 자동으로 지급한다",
   );
 export type CouponIssueMethod = z.infer<typeof couponIssueMethodSchema>;
 
@@ -51,10 +55,12 @@ const descriptions = {
     "사용 종료 시각(ISO 8601, 시간대 포함). 이 시각부터 못 쓴다. 생략하면 제한이 없다. " +
     "이미 지급한 쿠폰의 유효 기간은 지급 때 정해지므로 뒤에 종료일을 늦춰도 늘어나지 않는다",
   validDaysAfterIssue:
-    "발급 후 유효 일수 — 셀러 지급(`MANUAL`) 쿠폰만. 쿠폰 종료일과 둘 중 먼저 끝나는 쪽이 적용된다",
-  totalIssueLimit: "총 발급 수 한도. 생략하면 무제한",
+    "발급 후 유효 일수 — 발급형(`MANUAL`·`DOWNLOAD`·`SIGNUP`) 쿠폰만. 쿠폰 종료일과 둘 중 먼저 끝나는 쪽이 적용된다",
+  totalIssueLimit:
+    "총 발급 수 한도. 생략하면 무제한. 다운로드·회원가입 쿠폰은 한도에 닿으면 더 발급하지 않는다",
   totalUseLimit: "총 사용 수 한도. 결제 중인 예약도 센다. 생략하면 무제한",
-  perMemberIssueLimit: "1인 발급 수 한도(셀러 지급). 생략하면 1인 1장",
+  perMemberIssueLimit:
+    "1인 발급 수 한도(셀러 지급·다운로드). 생략하면 1인 1장. 회원가입 쿠폰은 1장 고정이라 1만 받는다",
   perMemberUseLimit:
     "1인 사용 수 한도(코드 입력형). 생략하면 무제한. 비회원에게 여는 쿠폰은 둘 수 없다",
 } as const;
@@ -117,12 +123,19 @@ export const createCouponRequestSchema = z
       issue("validDaysAfterIssue", "발급 후 유효 일수는 셀러 지급 쿠폰에만 둡니다");
     }
     if (body.issueMethod === "CODE" && body.perMemberIssueLimit != null) {
-      issue("perMemberIssueLimit", "1인 발급 수 한도는 셀러 지급 쿠폰에만 둡니다");
+      issue("perMemberIssueLimit", "1인 발급 수 한도는 발급형 쿠폰에만 둡니다");
+    }
+    if (
+      body.issueMethod === "SIGNUP" &&
+      body.perMemberIssueLimit != null &&
+      body.perMemberIssueLimit !== 1
+    ) {
+      issue("perMemberIssueLimit", "회원가입 쿠폰은 1인 1장입니다");
     }
-    if (body.issueMethod === "MANUAL" && body.perMemberUseLimit != null) {
+    if (body.issueMethod !== "CODE" && body.perMemberUseLimit != null) {
       issue(
         "perMemberUseLimit",
-        "셀러 지급 쿠폰은 발급 한 장이 한 번 쓰입니다. 1인 발급 수 한도를 쓰십시오",
+        "발급형 쿠폰은 발급 한 장이 한 번 쓰입니다. 1인 발급 수 한도를 사용하십시오",
       );
     }
     const memberOnly = body.conditions?.memberOnly ?? COUPON_CONDITIONS_DEFAULTS.memberOnly;
@@ -168,7 +181,7 @@ export const couponSchema = z.object({
   issueMethod: z
     .string()
     .describe(
-      "발급 방식. 현재 값은 `CODE`·`MANUAL`이고 값이 추가될 수 있어 문자열로 받는다(다운로드·가입 자동 지급 예정)",
+      "발급 방식. 현재 값은 `CODE`·`MANUAL`·`DOWNLOAD`(구매자가 받기)·`SIGNUP`(회원가입 자동 지급)이고 값이 추가될 수 있어 문자열로 받는다",
     ),
   code: z.string().nullable().describe("쿠폰 코드(대문자). 코드 입력형이 아니면 null"),
   startsAt: z.string().nullable(),
@@ -214,6 +227,12 @@ export const couponIssueSchema = z.object({
   couponId: z.string(),
   customerId: z.string(),
   customerName: z.string().nullable().describe("구매자 이름. 탈퇴한 구매자는 null"),
+  source: z
+    .string()
+    .optional()
+    .describe(
+      "발급 경로(이슈 #110). 현재 값은 `MANUAL`(셀러 지급)·`DOWNLOAD`(구매자가 받음)·`SIGNUP`(회원가입 자동 지급)이고 값이 추가될 수 있다. 서버는 항상 싣는다",
+    ),
   status: couponIssueStatusSchema,
   validFrom: z.string(),
   validUntil: z.string().nullable(),