@sayren/store-sdk 0.29.1 → 0.29.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (11) hide show
  1. package/dist/index.d.mts +687 -208
  2. package/dist/index.mjs +333 -24
  3. package/package.json +1 -1
  4. package/src/client.ts +9 -1
  5. package/src/schemas/claim.ts +18 -0
  6. package/src/schemas/collection.ts +258 -11
  7. package/src/schemas/order.ts +26 -0
  8. package/src/schemas/payment.ts +7 -1
  9. package/src/schemas/points.ts +111 -3
  10. package/src/schemas/promotion.ts +140 -4
  11. package/src/schemas/webhook-event.ts +26 -0
package/dist/index.d.mts CHANGED
@@ -33,8 +33,8 @@ export declare const auditLogSourceSchema: z.ZodEnum<{
33
33
  }>;
34
34
  export type AuditLogSource = z.infer<typeof auditLogSourceSchema>;
35
35
  export declare const auditLogOutcomeSchema: z.ZodEnum<{
36
- SUCCEEDED: "SUCCEEDED";
37
36
  FAILED: "FAILED";
37
+ SUCCEEDED: "SUCCEEDED";
38
38
  PENDING_APPROVAL: "PENDING_APPROVAL";
39
39
  DENIED: "DENIED";
40
40
  DRY_RUN: "DRY_RUN";
@@ -69,8 +69,8 @@ export declare const auditLogSchema: z.ZodObject<{
69
69
  path: z.ZodNullable<z.ZodString>;
70
70
  statusCode: z.ZodNullable<z.ZodNumber>;
71
71
  outcome: z.ZodNullable<z.ZodEnum<{
72
- SUCCEEDED: "SUCCEEDED";
73
72
  FAILED: "FAILED";
73
+ SUCCEEDED: "SUCCEEDED";
74
74
  PENDING_APPROVAL: "PENDING_APPROVAL";
75
75
  DENIED: "DENIED";
76
76
  DRY_RUN: "DRY_RUN";
@@ -102,8 +102,8 @@ export declare const auditLogListQuerySchema: z.ZodObject<{
102
102
  DOMAIN: "DOMAIN";
103
103
  }>>;
104
104
  outcome: z.ZodOptional<z.ZodEnum<{
105
- SUCCEEDED: "SUCCEEDED";
106
105
  FAILED: "FAILED";
106
+ SUCCEEDED: "SUCCEEDED";
107
107
  PENDING_APPROVAL: "PENDING_APPROVAL";
108
108
  DENIED: "DENIED";
109
109
  DRY_RUN: "DRY_RUN";
@@ -149,8 +149,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
149
149
  path: z.ZodNullable<z.ZodString>;
150
150
  statusCode: z.ZodNullable<z.ZodNumber>;
151
151
  outcome: z.ZodNullable<z.ZodEnum<{
152
- SUCCEEDED: "SUCCEEDED";
153
152
  FAILED: "FAILED";
153
+ SUCCEEDED: "SUCCEEDED";
154
154
  PENDING_APPROVAL: "PENDING_APPROVAL";
155
155
  DENIED: "DENIED";
156
156
  DRY_RUN: "DRY_RUN";
@@ -165,9 +165,9 @@ export declare const auditLogPageSchema: z.ZodObject<{
165
165
  }, z.core.$strip>;
166
166
  export type AuditLogPage = z.infer<typeof auditLogPageSchema>;
167
167
  export declare const agentPolicyDecisionSchema: z.ZodEnum<{
168
+ APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
168
169
  DENIED: "DENIED";
169
170
  ALLOW: "ALLOW";
170
- APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
171
171
  }>;
172
172
  export type AgentPolicyDecision = z.infer<typeof agentPolicyDecisionSchema>;
173
173
  export declare const writePreviewSchema: z.ZodObject<{
@@ -190,9 +190,9 @@ export type WritePreview = z.infer<typeof writePreviewSchema>;
190
190
  export declare const writeDryRunResultSchema: z.ZodObject<{
191
191
  dryRun: z.ZodLiteral<true>;
192
192
  decision: z.ZodEnum<{
193
+ APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
193
194
  DENIED: "DENIED";
194
195
  ALLOW: "ALLOW";
195
- APPROVAL_REQUIRED: "APPROVAL_REQUIRED";
196
196
  }>;
197
197
  reason: z.ZodNullable<z.ZodString>;
198
198
  preview: z.ZodObject<{
@@ -213,11 +213,11 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
213
213
  }, z.core.$strip>;
214
214
  export type WriteDryRunResult = z.infer<typeof writeDryRunResultSchema>;
215
215
  export declare const approvalStatusSchema: z.ZodEnum<{
216
- UNKNOWN: "UNKNOWN";
217
- SUCCEEDED: "SUCCEEDED";
218
- FAILED: "FAILED";
219
216
  PENDING: "PENDING";
217
+ FAILED: "FAILED";
218
+ SUCCEEDED: "SUCCEEDED";
220
219
  EXECUTING: "EXECUTING";
220
+ UNKNOWN: "UNKNOWN";
221
221
  REJECTED: "REJECTED";
222
222
  EXPIRED: "EXPIRED";
223
223
  }>;
@@ -225,11 +225,11 @@ export type ApprovalStatus = z.infer<typeof approvalStatusSchema>;
225
225
  export declare const approvalRequestSchema: z.ZodObject<{
226
226
  approvalId: z.ZodString;
227
227
  status: z.ZodEnum<{
228
- UNKNOWN: "UNKNOWN";
229
- SUCCEEDED: "SUCCEEDED";
230
- FAILED: "FAILED";
231
228
  PENDING: "PENDING";
229
+ FAILED: "FAILED";
230
+ SUCCEEDED: "SUCCEEDED";
232
231
  EXECUTING: "EXECUTING";
232
+ UNKNOWN: "UNKNOWN";
233
233
  REJECTED: "REJECTED";
234
234
  EXPIRED: "EXPIRED";
235
235
  }>;
@@ -287,11 +287,11 @@ export declare const approvalRequestSchema: z.ZodObject<{
287
287
  export type ApprovalRequest = z.infer<typeof approvalRequestSchema>;
288
288
  export declare const approvalListQuerySchema: z.ZodObject<{
289
289
  status: z.ZodOptional<z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>, z.ZodTransform<string[], string | string[]>>, z.ZodArray<z.ZodEnum<{
290
- UNKNOWN: "UNKNOWN";
291
- SUCCEEDED: "SUCCEEDED";
292
- FAILED: "FAILED";
293
290
  PENDING: "PENDING";
291
+ FAILED: "FAILED";
292
+ SUCCEEDED: "SUCCEEDED";
294
293
  EXECUTING: "EXECUTING";
294
+ UNKNOWN: "UNKNOWN";
295
295
  REJECTED: "REJECTED";
296
296
  EXPIRED: "EXPIRED";
297
297
  }>>>>;
@@ -306,11 +306,11 @@ export declare const approvalPageSchema: z.ZodObject<{
306
306
  items: z.ZodArray<z.ZodObject<{
307
307
  approvalId: z.ZodString;
308
308
  status: z.ZodEnum<{
309
- UNKNOWN: "UNKNOWN";
310
- SUCCEEDED: "SUCCEEDED";
311
- FAILED: "FAILED";
312
309
  PENDING: "PENDING";
310
+ FAILED: "FAILED";
311
+ SUCCEEDED: "SUCCEEDED";
313
312
  EXECUTING: "EXECUTING";
313
+ UNKNOWN: "UNKNOWN";
314
314
  REJECTED: "REJECTED";
315
315
  EXPIRED: "EXPIRED";
316
316
  }>;
@@ -448,11 +448,11 @@ export declare const analyticsTotalsSchema: z.ZodObject<{
448
448
  export type AnalyticsTotals = z.infer<typeof analyticsTotalsSchema>;
449
449
  export declare const analyticsFunnelStepSchema: z.ZodObject<{
450
450
  step: z.ZodEnum<{
451
+ PURCHASE: "PURCHASE";
451
452
  SESSION: "SESSION";
452
453
  PRODUCT_VIEW: "PRODUCT_VIEW";
453
454
  ADD_TO_CART: "ADD_TO_CART";
454
455
  BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
455
- PURCHASE: "PURCHASE";
456
456
  }>;
457
457
  sessions: z.ZodNumber;
458
458
  rateFromPrevious: z.ZodNullable<z.ZodNumber>;
@@ -477,11 +477,11 @@ export declare const analyticsOverviewSchema: z.ZodObject<{
477
477
  }, z.core.$strip>;
478
478
  funnel: z.ZodArray<z.ZodObject<{
479
479
  step: z.ZodEnum<{
480
+ PURCHASE: "PURCHASE";
480
481
  SESSION: "SESSION";
481
482
  PRODUCT_VIEW: "PRODUCT_VIEW";
482
483
  ADD_TO_CART: "ADD_TO_CART";
483
484
  BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
484
- PURCHASE: "PURCHASE";
485
485
  }>;
486
486
  sessions: z.ZodNumber;
487
487
  rateFromPrevious: z.ZodNullable<z.ZodNumber>;
@@ -581,20 +581,20 @@ export declare const analyticsProductsSchema: z.ZodObject<{
581
581
  }, z.core.$strip>;
582
582
  export type AnalyticsProducts = z.infer<typeof analyticsProductsSchema>;
583
583
  export declare const analyticsChannelSchema: z.ZodEnum<{
584
+ PAID: "PAID";
584
585
  DIRECT: "DIRECT";
586
+ CAMPAIGN: "CAMPAIGN";
587
+ UNKNOWN: "UNKNOWN";
585
588
  ORGANIC_SEARCH: "ORGANIC_SEARCH";
586
589
  SOCIAL: "SOCIAL";
587
- PAID: "PAID";
588
590
  EMAIL: "EMAIL";
589
- CAMPAIGN: "CAMPAIGN";
590
591
  REFERRAL: "REFERRAL";
591
- UNKNOWN: "UNKNOWN";
592
592
  }>;
593
593
  export type AnalyticsChannel = z.infer<typeof analyticsChannelSchema>;
594
594
  export declare const analyticsSourceGroupBySchema: z.ZodEnum<{
595
- CAMPAIGN: "CAMPAIGN";
596
595
  CHANNEL: "CHANNEL";
597
596
  SOURCE: "SOURCE";
597
+ CAMPAIGN: "CAMPAIGN";
598
598
  DEVICE: "DEVICE";
599
599
  }>;
600
600
  export type AnalyticsSourceGroupBy = z.infer<typeof analyticsSourceGroupBySchema>;
@@ -606,23 +606,23 @@ export declare const analyticsSourcesQuerySchema: z.ZodObject<{
606
606
  false: "false";
607
607
  }>>;
608
608
  groupBy: z.ZodOptional<z.ZodEnum<{
609
- CAMPAIGN: "CAMPAIGN";
610
609
  CHANNEL: "CHANNEL";
611
610
  SOURCE: "SOURCE";
611
+ CAMPAIGN: "CAMPAIGN";
612
612
  DEVICE: "DEVICE";
613
613
  }>>;
614
614
  }, z.core.$strip>;
615
615
  export type AnalyticsSourcesParams = z.infer<typeof analyticsSourcesQuerySchema>;
616
616
  export declare const analyticsSourceRowSchema: z.ZodObject<{
617
617
  channel: z.ZodNullable<z.ZodEnum<{
618
+ PAID: "PAID";
618
619
  DIRECT: "DIRECT";
620
+ CAMPAIGN: "CAMPAIGN";
621
+ UNKNOWN: "UNKNOWN";
619
622
  ORGANIC_SEARCH: "ORGANIC_SEARCH";
620
623
  SOCIAL: "SOCIAL";
621
- PAID: "PAID";
622
624
  EMAIL: "EMAIL";
623
- CAMPAIGN: "CAMPAIGN";
624
625
  REFERRAL: "REFERRAL";
625
- UNKNOWN: "UNKNOWN";
626
626
  }>>;
627
627
  source: z.ZodNullable<z.ZodString>;
628
628
  medium: z.ZodNullable<z.ZodString>;
@@ -644,21 +644,21 @@ export declare const analyticsSourceRowSchema: z.ZodObject<{
644
644
  export type AnalyticsSourceRow = z.infer<typeof analyticsSourceRowSchema>;
645
645
  export declare const analyticsSourcesSchema: z.ZodObject<{
646
646
  groupBy: z.ZodEnum<{
647
- CAMPAIGN: "CAMPAIGN";
648
647
  CHANNEL: "CHANNEL";
649
648
  SOURCE: "SOURCE";
649
+ CAMPAIGN: "CAMPAIGN";
650
650
  DEVICE: "DEVICE";
651
651
  }>;
652
652
  rows: z.ZodArray<z.ZodObject<{
653
653
  channel: z.ZodNullable<z.ZodEnum<{
654
+ PAID: "PAID";
654
655
  DIRECT: "DIRECT";
656
+ CAMPAIGN: "CAMPAIGN";
657
+ UNKNOWN: "UNKNOWN";
655
658
  ORGANIC_SEARCH: "ORGANIC_SEARCH";
656
659
  SOCIAL: "SOCIAL";
657
- PAID: "PAID";
658
660
  EMAIL: "EMAIL";
659
- CAMPAIGN: "CAMPAIGN";
660
661
  REFERRAL: "REFERRAL";
661
- UNKNOWN: "UNKNOWN";
662
662
  }>>;
663
663
  source: z.ZodNullable<z.ZodString>;
664
664
  medium: z.ZodNullable<z.ZodString>;
@@ -807,12 +807,12 @@ export declare const analyticsSearchSchema: z.ZodObject<{
807
807
  }, z.core.$strip>;
808
808
  export type AnalyticsSearch = z.infer<typeof analyticsSearchSchema>;
809
809
  export declare const analyticsCheckoutOutcomeSchema: z.ZodEnum<{
810
+ OTHER: "OTHER";
810
811
  COMPLETED: "COMPLETED";
811
812
  NOT_OPENED: "NOT_OPENED";
812
813
  USER_CANCELED: "USER_CANCELED";
813
814
  DECLINED: "DECLINED";
814
815
  PREPARE_FAILURE: "PREPARE_FAILURE";
815
- OTHER: "OTHER";
816
816
  IN_PROGRESS: "IN_PROGRESS";
817
817
  }>;
818
818
  export type AnalyticsCheckoutOutcome = z.infer<typeof analyticsCheckoutOutcomeSchema>;
@@ -820,12 +820,12 @@ export declare const analyticsCheckoutSchema: z.ZodObject<{
820
820
  sessions: z.ZodNumber;
821
821
  outcomes: z.ZodArray<z.ZodObject<{
822
822
  outcome: z.ZodEnum<{
823
+ OTHER: "OTHER";
823
824
  COMPLETED: "COMPLETED";
824
825
  NOT_OPENED: "NOT_OPENED";
825
826
  USER_CANCELED: "USER_CANCELED";
826
827
  DECLINED: "DECLINED";
827
828
  PREPARE_FAILURE: "PREPARE_FAILURE";
828
- OTHER: "OTHER";
829
829
  IN_PROGRESS: "IN_PROGRESS";
830
830
  }>;
831
831
  sessions: z.ZodNumber;
@@ -1264,7 +1264,6 @@ export declare const claimTypeSchema: z.ZodEnum<{
1264
1264
  }>;
1265
1265
  export type ClaimType = z.infer<typeof claimTypeSchema>;
1266
1266
  export declare const claimStatusSchema: z.ZodEnum<{
1267
- COMPLETED: "COMPLETED";
1268
1267
  REJECTED: "REJECTED";
1269
1268
  REQUESTED: "REQUESTED";
1270
1269
  HELD: "HELD";
@@ -1272,6 +1271,7 @@ export declare const claimStatusSchema: z.ZodEnum<{
1272
1271
  COLLECTED: "COLLECTED";
1273
1272
  REDELIVERING: "REDELIVERING";
1274
1273
  APPROVED: "APPROVED";
1274
+ COMPLETED: "COMPLETED";
1275
1275
  WITHDRAWN: "WITHDRAWN";
1276
1276
  }>;
1277
1277
  export type ClaimStatus = z.infer<typeof claimStatusSchema>;
@@ -1308,7 +1308,6 @@ export declare const claimSchema: z.ZodObject<{
1308
1308
  CANCEL: "CANCEL";
1309
1309
  }>;
1310
1310
  status: z.ZodEnum<{
1311
- COMPLETED: "COMPLETED";
1312
1311
  REJECTED: "REJECTED";
1313
1312
  REQUESTED: "REQUESTED";
1314
1313
  HELD: "HELD";
@@ -1316,6 +1315,7 @@ export declare const claimSchema: z.ZodObject<{
1316
1315
  COLLECTED: "COLLECTED";
1317
1316
  REDELIVERING: "REDELIVERING";
1318
1317
  APPROVED: "APPROVED";
1318
+ COMPLETED: "COMPLETED";
1319
1319
  WITHDRAWN: "WITHDRAWN";
1320
1320
  }>;
1321
1321
  orderId: z.ZodString;
@@ -1338,6 +1338,7 @@ export declare const claimSchema: z.ZodObject<{
1338
1338
  claimDeliveryFee: z.ZodNumber;
1339
1339
  expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
1340
1340
  expectedDeliveryFeeRefundAmount: z.ZodNullable<z.ZodNumber>;
1341
+ expectedPointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1341
1342
  exchangeOption: z.ZodNullable<z.ZodObject<{
1342
1343
  optionId: z.ZodString;
1343
1344
  optionName: z.ZodString;
@@ -1396,7 +1397,6 @@ export declare const claimDetailSchema: z.ZodObject<{
1396
1397
  CANCEL: "CANCEL";
1397
1398
  }>;
1398
1399
  status: z.ZodEnum<{
1399
- COMPLETED: "COMPLETED";
1400
1400
  REJECTED: "REJECTED";
1401
1401
  REQUESTED: "REQUESTED";
1402
1402
  HELD: "HELD";
@@ -1404,6 +1404,7 @@ export declare const claimDetailSchema: z.ZodObject<{
1404
1404
  COLLECTED: "COLLECTED";
1405
1405
  REDELIVERING: "REDELIVERING";
1406
1406
  APPROVED: "APPROVED";
1407
+ COMPLETED: "COMPLETED";
1407
1408
  WITHDRAWN: "WITHDRAWN";
1408
1409
  }>;
1409
1410
  orderId: z.ZodString;
@@ -1426,6 +1427,7 @@ export declare const claimDetailSchema: z.ZodObject<{
1426
1427
  claimDeliveryFee: z.ZodNumber;
1427
1428
  expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
1428
1429
  expectedDeliveryFeeRefundAmount: z.ZodNullable<z.ZodNumber>;
1430
+ expectedPointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1429
1431
  exchangeOption: z.ZodNullable<z.ZodObject<{
1430
1432
  optionId: z.ZodString;
1431
1433
  optionName: z.ZodString;
@@ -1453,7 +1455,6 @@ export declare const claimDetailSchema: z.ZodObject<{
1453
1455
  }, z.core.$strip>>;
1454
1456
  histories: z.ZodOptional<z.ZodArray<z.ZodObject<{
1455
1457
  status: z.ZodEnum<{
1456
- COMPLETED: "COMPLETED";
1457
1458
  REJECTED: "REJECTED";
1458
1459
  REQUESTED: "REQUESTED";
1459
1460
  HELD: "HELD";
@@ -1461,6 +1462,7 @@ export declare const claimDetailSchema: z.ZodObject<{
1461
1462
  COLLECTED: "COLLECTED";
1462
1463
  REDELIVERING: "REDELIVERING";
1463
1464
  APPROVED: "APPROVED";
1465
+ COMPLETED: "COMPLETED";
1464
1466
  WITHDRAWN: "WITHDRAWN";
1465
1467
  }>;
1466
1468
  actor: z.ZodEnum<{
@@ -1499,6 +1501,7 @@ export declare const approveClaimResultSchema: z.ZodObject<{
1499
1501
  deliveryFeeChargeAmount: z.ZodNumber;
1500
1502
  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1501
1503
  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1504
+ pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
1502
1505
  refundedAt: z.ZodString;
1503
1506
  }, z.core.$strip>;
1504
1507
  export type ApproveClaimResult = z.infer<typeof approveClaimResultSchema>;
@@ -1508,8 +1511,8 @@ export type ApproveClaimResult = z.infer<typeof approveClaimResultSchema>;
1508
1511
  * 컬렉션 (이슈 #83) — 상품을 어디에 보여 줄지 정하는 묶음이다. 카테고리는 상품이 무엇인지를 정하고 상품당 하나지만, 컬렉션은
1509
1512
  * 다대다다. 이벤트·기획전은 기간이 있는 직접 선택 컬렉션이다. 권한은 카테고리와 같다(`category:r`·`category:rw`).
1510
1513
  *
1511
- * 유형은 만들 때 정하고 바꿀 수 없다. 지금은 직접 선택(`MANUAL`)만 만들 수 있다. 조건 자동(`AUTOMATIC`)은 다음 단계에서 열리고,
1512
- * 응답의 `type`은 값이 늘 수 있어 문자열이다.
1514
+ * 유형은 만들 때 정하고 바꿀 수 없다. 직접 선택(`MANUAL`)은 셀러가 상품을 담고 순서를 정하고, 조건 자동(`AUTOMATIC`)은 조건(`rules`)을
1515
+ * 모두 만족하는 판매 중 상품을 조회할 때마다 계산한다(결과를 저장하지 않는다). 응답의 `type`은 값이 늘 수 있어 문자열이다.
1513
1516
  */
1514
1517
  /** 상점당 컬렉션 최대 개수 — 넘으면 409 `COLLECTION_LIMIT_EXCEEDED` */
1515
1518
  export declare const MAX_COLLECTIONS = 200;
@@ -1523,7 +1526,7 @@ export declare const MAX_COLLECTION_TITLE = 60;
1523
1526
  export declare const MAX_COLLECTION_DESCRIPTION = 500;
1524
1527
  /** 주소(slug) 형식 — 영문 소문자·숫자·하이픈, 첫 글자는 영문 소문자나 숫자, 64자까지 */
1525
1528
  export declare const COLLECTION_SLUG_PATTERN: RegExp;
1526
- /** 유형 — `MANUAL`(직접 선택)·`AUTOMATIC`(조건 자동, 아직 만들 수 없다) */
1529
+ /** 유형 — `MANUAL`(직접 선택)·`AUTOMATIC`(조건 자동) */
1527
1530
  export declare const COLLECTION_TYPES: readonly ["MANUAL", "AUTOMATIC"];
1528
1531
  export type CollectionType = (typeof COLLECTION_TYPES)[number];
1529
1532
  /**
@@ -1555,6 +1558,98 @@ export declare function collectionStateOf(collection: {
1555
1558
  startsAt: string | null;
1556
1559
  endsAt: string | null;
1557
1560
  }, now: Date): CollectionState;
1561
+ /** 조건 자동 컬렉션의 조건 최대 개수 */
1562
+ export declare const MAX_COLLECTION_RULES = 10;
1563
+ /** 카테고리 조건 하나에 넣는 카테고리 최대 개수 */
1564
+ export declare const MAX_COLLECTION_RULE_CATEGORIES = 20;
1565
+ /** 등록일 조건의 최대 일수 */
1566
+ export declare const MAX_COLLECTION_CREATED_WITHIN_DAYS = 365;
1567
+ /** 미리보기(`POST /v1/collections/preview`)가 싣는 상품 최대 개수 */
1568
+ export declare const COLLECTION_PREVIEW_SIZE = 20;
1569
+ /**
1570
+ * 조건 하나 — `field`로 가른다. 가격은 즉시할인을 반영한 판매가(`discountedPrice ?? salePrice`)다.
1571
+ * 판매량 상위(`bestSelling`)는 판매량 집계가 열릴 때 더한다.
1572
+ */
1573
+ export declare const collectionRuleSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
1574
+ field: z.ZodLiteral<"createdWithinDays">;
1575
+ value: z.ZodNumber;
1576
+ }, z.core.$strip>, z.ZodObject<{
1577
+ field: z.ZodLiteral<"category">;
1578
+ categoryIds: z.ZodArray<z.ZodString>;
1579
+ }, z.core.$strip>, z.ZodObject<{
1580
+ field: z.ZodLiteral<"price">;
1581
+ min: z.ZodOptional<z.ZodNumber>;
1582
+ max: z.ZodOptional<z.ZodNumber>;
1583
+ }, z.core.$strip>, z.ZodObject<{
1584
+ field: z.ZodLiteral<"discounted">;
1585
+ value: z.ZodLiteral<true>;
1586
+ }, z.core.$strip>], "field">;
1587
+ export type CollectionRule = z.infer<typeof collectionRuleSchema>;
1588
+ export type CollectionRuleField = CollectionRule["field"];
1589
+ /** 조건 목록 — 모두 만족해야 한다(AND). 같은 `field`는 한 번만 쓴다 */
1590
+ export declare const collectionRulesSchema: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
1591
+ field: z.ZodLiteral<"createdWithinDays">;
1592
+ value: z.ZodNumber;
1593
+ }, z.core.$strip>, z.ZodObject<{
1594
+ field: z.ZodLiteral<"category">;
1595
+ categoryIds: z.ZodArray<z.ZodString>;
1596
+ }, z.core.$strip>, z.ZodObject<{
1597
+ field: z.ZodLiteral<"price">;
1598
+ min: z.ZodOptional<z.ZodNumber>;
1599
+ max: z.ZodOptional<z.ZodNumber>;
1600
+ }, z.core.$strip>, z.ZodObject<{
1601
+ field: z.ZodLiteral<"discounted">;
1602
+ value: z.ZodLiteral<true>;
1603
+ }, z.core.$strip>], "field">>;
1604
+ /**
1605
+ * 응답의 조건 — 이 SDK가 아는 조건이거나 뒤에 더해질 조건(`field`만 확인한다)이다. 새 조건이 생겨도 옛 SDK의 응답 검증이 깨지지 않는다.
1606
+ */
1607
+ export declare const collectionRuleViewSchema: z.ZodUnion<readonly [z.ZodObject<{
1608
+ field: z.ZodLiteral<"createdWithinDays">;
1609
+ value: z.ZodNumber;
1610
+ }, z.core.$strip>, z.ZodObject<{
1611
+ field: z.ZodLiteral<"category">;
1612
+ categoryIds: z.ZodArray<z.ZodString>;
1613
+ }, z.core.$strip>, z.ZodObject<{
1614
+ field: z.ZodLiteral<"price">;
1615
+ min: z.ZodOptional<z.ZodNumber>;
1616
+ max: z.ZodOptional<z.ZodNumber>;
1617
+ }, z.core.$strip>, z.ZodObject<{
1618
+ field: z.ZodLiteral<"discounted">;
1619
+ value: z.ZodLiteral<true>;
1620
+ }, z.core.$strip>, z.ZodObject<{
1621
+ field: z.ZodString;
1622
+ }, z.core.$loose>]>;
1623
+ export type CollectionRuleView = z.infer<typeof collectionRuleViewSchema>;
1624
+ /** 조건 판정에 쓰는 상품 값 — 즉시할인가는 호출부가 계산해 넘긴다 */
1625
+ export interface CollectionRuleProduct {
1626
+ createdAt: string;
1627
+ categoryId: string | null;
1628
+ salePrice: number;
1629
+ /** 지금 적용되는 즉시할인가. 할인이 없으면 null */
1630
+ discountedPrice: number | null;
1631
+ }
1632
+ export interface CollectionRuleContext {
1633
+ /** 판정 시각 — 등록일 조건의 기준이다 */
1634
+ now: Date;
1635
+ /** 상점 카테고리(부모 관계) — 카테고리 조건의 하위 포함 판정에 쓴다 */
1636
+ categories: ReadonlyArray<{
1637
+ categoryId: string;
1638
+ parentId: string | null;
1639
+ }>;
1640
+ }
1641
+ /** 카테고리 자신 + 모든 하위 카테고리 id */
1642
+ export declare function descendantCategoryIdsOf(roots: readonly string[], categories: CollectionRuleContext["categories"]): Set<string>;
1643
+ /**
1644
+ * 조건 판정 함수를 만든다 — 모든 조건을 만족해야 true다(AND). 카테고리 트리는 여기서 한 번만 푼다.
1645
+ * 알 수 없는 조건(`field`)은 만족하지 않는 것으로 본다. 모르는 조건을 건너뛰면 상품이 예고 없이 늘어난다.
1646
+ * 판매 상태는 보지 않는다. 판매 중만 거르는 것은 호출부다.
1647
+ */
1648
+ export declare function collectionRulesPredicate(rules: readonly CollectionRuleView[], context: CollectionRuleContext): (product: CollectionRuleProduct) => boolean;
1649
+ /** 상품 하나가 조건을 모두 만족하는가 — 여러 상품을 판정할 때는 `collectionRulesPredicate`를 한 번 만들어 쓴다 */
1650
+ export declare function matchesCollectionRules(product: CollectionRuleProduct, rules: readonly CollectionRuleView[], context: CollectionRuleContext): boolean;
1651
+ /** 조건이 참조하는 카테고리 id — 카테고리 삭제의 참조 검사에 쓴다 */
1652
+ export declare function collectionRuleCategoryIds(rules: readonly CollectionRuleView[]): string[];
1558
1653
  export declare const collectionSchema: z.ZodObject<{
1559
1654
  collectionId: z.ZodString;
1560
1655
  type: z.ZodString;
@@ -1563,6 +1658,22 @@ export declare const collectionSchema: z.ZodObject<{
1563
1658
  description: z.ZodString;
1564
1659
  imageUrl: z.ZodNullable<z.ZodString>;
1565
1660
  productSort: z.ZodString;
1661
+ rules: z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1662
+ field: z.ZodLiteral<"createdWithinDays">;
1663
+ value: z.ZodNumber;
1664
+ }, z.core.$strip>, z.ZodObject<{
1665
+ field: z.ZodLiteral<"category">;
1666
+ categoryIds: z.ZodArray<z.ZodString>;
1667
+ }, z.core.$strip>, z.ZodObject<{
1668
+ field: z.ZodLiteral<"price">;
1669
+ min: z.ZodOptional<z.ZodNumber>;
1670
+ max: z.ZodOptional<z.ZodNumber>;
1671
+ }, z.core.$strip>, z.ZodObject<{
1672
+ field: z.ZodLiteral<"discounted">;
1673
+ value: z.ZodLiteral<true>;
1674
+ }, z.core.$strip>, z.ZodObject<{
1675
+ field: z.ZodString;
1676
+ }, z.core.$loose>]>>>;
1566
1677
  visible: z.ZodBoolean;
1567
1678
  startsAt: z.ZodNullable<z.ZodString>;
1568
1679
  endsAt: z.ZodNullable<z.ZodString>;
@@ -1582,18 +1693,34 @@ export declare const collectionSchema: z.ZodObject<{
1582
1693
  }, z.core.$strip>;
1583
1694
  export type Collection = z.infer<typeof collectionSchema>;
1584
1695
  /**
1585
- * `POST /v1/collections` — 직접 선택 컬렉션을 만든다. `slug`를 생략하면 `c-{id 뒤 8자}`로 만든다.
1586
- * `productIds`는 처음 담을 상품과 순서다.
1696
+ * `POST /v1/collections` — 컬렉션을 만든다. `slug`를 생략하면 `c-{id 뒤 8자}`로 만든다.
1697
+ * 직접 선택(`MANUAL`)은 `productIds`가 처음 담을 상품과 순서다. 조건 자동(`AUTOMATIC`)은 `rules`가 있어야 하고 `productIds`를 받지 않는다.
1698
+ * `productSort`를 생략하면 직접 선택은 `MANUAL`, 조건 자동은 `LATEST`다. 조건 자동은 `MANUAL`을 쓸 수 없다.
1587
1699
  */
1588
1700
  export declare const collectionCreateRequestSchema: z.ZodObject<{
1589
1701
  title: z.ZodString;
1590
1702
  slug: z.ZodOptional<z.ZodString>;
1591
1703
  type: z.ZodDefault<z.ZodEnum<{
1592
1704
  MANUAL: "MANUAL";
1705
+ AUTOMATIC: "AUTOMATIC";
1593
1706
  }>>;
1707
+ rules: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
1708
+ field: z.ZodLiteral<"createdWithinDays">;
1709
+ value: z.ZodNumber;
1710
+ }, z.core.$strip>, z.ZodObject<{
1711
+ field: z.ZodLiteral<"category">;
1712
+ categoryIds: z.ZodArray<z.ZodString>;
1713
+ }, z.core.$strip>, z.ZodObject<{
1714
+ field: z.ZodLiteral<"price">;
1715
+ min: z.ZodOptional<z.ZodNumber>;
1716
+ max: z.ZodOptional<z.ZodNumber>;
1717
+ }, z.core.$strip>, z.ZodObject<{
1718
+ field: z.ZodLiteral<"discounted">;
1719
+ value: z.ZodLiteral<true>;
1720
+ }, z.core.$strip>], "field">>>;
1594
1721
  description: z.ZodDefault<z.ZodString>;
1595
1722
  imageUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
1596
- productSort: z.ZodDefault<z.ZodEnum<{
1723
+ productSort: z.ZodOptional<z.ZodEnum<{
1597
1724
  PRICE_ASC: "PRICE_ASC";
1598
1725
  PRICE_DESC: "PRICE_DESC";
1599
1726
  MANUAL: "MANUAL";
@@ -1620,6 +1747,20 @@ export declare const collectionPatchRequestSchema: z.ZodObject<{
1620
1747
  title: z.ZodOptional<z.ZodString>;
1621
1748
  slug: z.ZodOptional<z.ZodString>;
1622
1749
  type: z.ZodOptional<z.ZodString>;
1750
+ rules: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
1751
+ field: z.ZodLiteral<"createdWithinDays">;
1752
+ value: z.ZodNumber;
1753
+ }, z.core.$strip>, z.ZodObject<{
1754
+ field: z.ZodLiteral<"category">;
1755
+ categoryIds: z.ZodArray<z.ZodString>;
1756
+ }, z.core.$strip>, z.ZodObject<{
1757
+ field: z.ZodLiteral<"price">;
1758
+ min: z.ZodOptional<z.ZodNumber>;
1759
+ max: z.ZodOptional<z.ZodNumber>;
1760
+ }, z.core.$strip>, z.ZodObject<{
1761
+ field: z.ZodLiteral<"discounted">;
1762
+ value: z.ZodLiteral<true>;
1763
+ }, z.core.$strip>], "field">>>;
1623
1764
  description: z.ZodOptional<z.ZodString>;
1624
1765
  imageUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
1625
1766
  productSort: z.ZodOptional<z.ZodEnum<{
@@ -1683,6 +1824,22 @@ export declare const collectionPageSchema: z.ZodObject<{
1683
1824
  description: z.ZodString;
1684
1825
  imageUrl: z.ZodNullable<z.ZodString>;
1685
1826
  productSort: z.ZodString;
1827
+ rules: z.ZodNullable<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
1828
+ field: z.ZodLiteral<"createdWithinDays">;
1829
+ value: z.ZodNumber;
1830
+ }, z.core.$strip>, z.ZodObject<{
1831
+ field: z.ZodLiteral<"category">;
1832
+ categoryIds: z.ZodArray<z.ZodString>;
1833
+ }, z.core.$strip>, z.ZodObject<{
1834
+ field: z.ZodLiteral<"price">;
1835
+ min: z.ZodOptional<z.ZodNumber>;
1836
+ max: z.ZodOptional<z.ZodNumber>;
1837
+ }, z.core.$strip>, z.ZodObject<{
1838
+ field: z.ZodLiteral<"discounted">;
1839
+ value: z.ZodLiteral<true>;
1840
+ }, z.core.$strip>, z.ZodObject<{
1841
+ field: z.ZodString;
1842
+ }, z.core.$loose>]>>>;
1686
1843
  visible: z.ZodBoolean;
1687
1844
  startsAt: z.ZodNullable<z.ZodString>;
1688
1845
  endsAt: z.ZodNullable<z.ZodString>;
@@ -1737,6 +1894,47 @@ export declare const collectionProductListQuerySchema: z.ZodObject<{
1737
1894
  page: z.ZodOptional<z.ZodString>;
1738
1895
  size: z.ZodOptional<z.ZodString>;
1739
1896
  }, z.core.$strip>;
1897
+ /** `POST /v1/collections/preview` — 저장하지 않고 조건으로 나오는 상품을 본다 */
1898
+ export declare const collectionPreviewRequestSchema: z.ZodObject<{
1899
+ rules: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
1900
+ field: z.ZodLiteral<"createdWithinDays">;
1901
+ value: z.ZodNumber;
1902
+ }, z.core.$strip>, z.ZodObject<{
1903
+ field: z.ZodLiteral<"category">;
1904
+ categoryIds: z.ZodArray<z.ZodString>;
1905
+ }, z.core.$strip>, z.ZodObject<{
1906
+ field: z.ZodLiteral<"price">;
1907
+ min: z.ZodOptional<z.ZodNumber>;
1908
+ max: z.ZodOptional<z.ZodNumber>;
1909
+ }, z.core.$strip>, z.ZodObject<{
1910
+ field: z.ZodLiteral<"discounted">;
1911
+ value: z.ZodLiteral<true>;
1912
+ }, z.core.$strip>], "field">>;
1913
+ productSort: z.ZodOptional<z.ZodEnum<{
1914
+ PRICE_ASC: "PRICE_ASC";
1915
+ PRICE_DESC: "PRICE_DESC";
1916
+ MANUAL: "MANUAL";
1917
+ LATEST: "LATEST";
1918
+ REVIEW_COUNT: "REVIEW_COUNT";
1919
+ RATING_DESC: "RATING_DESC";
1920
+ RECOMMEND: "RECOMMEND";
1921
+ }>>;
1922
+ }, z.core.$strip>;
1923
+ export type CollectionPreviewRequest = z.infer<typeof collectionPreviewRequestSchema>;
1924
+ /** 미리보기 응답 — 조건을 만족하는 판매 중 상품 수와 앞 20개 */
1925
+ export declare const collectionPreviewSchema: z.ZodObject<{
1926
+ count: z.ZodNumber;
1927
+ products: z.ZodArray<z.ZodObject<{
1928
+ productId: z.ZodString;
1929
+ name: z.ZodString;
1930
+ thumbnailUrl: z.ZodNullable<z.ZodString>;
1931
+ status: z.ZodString;
1932
+ salePrice: z.ZodNumber;
1933
+ position: z.ZodNumber;
1934
+ addedAt: z.ZodString;
1935
+ }, z.core.$strip>>;
1936
+ }, z.core.$strip>;
1937
+ export type CollectionPreview = z.infer<typeof collectionPreviewSchema>;
1740
1938
  //#endregion
1741
1939
  //#region src/schemas/coupon.d.ts
1742
1940
  /**
@@ -2328,10 +2526,10 @@ export type CustomerOrder = z.infer<typeof customerOrderSchema>;
2328
2526
  /** `POST /v1/customers/{id}/withdraw` 본문 */
2329
2527
  export declare const withdrawCustomerRequestSchema: z.ZodObject<{
2330
2528
  reason: z.ZodEnum<{
2331
- OTHER: "OTHER";
2332
2529
  BUYER_REQUEST: "BUYER_REQUEST";
2333
2530
  DORMANT: "DORMANT";
2334
2531
  ABUSE: "ABUSE";
2532
+ OTHER: "OTHER";
2335
2533
  }>;
2336
2534
  memo: z.ZodOptional<z.ZodString>;
2337
2535
  }, z.core.$strip>;
@@ -2618,8 +2816,8 @@ export declare const eventTypeSchema: z.ZodEnum<{
2618
2816
  }>;
2619
2817
  export type EventType = z.infer<typeof eventTypeSchema>;
2620
2818
  export declare const webhookStatusSchema: z.ZodEnum<{
2621
- ACTIVE: "ACTIVE";
2622
2819
  SUSPENDED: "SUSPENDED";
2820
+ ACTIVE: "ACTIVE";
2623
2821
  }>;
2624
2822
  export type WebhookStatus = z.infer<typeof webhookStatusSchema>;
2625
2823
  export declare const webhookSchema: z.ZodObject<{
@@ -2643,8 +2841,8 @@ export declare const webhookSchema: z.ZodObject<{
2643
2841
  "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
2644
2842
  }>>;
2645
2843
  status: z.ZodEnum<{
2646
- ACTIVE: "ACTIVE";
2647
2844
  SUSPENDED: "SUSPENDED";
2845
+ ACTIVE: "ACTIVE";
2648
2846
  }>;
2649
2847
  secretPrefix: z.ZodString;
2650
2848
  suspendedAt: z.ZodNullable<z.ZodString>;
@@ -2673,8 +2871,8 @@ export declare const webhookCreatedSchema: z.ZodObject<{
2673
2871
  "PRODUCT.OUT_OF_STOCK": "PRODUCT.OUT_OF_STOCK";
2674
2872
  }>>;
2675
2873
  status: z.ZodEnum<{
2676
- ACTIVE: "ACTIVE";
2677
2874
  SUSPENDED: "SUSPENDED";
2875
+ ACTIVE: "ACTIVE";
2678
2876
  }>;
2679
2877
  secretPrefix: z.ZodString;
2680
2878
  suspendedAt: z.ZodNullable<z.ZodString>;
@@ -2689,10 +2887,10 @@ export declare const webhookSecretRotatedSchema: z.ZodObject<{
2689
2887
  }, z.core.$strip>;
2690
2888
  export type WebhookSecretRotated = z.infer<typeof webhookSecretRotatedSchema>;
2691
2889
  export declare const webhookDeliveryStatusSchema: z.ZodEnum<{
2692
- FAILED: "FAILED";
2693
2890
  PENDING: "PENDING";
2694
2891
  PENDING_RETRY: "PENDING_RETRY";
2695
2892
  SUCCESS: "SUCCESS";
2893
+ FAILED: "FAILED";
2696
2894
  }>;
2697
2895
  export type WebhookDeliveryStatus = z.infer<typeof webhookDeliveryStatusSchema>;
2698
2896
  export declare const webhookDeliveryErrorCodeSchema: z.ZodEnum<{
@@ -2754,10 +2952,10 @@ export declare const webhookDeliverySchema: z.ZodObject<{
2754
2952
  }>;
2755
2953
  url: z.ZodString;
2756
2954
  status: z.ZodEnum<{
2757
- FAILED: "FAILED";
2758
2955
  PENDING: "PENDING";
2759
2956
  PENDING_RETRY: "PENDING_RETRY";
2760
2957
  SUCCESS: "SUCCESS";
2958
+ FAILED: "FAILED";
2761
2959
  }>;
2762
2960
  responseStatusCode: z.ZodNullable<z.ZodNumber>;
2763
2961
  responseTimeMs: z.ZodNullable<z.ZodNumber>;
@@ -2807,10 +3005,10 @@ export declare const webhookDeliveryDetailSchema: z.ZodObject<{
2807
3005
  }>;
2808
3006
  url: z.ZodString;
2809
3007
  status: z.ZodEnum<{
2810
- FAILED: "FAILED";
2811
3008
  PENDING: "PENDING";
2812
3009
  PENDING_RETRY: "PENDING_RETRY";
2813
3010
  SUCCESS: "SUCCESS";
3011
+ FAILED: "FAILED";
2814
3012
  }>;
2815
3013
  responseStatusCode: z.ZodNullable<z.ZodNumber>;
2816
3014
  responseTimeMs: z.ZodNullable<z.ZodNumber>;
@@ -2845,10 +3043,10 @@ export type WebhookDeliveryDetail = z.infer<typeof webhookDeliveryDetailSchema>;
2845
3043
  /** 전송 기록 조회 쿼리 — `GET /webhooks/{id}/deliveries` */
2846
3044
  export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
2847
3045
  status: z.ZodOptional<z.ZodEnum<{
2848
- FAILED: "FAILED";
2849
3046
  PENDING: "PENDING";
2850
3047
  PENDING_RETRY: "PENDING_RETRY";
2851
3048
  SUCCESS: "SUCCESS";
3049
+ FAILED: "FAILED";
2852
3050
  }>>;
2853
3051
  eventType: z.ZodOptional<z.ZodEnum<{
2854
3052
  "ORDER.PAID": "ORDER.PAID";
@@ -3065,8 +3263,8 @@ export declare function requiresCollection(type: string | null | undefined): boo
3065
3263
  export declare const NO_SHIPPING_BUNDLE_KEY = "none";
3066
3264
  /** 배송비 유형 — 무료·유료·조건부 무료 */
3067
3265
  export declare const deliveryTypeSchema: z.ZodEnum<{
3068
- PAID: "PAID";
3069
3266
  FREE: "FREE";
3267
+ PAID: "PAID";
3070
3268
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
3071
3269
  }>;
3072
3270
  export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
@@ -3077,8 +3275,8 @@ export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.
3077
3275
  type: z.ZodLiteral<"SHIPPING">;
3078
3276
  shipping: z.ZodOptional<z.ZodObject<{
3079
3277
  deliveryType: z.ZodDefault<z.ZodEnum<{
3080
- PAID: "PAID";
3081
3278
  FREE: "FREE";
3279
+ PAID: "PAID";
3082
3280
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
3083
3281
  }>>;
3084
3282
  deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -3100,8 +3298,8 @@ export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.
3100
3298
  type: z.ZodLiteral<"SHIPPING">;
3101
3299
  shipping: z.ZodObject<{
3102
3300
  deliveryType: z.ZodEnum<{
3103
- PAID: "PAID";
3104
3301
  FREE: "FREE";
3302
+ PAID: "PAID";
3105
3303
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
3106
3304
  }>;
3107
3305
  deliveryFee: z.ZodNumber;
@@ -3121,8 +3319,8 @@ export declare const productFulfillmentSchema: z.ZodDiscriminatedUnion<[z.ZodObj
3121
3319
  type: z.ZodLiteral<"SHIPPING">;
3122
3320
  shipping: z.ZodObject<{
3123
3321
  deliveryType: z.ZodEnum<{
3124
- PAID: "PAID";
3125
3322
  FREE: "FREE";
3323
+ PAID: "PAID";
3126
3324
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
3127
3325
  }>;
3128
3326
  deliveryFee: z.ZodNumber;
@@ -3160,8 +3358,8 @@ export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.Zo
3160
3358
  type: z.ZodLiteral<"SHIPPING">;
3161
3359
  shipping: z.ZodObject<{
3162
3360
  deliveryType: z.ZodEnum<{
3163
- PAID: "PAID";
3164
3361
  FREE: "FREE";
3362
+ PAID: "PAID";
3165
3363
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
3166
3364
  }>;
3167
3365
  deliveryFee: z.ZodNumber;
@@ -3300,6 +3498,7 @@ export declare const orderItemSchema: z.ZodObject<{
3300
3498
  discountAmount: z.ZodNumber;
3301
3499
  totalPrice: z.ZodNumber;
3302
3500
  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
3501
+ pointAllocation: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
3303
3502
  hold: z.ZodNullable<z.ZodObject<{
3304
3503
  reason: z.ZodString;
3305
3504
  expectedDispatchDate: z.ZodString;
@@ -3372,6 +3571,7 @@ export declare const orderSchema: z.ZodObject<{
3372
3571
  discountAmount: z.ZodNumber;
3373
3572
  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
3374
3573
  deliveryDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
3574
+ pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
3375
3575
  discounts: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
3376
3576
  couponId: z.ZodString;
3377
3577
  name: z.ZodString;
@@ -3459,6 +3659,7 @@ export declare const orderSchema: z.ZodObject<{
3459
3659
  discountAmount: z.ZodNumber;
3460
3660
  totalPrice: z.ZodNumber;
3461
3661
  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
3662
+ pointAllocation: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
3462
3663
  hold: z.ZodNullable<z.ZodObject<{
3463
3664
  reason: z.ZodString;
3464
3665
  expectedDispatchDate: z.ZodString;
@@ -3575,6 +3776,7 @@ export declare const orderItemPageSchema: z.ZodObject<{
3575
3776
  discountAmount: z.ZodNumber;
3576
3777
  totalPrice: z.ZodNumber;
3577
3778
  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
3779
+ pointAllocation: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
3578
3780
  hold: z.ZodNullable<z.ZodObject<{
3579
3781
  reason: z.ZodString;
3580
3782
  expectedDispatchDate: z.ZodString;
@@ -3676,16 +3878,16 @@ export interface OrderItemListParams extends PageParams {
3676
3878
  testPayment?: "true" | "false";
3677
3879
  }
3678
3880
  export declare const deliveryMethodSchema: z.ZodEnum<{
3679
- DIRECT: "DIRECT";
3680
3881
  COURIER: "COURIER";
3882
+ DIRECT: "DIRECT";
3681
3883
  QUICK: "QUICK";
3682
3884
  NOTHING: "NOTHING";
3683
3885
  }>;
3684
3886
  export type DeliveryMethod = z.infer<typeof deliveryMethodSchema>;
3685
3887
  export declare const dispatchRequestSchema: z.ZodObject<{
3686
3888
  deliveryMethod: z.ZodEnum<{
3687
- DIRECT: "DIRECT";
3688
3889
  COURIER: "COURIER";
3890
+ DIRECT: "DIRECT";
3689
3891
  QUICK: "QUICK";
3690
3892
  NOTHING: "NOTHING";
3691
3893
  }>;
@@ -3697,8 +3899,8 @@ export type DispatchRequest = z.infer<typeof dispatchRequestSchema>;
3697
3899
  export declare const deliveryInfoSchema: z.ZodObject<{
3698
3900
  orderItemId: z.ZodString;
3699
3901
  deliveryMethod: z.ZodEnum<{
3700
- DIRECT: "DIRECT";
3701
3902
  COURIER: "COURIER";
3903
+ DIRECT: "DIRECT";
3702
3904
  QUICK: "QUICK";
3703
3905
  NOTHING: "NOTHING";
3704
3906
  }>;
@@ -3724,8 +3926,8 @@ export declare const trackingStageResponseSchema: z.ZodString;
3724
3926
  export declare const deliveryStatusSchema: z.ZodObject<{
3725
3927
  orderItemId: z.ZodString;
3726
3928
  deliveryMethod: z.ZodEnum<{
3727
- DIRECT: "DIRECT";
3728
3929
  COURIER: "COURIER";
3930
+ DIRECT: "DIRECT";
3729
3931
  QUICK: "QUICK";
3730
3932
  NOTHING: "NOTHING";
3731
3933
  }>;
@@ -3813,6 +4015,7 @@ export declare const cancelBySellerResultSchema: z.ZodObject<{
3813
4015
  deliveryFeeChargeAmount: z.ZodNumber;
3814
4016
  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
3815
4017
  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
4018
+ pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
3816
4019
  refundedAt: z.ZodString;
3817
4020
  }, z.core.$strip>;
3818
4021
  export type CancelBySellerResult = z.infer<typeof cancelBySellerResultSchema>;
@@ -3885,8 +4088,8 @@ export declare const pgEnvironmentSchema: z.ZodEnum<{
3885
4088
  }>;
3886
4089
  export type PgEnvironment = z.infer<typeof pgEnvironmentSchema>;
3887
4090
  export declare const pgVerificationResultSchema: z.ZodEnum<{
3888
- FAILED: "FAILED";
3889
4091
  SUCCESS: "SUCCESS";
4092
+ FAILED: "FAILED";
3890
4093
  }>;
3891
4094
  export type PgVerificationResult = z.infer<typeof pgVerificationResultSchema>;
3892
4095
  /**
@@ -4035,8 +4238,8 @@ export declare const paymentCredentialSetSchema: z.ZodObject<{
4035
4238
  }, z.core.$strip>>;
4036
4239
  lastVerification: z.ZodNullable<z.ZodObject<{
4037
4240
  result: z.ZodEnum<{
4038
- FAILED: "FAILED";
4039
4241
  SUCCESS: "SUCCESS";
4242
+ FAILED: "FAILED";
4040
4243
  }>;
4041
4244
  message: z.ZodNullable<z.ZodString>;
4042
4245
  checkedAt: z.ZodString;
@@ -4137,8 +4340,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
4137
4340
  }, z.core.$strip>>;
4138
4341
  lastVerification: z.ZodNullable<z.ZodObject<{
4139
4342
  result: z.ZodEnum<{
4140
- FAILED: "FAILED";
4141
4343
  SUCCESS: "SUCCESS";
4344
+ FAILED: "FAILED";
4142
4345
  }>;
4143
4346
  message: z.ZodNullable<z.ZodString>;
4144
4347
  checkedAt: z.ZodString;
@@ -4174,8 +4377,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
4174
4377
  }, z.core.$strip>>;
4175
4378
  lastVerification: z.ZodNullable<z.ZodObject<{
4176
4379
  result: z.ZodEnum<{
4177
- FAILED: "FAILED";
4178
4380
  SUCCESS: "SUCCESS";
4381
+ FAILED: "FAILED";
4179
4382
  }>;
4180
4383
  message: z.ZodNullable<z.ZodString>;
4181
4384
  checkedAt: z.ZodString;
@@ -4210,8 +4413,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
4210
4413
  }, z.core.$strip>>;
4211
4414
  lastVerification: z.ZodNullable<z.ZodObject<{
4212
4415
  result: z.ZodEnum<{
4213
- FAILED: "FAILED";
4214
4416
  SUCCESS: "SUCCESS";
4417
+ FAILED: "FAILED";
4215
4418
  }>;
4216
4419
  message: z.ZodNullable<z.ZodString>;
4217
4420
  checkedAt: z.ZodString;
@@ -4301,8 +4504,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
4301
4504
  }, z.core.$strip>>;
4302
4505
  lastVerification: z.ZodNullable<z.ZodObject<{
4303
4506
  result: z.ZodEnum<{
4304
- FAILED: "FAILED";
4305
4507
  SUCCESS: "SUCCESS";
4508
+ FAILED: "FAILED";
4306
4509
  }>;
4307
4510
  message: z.ZodNullable<z.ZodString>;
4308
4511
  checkedAt: z.ZodString;
@@ -4338,8 +4541,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
4338
4541
  }, z.core.$strip>>;
4339
4542
  lastVerification: z.ZodNullable<z.ZodObject<{
4340
4543
  result: z.ZodEnum<{
4341
- FAILED: "FAILED";
4342
4544
  SUCCESS: "SUCCESS";
4545
+ FAILED: "FAILED";
4343
4546
  }>;
4344
4547
  message: z.ZodNullable<z.ZodString>;
4345
4548
  checkedAt: z.ZodString;
@@ -4374,8 +4577,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
4374
4577
  }, z.core.$strip>>;
4375
4578
  lastVerification: z.ZodNullable<z.ZodObject<{
4376
4579
  result: z.ZodEnum<{
4377
- FAILED: "FAILED";
4378
4580
  SUCCESS: "SUCCESS";
4581
+ FAILED: "FAILED";
4379
4582
  }>;
4380
4583
  message: z.ZodNullable<z.ZodString>;
4381
4584
  checkedAt: z.ZodString;
@@ -4431,8 +4634,8 @@ export declare const paymentProviderVerificationSchema: z.ZodObject<{
4431
4634
  LIVE: "LIVE";
4432
4635
  }>;
4433
4636
  result: z.ZodEnum<{
4434
- FAILED: "FAILED";
4435
4637
  SUCCESS: "SUCCESS";
4638
+ FAILED: "FAILED";
4436
4639
  }>;
4437
4640
  message: z.ZodNullable<z.ZodString>;
4438
4641
  checkedAt: z.ZodString;
@@ -4562,8 +4765,8 @@ export type SalesReport = z.infer<typeof salesReportSchema>;
4562
4765
  * - `FAILED`: 승인되지 않고 끝났다(거절·준비 장애·구매자 취소·만료)
4563
4766
  */
4564
4767
  export declare const paymentRecordStatusSchema: z.ZodEnum<{
4565
- FAILED: "FAILED";
4566
4768
  PENDING: "PENDING";
4769
+ FAILED: "FAILED";
4567
4770
  APPROVED: "APPROVED";
4568
4771
  PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
4569
4772
  REFUNDED: "REFUNDED";
@@ -4610,8 +4813,8 @@ export declare const paymentRecordSchema: z.ZodObject<{
4610
4813
  orderName: z.ZodString;
4611
4814
  customerName: z.ZodString;
4612
4815
  status: z.ZodEnum<{
4613
- FAILED: "FAILED";
4614
4816
  PENDING: "PENDING";
4817
+ FAILED: "FAILED";
4615
4818
  APPROVED: "APPROVED";
4616
4819
  PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
4617
4820
  REFUNDED: "REFUNDED";
@@ -4656,8 +4859,8 @@ export declare const paymentRecordPageSchema: z.ZodObject<{
4656
4859
  orderName: z.ZodString;
4657
4860
  customerName: z.ZodString;
4658
4861
  status: z.ZodEnum<{
4659
- FAILED: "FAILED";
4660
4862
  PENDING: "PENDING";
4863
+ FAILED: "FAILED";
4661
4864
  APPROVED: "APPROVED";
4662
4865
  PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
4663
4866
  REFUNDED: "REFUNDED";
@@ -4731,6 +4934,7 @@ export type PaymentAttemptRecord = z.infer<typeof paymentAttemptRecordSchema>;
4731
4934
  export declare const paymentRefundRecordSchema: z.ZodObject<{
4732
4935
  refundId: z.ZodString;
4733
4936
  amount: z.ZodNumber;
4937
+ pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
4734
4938
  reason: z.ZodString;
4735
4939
  kind: z.ZodString;
4736
4940
  status: z.ZodString;
@@ -4745,8 +4949,8 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
4745
4949
  orderName: z.ZodString;
4746
4950
  customerName: z.ZodString;
4747
4951
  status: z.ZodEnum<{
4748
- FAILED: "FAILED";
4749
4952
  PENDING: "PENDING";
4953
+ FAILED: "FAILED";
4750
4954
  APPROVED: "APPROVED";
4751
4955
  PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
4752
4956
  REFUNDED: "REFUNDED";
@@ -4818,6 +5022,7 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
4818
5022
  refunds: z.ZodArray<z.ZodObject<{
4819
5023
  refundId: z.ZodString;
4820
5024
  amount: z.ZodNumber;
5025
+ pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
4821
5026
  reason: z.ZodString;
4822
5027
  kind: z.ZodString;
4823
5028
  status: z.ZodString;
@@ -4899,6 +5104,21 @@ export declare const purchaseEarnPolicySchema: z.ZodObject<{
4899
5104
  rateBp: z.ZodNumber;
4900
5105
  }, z.core.$strip>;
4901
5106
  export type PurchaseEarnPolicy = z.infer<typeof purchaseEarnPolicySchema>;
5107
+ /** 사용 단위 — 1·10·100원 */
5108
+ export declare const POINT_USE_UNITS: readonly [1, 10, 100];
5109
+ /**
5110
+ * 적립금 사용 규칙(P3) — 주문서에서 결제 금액을 줄인다. 적용 순서는 즉시할인 → 쿠폰 → 적립금이고, 상품 금액(쿠폰 뒤)에 먼저 쓰고
5111
+ * 남으면 배송비에 쓴다(`includeDeliveryFee`). 결제 금액이 100원 아래로 내려가지 않게 적립금을 줄인다.
5112
+ */
5113
+ export declare const pointUsePolicySchema: z.ZodObject<{
5114
+ enabled: z.ZodBoolean;
5115
+ minBalance: z.ZodNumber;
5116
+ minAmount: z.ZodNumber;
5117
+ unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
5118
+ maxRatioBp: z.ZodNumber;
5119
+ includeDeliveryFee: z.ZodBoolean;
5120
+ }, z.core.$strip>;
5121
+ export type PointUsePolicy = z.infer<typeof pointUsePolicySchema>;
4902
5122
  /** 저장된 상점 정책(`stores.point_policy`) — 해석은 `resolvePointPolicy` */
4903
5123
  export declare const pointPolicySchema: z.ZodObject<{
4904
5124
  reviewReward: z.ZodObject<{
@@ -4910,6 +5130,14 @@ export declare const pointPolicySchema: z.ZodObject<{
4910
5130
  enabled: z.ZodBoolean;
4911
5131
  rateBp: z.ZodNumber;
4912
5132
  }, z.core.$strip>;
5133
+ use: z.ZodObject<{
5134
+ enabled: z.ZodBoolean;
5135
+ minBalance: z.ZodNumber;
5136
+ minAmount: z.ZodNumber;
5137
+ unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
5138
+ maxRatioBp: z.ZodNumber;
5139
+ includeDeliveryFee: z.ZodBoolean;
5140
+ }, z.core.$strip>;
4913
5141
  expiryDays: z.ZodNullable<z.ZodNumber>;
4914
5142
  }, z.core.$strip>;
4915
5143
  export type PointPolicy = z.infer<typeof pointPolicySchema>;
@@ -4942,7 +5170,7 @@ export declare function pointExpiresAtOf(earnedAt: Date, days: number | null): D
4942
5170
  /** 적립 묶음 출처 — 같은 출처 id에는 묶음이 하나뿐이다(DB 부분 유니크) */
4943
5171
  export declare const POINT_LOT_SOURCES: readonly ["REVIEW", "PURCHASE", "ADJUST", "REFUND_RESTORE", "OPENING"];
4944
5172
  export type PointLotSource = (typeof POINT_LOT_SOURCES)[number];
4945
- /** 원장 항목 유형. 지금 쓰는 것은 리뷰 적립·회수이고 나머지는 다음 단계 자리다 */
5173
+ /** 원장 항목 유형 */
4946
5174
  export declare const POINT_ENTRY_TYPES: readonly ["EARN_REVIEW", "REVOKE_REVIEW", "EARN_PURCHASE", "USE_RESERVE", "USE_RELEASE", "REFUND_RESTORE", "EXPIRE", "ADJUST", "OPENING"];
4947
5175
  export type PointEntryType = (typeof POINT_ENTRY_TYPES)[number];
4948
5176
  /** 상점 플랫폼 알림 — `REVIEW_REWARD_PAUSED` 리뷰 자동 적립이 멈춤 · `POINTS_AVAILABLE` 적립금 설정을 쓸 수 있음 */
@@ -4964,6 +5192,15 @@ export declare const storePointPolicySchema: z.ZodObject<{
4964
5192
  enabled: z.ZodBoolean;
4965
5193
  rateBp: z.ZodNumber;
4966
5194
  }, z.core.$strip>;
5195
+ useAvailable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
5196
+ use: z.ZodDefault<z.ZodOptional<z.ZodObject<{
5197
+ enabled: z.ZodBoolean;
5198
+ minBalance: z.ZodNumber;
5199
+ minAmount: z.ZodNumber;
5200
+ unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
5201
+ maxRatioBp: z.ZodNumber;
5202
+ includeDeliveryFee: z.ZodBoolean;
5203
+ }, z.core.$strip>>>;
4967
5204
  expiryDays: z.ZodNullable<z.ZodNumber>;
4968
5205
  notice: z.ZodNullable<z.ZodEnum<{
4969
5206
  REVIEW_REWARD_PAUSED: "REVIEW_REWARD_PAUSED";
@@ -4985,6 +5222,14 @@ export declare const updatePointPolicyRequestSchema: z.ZodObject<{
4985
5222
  enabled: z.ZodBoolean;
4986
5223
  rateBp: z.ZodNumber;
4987
5224
  }, z.core.$strip>>;
5225
+ use: z.ZodOptional<z.ZodObject<{
5226
+ enabled: z.ZodBoolean;
5227
+ minBalance: z.ZodNumber;
5228
+ minAmount: z.ZodNumber;
5229
+ unit: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<10>, z.ZodLiteral<100>]>;
5230
+ maxRatioBp: z.ZodNumber;
5231
+ includeDeliveryFee: z.ZodBoolean;
5232
+ }, z.core.$strip>>;
4988
5233
  expiryDays: z.ZodOptional<z.ZodNumber>;
4989
5234
  }, z.core.$strip>;
4990
5235
  export type UpdatePointPolicyRequest = z.infer<typeof updatePointPolicyRequestSchema>;
@@ -5028,11 +5273,11 @@ export type PointEntry = z.infer<typeof pointEntrySchema>;
5028
5273
  export declare const pointLotSchema: z.ZodObject<{
5029
5274
  lotId: z.ZodString;
5030
5275
  source: z.ZodUnion<readonly [z.ZodEnum<{
5031
- PURCHASE: "PURCHASE";
5032
5276
  REFUND_RESTORE: "REFUND_RESTORE";
5033
5277
  ADJUST: "ADJUST";
5034
5278
  OPENING: "OPENING";
5035
5279
  REVIEW: "REVIEW";
5280
+ PURCHASE: "PURCHASE";
5036
5281
  }>, z.ZodString]>;
5037
5282
  amount: z.ZodNumber;
5038
5283
  remaining: z.ZodNumber;
@@ -5047,11 +5292,11 @@ export declare const customerPointsSchema: z.ZodObject<{
5047
5292
  lots: z.ZodArray<z.ZodObject<{
5048
5293
  lotId: z.ZodString;
5049
5294
  source: z.ZodUnion<readonly [z.ZodEnum<{
5050
- PURCHASE: "PURCHASE";
5051
5295
  REFUND_RESTORE: "REFUND_RESTORE";
5052
5296
  ADJUST: "ADJUST";
5053
5297
  OPENING: "OPENING";
5054
5298
  REVIEW: "REVIEW";
5299
+ PURCHASE: "PURCHASE";
5055
5300
  }>, z.ZodString]>;
5056
5301
  amount: z.ZodNumber;
5057
5302
  remaining: z.ZodNumber;
@@ -5109,23 +5354,47 @@ export declare const pointAdjustmentResultSchema: z.ZodObject<{
5109
5354
  balance: z.ZodNumber;
5110
5355
  }, z.core.$strip>;
5111
5356
  export type PointAdjustmentResult = z.infer<typeof pointAdjustmentResultSchema>;
5357
+ /** 결제 시작에 쓴 적립 묶음 — 해제·환불 반환이 이 값으로 되돌리고 반환 적립금의 만료를 정한다 */
5358
+ export interface PointLotUsage {
5359
+ lotId: string;
5360
+ amount: number;
5361
+ expiresAt: string | null;
5362
+ }
5363
+ /**
5364
+ * 환불로 돌려주는 적립금의 만료 — 결제에 쓴 묶음 중 가장 늦은 만료이고, 그 시각이 이미 지났으면 지금 + 30일(KST 날짜 끝)이다.
5365
+ * 쓴 묶음 중 만료 없는 묶음(기존 잔액 등)이 있으면 만료 없음(null)이다. 쓴 기록이 없으면 지금 + 30일이다(사용자 결정 2026-10-02).
5366
+ */
5367
+ export declare function pointRestoreExpiresAtOf(usages: readonly PointLotUsage[], now: Date): Date | null;
5368
+ /**
5369
+ * 환불 금액 나누기 — 현금 몫·적립금 몫에서 차감(반품 배송비·쿠폰 조건 미달·추가 차감)을 **현금에서 먼저** 빼고 모자란 몫만 적립금에서 뺀다.
5370
+ * 둘 다 모자라면 0에서 멈추고 못 받은 차감액(`uncollected`)을 돌려준다(호출부가 감사 로그에 남긴다).
5371
+ */
5372
+ export declare function splitRefund(input: {
5373
+ cash: number;
5374
+ points: number;
5375
+ charges: number;
5376
+ }): {
5377
+ cashRefund: number;
5378
+ pointRefund: number;
5379
+ uncollected: number;
5380
+ };
5112
5381
  //#endregion
5113
5382
  //#region src/schemas/product.d.ts
5114
5383
  export declare const productStatusSchema: z.ZodEnum<{
5115
- SUSPENDED: "SUSPENDED";
5116
- CLOSED: "CLOSED";
5117
5384
  SALE: "SALE";
5385
+ SUSPENDED: "SUSPENDED";
5118
5386
  OUT_OF_STOCK: "OUT_OF_STOCK";
5387
+ CLOSED: "CLOSED";
5119
5388
  }>;
5120
5389
  export type ProductStatus = z.infer<typeof productStatusSchema>;
5121
5390
  export declare const productSummarySchema: z.ZodObject<{
5122
5391
  productId: z.ZodString;
5123
5392
  name: z.ZodString;
5124
5393
  status: z.ZodEnum<{
5125
- SUSPENDED: "SUSPENDED";
5126
- CLOSED: "CLOSED";
5127
5394
  SALE: "SALE";
5395
+ SUSPENDED: "SUSPENDED";
5128
5396
  OUT_OF_STOCK: "OUT_OF_STOCK";
5397
+ CLOSED: "CLOSED";
5129
5398
  }>;
5130
5399
  salePrice: z.ZodNumber;
5131
5400
  discountedPrice: z.ZodNullable<z.ZodNumber>;
@@ -5309,10 +5578,10 @@ export declare const productSchema: z.ZodObject<{
5309
5578
  productId: z.ZodString;
5310
5579
  name: z.ZodString;
5311
5580
  status: z.ZodEnum<{
5312
- SUSPENDED: "SUSPENDED";
5313
- CLOSED: "CLOSED";
5314
5581
  SALE: "SALE";
5582
+ SUSPENDED: "SUSPENDED";
5315
5583
  OUT_OF_STOCK: "OUT_OF_STOCK";
5584
+ CLOSED: "CLOSED";
5316
5585
  }>;
5317
5586
  salePrice: z.ZodNumber;
5318
5587
  discountedPrice: z.ZodNullable<z.ZodNumber>;
@@ -5387,8 +5656,8 @@ export declare const productSchema: z.ZodObject<{
5387
5656
  type: z.ZodLiteral<"SHIPPING">;
5388
5657
  shipping: z.ZodObject<{
5389
5658
  deliveryType: z.ZodEnum<{
5390
- PAID: "PAID";
5391
5659
  FREE: "FREE";
5660
+ PAID: "PAID";
5392
5661
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
5393
5662
  }>;
5394
5663
  deliveryFee: z.ZodNumber;
@@ -5610,8 +5879,8 @@ export declare const productCreateRequestSchema: z.ZodObject<{
5610
5879
  type: z.ZodLiteral<"SHIPPING">;
5611
5880
  shipping: z.ZodOptional<z.ZodObject<{
5612
5881
  deliveryType: z.ZodDefault<z.ZodEnum<{
5613
- PAID: "PAID";
5614
5882
  FREE: "FREE";
5883
+ PAID: "PAID";
5615
5884
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
5616
5885
  }>>;
5617
5886
  deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -5696,8 +5965,8 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
5696
5965
  type: z.ZodLiteral<"SHIPPING">;
5697
5966
  shipping: z.ZodObject<{
5698
5967
  deliveryType: z.ZodEnum<{
5699
- PAID: "PAID";
5700
5968
  FREE: "FREE";
5969
+ PAID: "PAID";
5701
5970
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
5702
5971
  }>;
5703
5972
  deliveryFee: z.ZodNumber;
@@ -5780,18 +6049,18 @@ export declare const productPatchRequestSchema: z.ZodObject<{
5780
6049
  name: z.ZodOptional<z.ZodString>;
5781
6050
  salePrice: z.ZodOptional<z.ZodNumber>;
5782
6051
  status: z.ZodOptional<z.ZodEnum<{
5783
- SUSPENDED: "SUSPENDED";
5784
- CLOSED: "CLOSED";
5785
6052
  SALE: "SALE";
6053
+ SUSPENDED: "SUSPENDED";
5786
6054
  OUT_OF_STOCK: "OUT_OF_STOCK";
6055
+ CLOSED: "CLOSED";
5787
6056
  }>>;
5788
6057
  images: z.ZodOptional<z.ZodArray<z.ZodURL>>;
5789
6058
  fulfillment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
5790
6059
  type: z.ZodLiteral<"SHIPPING">;
5791
6060
  shipping: z.ZodObject<{
5792
6061
  deliveryType: z.ZodEnum<{
5793
- PAID: "PAID";
5794
6062
  FREE: "FREE";
6063
+ PAID: "PAID";
5795
6064
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
5796
6065
  }>;
5797
6066
  deliveryFee: z.ZodNumber;
@@ -5815,9 +6084,9 @@ export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
5815
6084
  export declare const productSortSchema: z.ZodEnum<{
5816
6085
  "createdAt.desc": "createdAt.desc";
5817
6086
  "createdAt.asc": "createdAt.asc";
6087
+ "updatedAt.desc": "updatedAt.desc";
5818
6088
  "salePrice.asc": "salePrice.asc";
5819
6089
  "salePrice.desc": "salePrice.desc";
5820
- "updatedAt.desc": "updatedAt.desc";
5821
6090
  }>;
5822
6091
  export type ProductSort = z.infer<typeof productSortSchema>;
5823
6092
  export interface ProductListParams extends PageParams {
@@ -5832,10 +6101,10 @@ export declare const productListQuerySchema: z.ZodObject<{
5832
6101
  page: z.ZodOptional<z.ZodString>;
5833
6102
  size: z.ZodOptional<z.ZodString>;
5834
6103
  status: z.ZodOptional<z.ZodEnum<{
5835
- SUSPENDED: "SUSPENDED";
5836
- CLOSED: "CLOSED";
5837
6104
  SALE: "SALE";
6105
+ SUSPENDED: "SUSPENDED";
5838
6106
  OUT_OF_STOCK: "OUT_OF_STOCK";
6107
+ CLOSED: "CLOSED";
5839
6108
  }>>;
5840
6109
  categoryId: z.ZodOptional<z.ZodString>;
5841
6110
  keyword: z.ZodOptional<z.ZodString>;
@@ -5843,9 +6112,9 @@ export declare const productListQuerySchema: z.ZodObject<{
5843
6112
  sort: z.ZodOptional<z.ZodEnum<{
5844
6113
  "createdAt.desc": "createdAt.desc";
5845
6114
  "createdAt.asc": "createdAt.asc";
6115
+ "updatedAt.desc": "updatedAt.desc";
5846
6116
  "salePrice.asc": "salePrice.asc";
5847
6117
  "salePrice.desc": "salePrice.desc";
5848
- "updatedAt.desc": "updatedAt.desc";
5849
6118
  }>>;
5850
6119
  }, z.core.$strip>;
5851
6120
  export declare const discountRequestSchema: z.ZodObject<{
@@ -6212,9 +6481,9 @@ export declare const storeSchema: z.ZodObject<{
6212
6481
  storeCode: z.ZodString;
6213
6482
  storefrontUrl: z.ZodURL;
6214
6483
  status: z.ZodEnum<{
6215
- ACTIVE: "ACTIVE";
6216
6484
  SUSPENDED: "SUSPENDED";
6217
6485
  CLOSED: "CLOSED";
6486
+ ACTIVE: "ACTIVE";
6218
6487
  }>;
6219
6488
  logoUrl: z.ZodNullable<z.ZodURL>;
6220
6489
  businessNumber: z.ZodNullable<z.ZodString>;
@@ -6226,9 +6495,9 @@ export declare const storeMemberSchema: z.ZodObject<{
6226
6495
  name: z.ZodString;
6227
6496
  email: z.ZodEmail;
6228
6497
  role: z.ZodEnum<{
6229
- OWNER: "OWNER";
6230
6498
  ADMIN: "ADMIN";
6231
6499
  STAFF: "STAFF";
6500
+ OWNER: "OWNER";
6232
6501
  }>;
6233
6502
  joinedAt: z.ZodString;
6234
6503
  lastActiveAt: z.ZodNullable<z.ZodString>;
@@ -6492,9 +6761,9 @@ export declare const storefrontVersionSchema: z.ZodObject<{
6492
6761
  }, z.core.$strip>;
6493
6762
  export type StorefrontVersion = z.infer<typeof storefrontVersionSchema>;
6494
6763
  export declare const storefrontSiteStatusSchema: z.ZodEnum<{
6495
- ACTIVE: "ACTIVE";
6496
6764
  SUSPENDED: "SUSPENDED";
6497
6765
  CLOSED: "CLOSED";
6766
+ ACTIVE: "ACTIVE";
6498
6767
  }>;
6499
6768
  export type StorefrontSiteStatus = z.infer<typeof storefrontSiteStatusSchema>;
6500
6769
  export declare const storefrontVisibilitySchema: z.ZodEnum<{
@@ -6526,8 +6795,8 @@ export type StorefrontDomain = z.infer<typeof storefrontDomainSchema>;
6526
6795
  */
6527
6796
  export declare const storefrontProvisioningSchema: z.ZodObject<{
6528
6797
  status: z.ZodEnum<{
6529
- FAILED: "FAILED";
6530
6798
  PENDING: "PENDING";
6799
+ FAILED: "FAILED";
6531
6800
  SYNCED: "SYNCED";
6532
6801
  }>;
6533
6802
  lastErrorCode: z.ZodNullable<z.ZodString>;
@@ -6575,9 +6844,9 @@ export declare const storefrontSiteSchema: z.ZodObject<{
6575
6844
  MANAGED: "MANAGED";
6576
6845
  }>;
6577
6846
  status: z.ZodEnum<{
6578
- ACTIVE: "ACTIVE";
6579
6847
  SUSPENDED: "SUSPENDED";
6580
6848
  CLOSED: "CLOSED";
6849
+ ACTIVE: "ACTIVE";
6581
6850
  }>;
6582
6851
  visibility: z.ZodEnum<{
6583
6852
  COMING_SOON: "COMING_SOON";
@@ -6607,8 +6876,8 @@ export declare const storefrontSiteSchema: z.ZodObject<{
6607
6876
  }, z.core.$strip>>;
6608
6877
  provisioning: z.ZodObject<{
6609
6878
  status: z.ZodEnum<{
6610
- FAILED: "FAILED";
6611
6879
  PENDING: "PENDING";
6880
+ FAILED: "FAILED";
6612
6881
  SYNCED: "SYNCED";
6613
6882
  }>;
6614
6883
  lastErrorCode: z.ZodNullable<z.ZodString>;
@@ -6655,9 +6924,9 @@ export declare const storefrontHostingSchema: z.ZodObject<{
6655
6924
  MANAGED: "MANAGED";
6656
6925
  }>;
6657
6926
  status: z.ZodEnum<{
6658
- ACTIVE: "ACTIVE";
6659
6927
  SUSPENDED: "SUSPENDED";
6660
6928
  CLOSED: "CLOSED";
6929
+ ACTIVE: "ACTIVE";
6661
6930
  }>;
6662
6931
  visibility: z.ZodEnum<{
6663
6932
  COMING_SOON: "COMING_SOON";
@@ -6687,8 +6956,8 @@ export declare const storefrontHostingSchema: z.ZodObject<{
6687
6956
  }, z.core.$strip>>;
6688
6957
  provisioning: z.ZodObject<{
6689
6958
  status: z.ZodEnum<{
6690
- FAILED: "FAILED";
6691
6959
  PENDING: "PENDING";
6960
+ FAILED: "FAILED";
6692
6961
  SYNCED: "SYNCED";
6693
6962
  }>;
6694
6963
  lastErrorCode: z.ZodNullable<z.ZodString>;
@@ -6730,8 +6999,8 @@ export declare const storefrontDeploymentStepSchema: z.ZodObject<{
6730
6999
  PUBLISH: "PUBLISH";
6731
7000
  }>;
6732
7001
  status: z.ZodEnum<{
6733
- FAILED: "FAILED";
6734
7002
  PENDING: "PENDING";
7003
+ FAILED: "FAILED";
6735
7004
  RUNNING: "RUNNING";
6736
7005
  DONE: "DONE";
6737
7006
  }>;
@@ -6752,9 +7021,9 @@ export type StorefrontDeploymentLog = z.infer<typeof storefrontDeploymentLogSche
6752
7021
  export declare const storefrontDeploymentSchema: z.ZodObject<{
6753
7022
  siteId: z.ZodString;
6754
7023
  status: z.ZodEnum<{
6755
- IN_PROGRESS: "IN_PROGRESS";
6756
- SUCCEEDED: "SUCCEEDED";
6757
7024
  FAILED: "FAILED";
7025
+ SUCCEEDED: "SUCCEEDED";
7026
+ IN_PROGRESS: "IN_PROGRESS";
6758
7027
  }>;
6759
7028
  url: z.ZodString;
6760
7029
  startedAt: z.ZodString;
@@ -6766,8 +7035,8 @@ export declare const storefrontDeploymentSchema: z.ZodObject<{
6766
7035
  PUBLISH: "PUBLISH";
6767
7036
  }>;
6768
7037
  status: z.ZodEnum<{
6769
- FAILED: "FAILED";
6770
7038
  PENDING: "PENDING";
7039
+ FAILED: "FAILED";
6771
7040
  RUNNING: "RUNNING";
6772
7041
  DONE: "DONE";
6773
7042
  }>;
@@ -6934,8 +7203,8 @@ export declare const storefrontSiteDomainSchema: z.ZodObject<{
6934
7203
  }, z.core.$strip>>;
6935
7204
  certificateStatus: z.ZodNullable<z.ZodEnum<{
6936
7205
  ACTIVE: "ACTIVE";
6937
- FAILED: "FAILED";
6938
7206
  PENDING: "PENDING";
7207
+ FAILED: "FAILED";
6939
7208
  }>>;
6940
7209
  failureCode: z.ZodNullable<z.ZodString>;
6941
7210
  verifiedAt: z.ZodNullable<z.ZodString>;
@@ -6977,8 +7246,8 @@ export declare const storefrontSiteDomainsSchema: z.ZodObject<{
6977
7246
  }, z.core.$strip>>;
6978
7247
  certificateStatus: z.ZodNullable<z.ZodEnum<{
6979
7248
  ACTIVE: "ACTIVE";
6980
- FAILED: "FAILED";
6981
7249
  PENDING: "PENDING";
7250
+ FAILED: "FAILED";
6982
7251
  }>>;
6983
7252
  failureCode: z.ZodNullable<z.ZodString>;
6984
7253
  verifiedAt: z.ZodNullable<z.ZodString>;
@@ -7212,8 +7481,8 @@ export declare const runStorefrontCheckRequestSchema: z.ZodObject<{
7212
7481
  }, z.core.$strip>;
7213
7482
  export type RunStorefrontCheckRequest = z.infer<typeof runStorefrontCheckRequestSchema>;
7214
7483
  export declare const storefrontCheckStatusSchema: z.ZodEnum<{
7215
- UNKNOWN: "UNKNOWN";
7216
7484
  FAILED: "FAILED";
7485
+ UNKNOWN: "UNKNOWN";
7217
7486
  RUNNING: "RUNNING";
7218
7487
  QUEUED: "QUEUED";
7219
7488
  PASSED: "PASSED";
@@ -7226,8 +7495,8 @@ export declare const storefrontCheckSchema: z.ZodObject<{
7226
7495
  checkId: z.ZodString;
7227
7496
  check: z.ZodString;
7228
7497
  status: z.ZodEnum<{
7229
- UNKNOWN: "UNKNOWN";
7230
7498
  FAILED: "FAILED";
7499
+ UNKNOWN: "UNKNOWN";
7231
7500
  RUNNING: "RUNNING";
7232
7501
  QUEUED: "QUEUED";
7233
7502
  PASSED: "PASSED";
@@ -7311,8 +7580,8 @@ export declare const storefrontVerifyReportSchema: z.ZodObject<{
7311
7580
  }, z.core.$strip>;
7312
7581
  export type StorefrontVerifyReport = z.infer<typeof storefrontVerifyReportSchema>;
7313
7582
  export declare const storefrontBuildStatusSchema: z.ZodEnum<{
7314
- SUCCEEDED: "SUCCEEDED";
7315
7583
  FAILED: "FAILED";
7584
+ SUCCEEDED: "SUCCEEDED";
7316
7585
  RUNNING: "RUNNING";
7317
7586
  QUEUED: "QUEUED";
7318
7587
  TIMED_OUT: "TIMED_OUT";
@@ -7379,8 +7648,8 @@ export declare const storefrontBuildSchema: z.ZodObject<{
7379
7648
  versionId: z.ZodString;
7380
7649
  versionNumber: z.ZodNumber;
7381
7650
  status: z.ZodEnum<{
7382
- SUCCEEDED: "SUCCEEDED";
7383
7651
  FAILED: "FAILED";
7652
+ SUCCEEDED: "SUCCEEDED";
7384
7653
  RUNNING: "RUNNING";
7385
7654
  QUEUED: "QUEUED";
7386
7655
  TIMED_OUT: "TIMED_OUT";
@@ -7508,8 +7777,8 @@ export declare const storefrontVersionCreatedSchema: z.ZodObject<{
7508
7777
  versionId: z.ZodString;
7509
7778
  versionNumber: z.ZodNumber;
7510
7779
  status: z.ZodEnum<{
7511
- SUCCEEDED: "SUCCEEDED";
7512
7780
  FAILED: "FAILED";
7781
+ SUCCEEDED: "SUCCEEDED";
7513
7782
  RUNNING: "RUNNING";
7514
7783
  QUEUED: "QUEUED";
7515
7784
  TIMED_OUT: "TIMED_OUT";
@@ -7761,9 +8030,9 @@ export type UploadTicket = z.infer<typeof uploadTicketSchema>;
7761
8030
  //#endregion
7762
8031
  //#region src/schemas/auth.d.ts
7763
8032
  export declare const storeRoleSchema: z.ZodEnum<{
7764
- OWNER: "OWNER";
7765
8033
  ADMIN: "ADMIN";
7766
8034
  STAFF: "STAFF";
8035
+ OWNER: "OWNER";
7767
8036
  }>;
7768
8037
  export type StoreRole = z.infer<typeof storeRoleSchema>;
7769
8038
  export declare const myStoreSchema: z.ZodObject<{
@@ -7771,14 +8040,14 @@ export declare const myStoreSchema: z.ZodObject<{
7771
8040
  storeName: z.ZodString;
7772
8041
  storeCode: z.ZodString;
7773
8042
  role: z.ZodEnum<{
7774
- OWNER: "OWNER";
7775
8043
  ADMIN: "ADMIN";
7776
8044
  STAFF: "STAFF";
8045
+ OWNER: "OWNER";
7777
8046
  }>;
7778
8047
  status: z.ZodEnum<{
7779
- ACTIVE: "ACTIVE";
7780
8048
  SUSPENDED: "SUSPENDED";
7781
8049
  CLOSED: "CLOSED";
8050
+ ACTIVE: "ACTIVE";
7782
8051
  }>;
7783
8052
  }, z.core.$strip>;
7784
8053
  export type MyStore = z.infer<typeof myStoreSchema>;
@@ -7933,8 +8202,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
7933
8202
  storeId: string;
7934
8203
  storeName: string;
7935
8204
  storeCode: string;
7936
- role: "OWNER" | "ADMIN" | "STAFF";
7937
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
8205
+ role: "ADMIN" | "STAFF" | "OWNER";
8206
+ status: "SUSPENDED" | "CLOSED" | "ACTIVE";
7938
8207
  }[]>;
7939
8208
  me: () => Promise<{
7940
8209
  userId: string;
@@ -7973,7 +8242,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7973
8242
  contents: {
7974
8243
  productId: string;
7975
8244
  name: string;
7976
- status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
8245
+ status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
7977
8246
  salePrice: number;
7978
8247
  discountedPrice: number | null;
7979
8248
  stockQuantity: number;
@@ -7990,7 +8259,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7990
8259
  get: (productId: string) => Promise<{
7991
8260
  productId: string;
7992
8261
  name: string;
7993
- status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
8262
+ status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
7994
8263
  salePrice: number;
7995
8264
  discountedPrice: number | null;
7996
8265
  stockQuantity: number;
@@ -8048,7 +8317,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8048
8317
  fulfillment: UnknownFulfillment | {
8049
8318
  type: "SHIPPING";
8050
8319
  shipping: {
8051
- deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
8320
+ deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
8052
8321
  deliveryFee: number;
8053
8322
  conditionalFreeAmount: number | null;
8054
8323
  shippingAddressId: string | null;
@@ -8088,7 +8357,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8088
8357
  create: (body: ProductCreateRequestInput, idempotencyKey?: string) => Promise<{
8089
8358
  productId: string;
8090
8359
  name: string;
8091
- status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
8360
+ status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
8092
8361
  salePrice: number;
8093
8362
  discountedPrice: number | null;
8094
8363
  stockQuantity: number;
@@ -8146,7 +8415,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8146
8415
  fulfillment: UnknownFulfillment | {
8147
8416
  type: "SHIPPING";
8148
8417
  shipping: {
8149
- deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
8418
+ deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
8150
8419
  deliveryFee: number;
8151
8420
  conditionalFreeAmount: number | null;
8152
8421
  shippingAddressId: string | null;
@@ -8186,7 +8455,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8186
8455
  update: (productId: string, body: ProductReplaceRequestInput) => Promise<{
8187
8456
  productId: string;
8188
8457
  name: string;
8189
- status: "SUSPENDED" | "CLOSED" | "SALE" | "OUT_OF_STOCK";
8458
+ status: "SALE" | "SUSPENDED" | "OUT_OF_STOCK" | "CLOSED";
8190
8459
  salePrice: number;
8191
8460
  discountedPrice: number | null;
8192
8461
  stockQuantity: number;
@@ -8244,7 +8513,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8244
8513
  fulfillment: UnknownFulfillment | {
8245
8514
  type: "SHIPPING";
8246
8515
  shipping: {
8247
- deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
8516
+ deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
8248
8517
  deliveryFee: number;
8249
8518
  conditionalFreeAmount: number | null;
8250
8519
  shippingAddressId: string | null;
@@ -8571,6 +8840,23 @@ export declare function createStoreClient(options: StoreClientOptions): {
8571
8840
  description: string;
8572
8841
  imageUrl: string | null;
8573
8842
  productSort: string;
8843
+ rules: ({
8844
+ field: "createdWithinDays";
8845
+ value: number;
8846
+ } | {
8847
+ field: "category";
8848
+ categoryIds: string[];
8849
+ } | {
8850
+ field: "price";
8851
+ min?: number | undefined;
8852
+ max?: number | undefined;
8853
+ } | {
8854
+ field: "discounted";
8855
+ value: true;
8856
+ } | {
8857
+ [x: string]: unknown;
8858
+ field: string;
8859
+ })[] | null;
8574
8860
  visible: boolean;
8575
8861
  startsAt: string | null;
8576
8862
  endsAt: string | null;
@@ -8599,6 +8885,23 @@ export declare function createStoreClient(options: StoreClientOptions): {
8599
8885
  description: string;
8600
8886
  imageUrl: string | null;
8601
8887
  productSort: string;
8888
+ rules: ({
8889
+ field: "createdWithinDays";
8890
+ value: number;
8891
+ } | {
8892
+ field: "category";
8893
+ categoryIds: string[];
8894
+ } | {
8895
+ field: "price";
8896
+ min?: number | undefined;
8897
+ max?: number | undefined;
8898
+ } | {
8899
+ field: "discounted";
8900
+ value: true;
8901
+ } | {
8902
+ [x: string]: unknown;
8903
+ field: string;
8904
+ })[] | null;
8602
8905
  visible: boolean;
8603
8906
  startsAt: string | null;
8604
8907
  endsAt: string | null;
@@ -8620,6 +8923,23 @@ export declare function createStoreClient(options: StoreClientOptions): {
8620
8923
  description: string;
8621
8924
  imageUrl: string | null;
8622
8925
  productSort: string;
8926
+ rules: ({
8927
+ field: "createdWithinDays";
8928
+ value: number;
8929
+ } | {
8930
+ field: "category";
8931
+ categoryIds: string[];
8932
+ } | {
8933
+ field: "price";
8934
+ min?: number | undefined;
8935
+ max?: number | undefined;
8936
+ } | {
8937
+ field: "discounted";
8938
+ value: true;
8939
+ } | {
8940
+ [x: string]: unknown;
8941
+ field: string;
8942
+ })[] | null;
8623
8943
  visible: boolean;
8624
8944
  startsAt: string | null;
8625
8945
  endsAt: string | null;
@@ -8640,6 +8960,23 @@ export declare function createStoreClient(options: StoreClientOptions): {
8640
8960
  description: string;
8641
8961
  imageUrl: string | null;
8642
8962
  productSort: string;
8963
+ rules: ({
8964
+ field: "createdWithinDays";
8965
+ value: number;
8966
+ } | {
8967
+ field: "category";
8968
+ categoryIds: string[];
8969
+ } | {
8970
+ field: "price";
8971
+ min?: number | undefined;
8972
+ max?: number | undefined;
8973
+ } | {
8974
+ field: "discounted";
8975
+ value: true;
8976
+ } | {
8977
+ [x: string]: unknown;
8978
+ field: string;
8979
+ })[] | null;
8643
8980
  visible: boolean;
8644
8981
  startsAt: string | null;
8645
8982
  endsAt: string | null;
@@ -8653,7 +8990,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8653
8990
  updatedAt: string;
8654
8991
  }>;
8655
8992
  remove: (collectionId: string) => Promise<void>;
8656
- /** 담긴 상품 — 직접 정한 순서 */
8993
+ /** 담긴 상품 — 직접 선택은 정한 순서, 조건 자동은 지금 조건을 만족하는 판매 중 상품(기본 정렬 순) */
8657
8994
  listProducts: (collectionId: string, params?: {
8658
8995
  page?: number;
8659
8996
  size?: number;
@@ -8681,6 +9018,23 @@ export declare function createStoreClient(options: StoreClientOptions): {
8681
9018
  description: string;
8682
9019
  imageUrl: string | null;
8683
9020
  productSort: string;
9021
+ rules: ({
9022
+ field: "createdWithinDays";
9023
+ value: number;
9024
+ } | {
9025
+ field: "category";
9026
+ categoryIds: string[];
9027
+ } | {
9028
+ field: "price";
9029
+ min?: number | undefined;
9030
+ max?: number | undefined;
9031
+ } | {
9032
+ field: "discounted";
9033
+ value: true;
9034
+ } | {
9035
+ [x: string]: unknown;
9036
+ field: string;
9037
+ })[] | null;
8684
9038
  visible: boolean;
8685
9039
  startsAt: string | null;
8686
9040
  endsAt: string | null;
@@ -8702,6 +9056,23 @@ export declare function createStoreClient(options: StoreClientOptions): {
8702
9056
  description: string;
8703
9057
  imageUrl: string | null;
8704
9058
  productSort: string;
9059
+ rules: ({
9060
+ field: "createdWithinDays";
9061
+ value: number;
9062
+ } | {
9063
+ field: "category";
9064
+ categoryIds: string[];
9065
+ } | {
9066
+ field: "price";
9067
+ min?: number | undefined;
9068
+ max?: number | undefined;
9069
+ } | {
9070
+ field: "discounted";
9071
+ value: true;
9072
+ } | {
9073
+ [x: string]: unknown;
9074
+ field: string;
9075
+ })[] | null;
8705
9076
  visible: boolean;
8706
9077
  startsAt: string | null;
8707
9078
  endsAt: string | null;
@@ -8715,6 +9086,19 @@ export declare function createStoreClient(options: StoreClientOptions): {
8715
9086
  updatedAt: string;
8716
9087
  }>;
8717
9088
  removeProduct: (collectionId: string, productId: string) => Promise<void>;
9089
+ /** 조건 자동 미리보기 — 저장하지 않고 조건을 만족하는 판매 중 상품 수와 앞 20개를 본다 */
9090
+ preview: (body: CollectionPreviewRequest) => Promise<{
9091
+ count: number;
9092
+ products: {
9093
+ productId: string;
9094
+ name: string;
9095
+ thumbnailUrl: string | null;
9096
+ status: string;
9097
+ salePrice: number;
9098
+ position: number;
9099
+ addedAt: string;
9100
+ }[];
9101
+ }>;
8718
9102
  };
8719
9103
  categories: {
8720
9104
  list: (params?: {
@@ -8916,6 +9300,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8916
9300
  discountAmount: number;
8917
9301
  couponDiscountAmount: number;
8918
9302
  deliveryDiscountAmount: number;
9303
+ pointAmount: number;
8919
9304
  discounts: {
8920
9305
  couponId: string;
8921
9306
  name: string;
@@ -8982,6 +9367,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8982
9367
  discountAmount: number;
8983
9368
  totalPrice: number;
8984
9369
  couponDiscountAmount: number;
9370
+ pointAllocation: number;
8985
9371
  hold: {
8986
9372
  reason: string;
8987
9373
  expectedDispatchDate: string;
@@ -9067,6 +9453,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9067
9453
  discountAmount: number;
9068
9454
  totalPrice: number;
9069
9455
  couponDiscountAmount: number;
9456
+ pointAllocation: number;
9070
9457
  hold: {
9071
9458
  reason: string;
9072
9459
  expectedDispatchDate: string;
@@ -9107,6 +9494,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9107
9494
  deliveryFeeChargeAmount: number;
9108
9495
  couponChargeAmount: number;
9109
9496
  couponChargeRefundAmount: number;
9497
+ pointRefundAmount: number;
9110
9498
  refundedAt: string;
9111
9499
  }>;
9112
9500
  updateMemo: (orderItemId: string, memo: string) => Promise<void>;
@@ -9118,7 +9506,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9118
9506
  }>;
9119
9507
  dispatch: (orderItemId: string, body: DispatchRequest, idempotencyKey?: string) => Promise<{
9120
9508
  orderItemId: string;
9121
- deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
9509
+ deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
9122
9510
  carrierCode: string | null;
9123
9511
  carrierName: string | null;
9124
9512
  trackingNumber: string | null;
@@ -9180,6 +9568,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9180
9568
  discountAmount: number;
9181
9569
  totalPrice: number;
9182
9570
  couponDiscountAmount: number;
9571
+ pointAllocation: number;
9183
9572
  hold: {
9184
9573
  reason: string;
9185
9574
  expectedDispatchDate: string;
@@ -9248,6 +9637,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9248
9637
  discountAmount: number;
9249
9638
  totalPrice: number;
9250
9639
  couponDiscountAmount: number;
9640
+ pointAllocation: number;
9251
9641
  hold: {
9252
9642
  reason: string;
9253
9643
  expectedDispatchDate: string;
@@ -9278,7 +9668,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9278
9668
  }>;
9279
9669
  getDelivery: (orderItemId: string) => Promise<{
9280
9670
  orderItemId: string;
9281
- deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
9671
+ deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
9282
9672
  carrierCode: string | null;
9283
9673
  carrierName: string | null;
9284
9674
  trackingNumber: string | null;
@@ -9316,7 +9706,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9316
9706
  contents: {
9317
9707
  claimId: string;
9318
9708
  type: "RETURN" | "EXCHANGE" | "CANCEL";
9319
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
9709
+ status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
9320
9710
  orderId: string;
9321
9711
  orderItemId: string;
9322
9712
  productName: string;
@@ -9327,6 +9717,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9327
9717
  claimDeliveryFee: number;
9328
9718
  expectedRefundAmount: number | null;
9329
9719
  expectedDeliveryFeeRefundAmount: number | null;
9720
+ expectedPointRefundAmount: number;
9330
9721
  exchangeOption: {
9331
9722
  optionId: string;
9332
9723
  optionName: string;
@@ -9354,7 +9745,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9354
9745
  get: (claimId: string) => Promise<{
9355
9746
  claimId: string;
9356
9747
  type: "RETURN" | "EXCHANGE" | "CANCEL";
9357
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
9748
+ status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
9358
9749
  orderId: string;
9359
9750
  orderItemId: string;
9360
9751
  productName: string;
@@ -9365,6 +9756,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9365
9756
  claimDeliveryFee: number;
9366
9757
  expectedRefundAmount: number | null;
9367
9758
  expectedDeliveryFeeRefundAmount: number | null;
9759
+ expectedPointRefundAmount: number;
9368
9760
  exchangeOption: {
9369
9761
  optionId: string;
9370
9762
  optionName: string;
@@ -9388,7 +9780,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9388
9780
  address2: string | null;
9389
9781
  } | null;
9390
9782
  histories?: {
9391
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
9783
+ status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
9392
9784
  actor: "SYSTEM" | "BUYER" | "SELLER";
9393
9785
  occurredAt: string;
9394
9786
  }[] | undefined;
@@ -9402,6 +9794,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9402
9794
  deliveryFeeChargeAmount: number;
9403
9795
  couponChargeAmount: number;
9404
9796
  couponChargeRefundAmount: number;
9797
+ pointRefundAmount: number;
9405
9798
  refundedAt: string;
9406
9799
  }>;
9407
9800
  reject: (claimId: string, body: RejectClaimRequest) => Promise<void>;
@@ -9420,7 +9813,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9420
9813
  completeExchange: (claimId: string) => Promise<{
9421
9814
  claimId: string;
9422
9815
  type: "RETURN" | "EXCHANGE" | "CANCEL";
9423
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
9816
+ status: "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED" | "WITHDRAWN";
9424
9817
  orderId: string;
9425
9818
  orderItemId: string;
9426
9819
  productName: string;
@@ -9431,6 +9824,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9431
9824
  claimDeliveryFee: number;
9432
9825
  expectedRefundAmount: number | null;
9433
9826
  expectedDeliveryFeeRefundAmount: number | null;
9827
+ expectedPointRefundAmount: number;
9434
9828
  exchangeOption: {
9435
9829
  optionId: string;
9436
9830
  optionName: string;
@@ -10340,7 +10734,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10340
10734
  conversionRate: number | null;
10341
10735
  };
10342
10736
  funnel: {
10343
- step: "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT" | "PURCHASE";
10737
+ step: "PURCHASE" | "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT";
10344
10738
  sessions: number;
10345
10739
  rateFromPrevious: number | null;
10346
10740
  }[];
@@ -10394,9 +10788,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
10394
10788
  }>;
10395
10789
  /** `GET /v1/analytics/sources` — 채널·소스·캠페인·기기별 세션과 구매 */
10396
10790
  sources: (params: AnalyticsSourcesParams) => Promise<{
10397
- groupBy: "CAMPAIGN" | "CHANNEL" | "SOURCE" | "DEVICE";
10791
+ groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
10398
10792
  rows: {
10399
- channel: "DIRECT" | "ORGANIC_SEARCH" | "SOCIAL" | "PAID" | "EMAIL" | "CAMPAIGN" | "REFERRAL" | "UNKNOWN" | null;
10793
+ channel: "PAID" | "DIRECT" | "CAMPAIGN" | "UNKNOWN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
10400
10794
  source: string | null;
10401
10795
  medium: string | null;
10402
10796
  campaign: string | null;
@@ -10501,7 +10895,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10501
10895
  checkout: (params: AnalyticsRangeParams) => Promise<{
10502
10896
  sessions: number;
10503
10897
  outcomes: {
10504
- outcome: "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "OTHER" | "IN_PROGRESS";
10898
+ outcome: "OTHER" | "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "IN_PROGRESS";
10505
10899
  sessions: number;
10506
10900
  }[];
10507
10901
  from: string;
@@ -10531,7 +10925,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10531
10925
  orderId: string | null;
10532
10926
  orderName: string;
10533
10927
  customerName: string;
10534
- status: "FAILED" | "PENDING" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
10928
+ status: "PENDING" | "FAILED" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
10535
10929
  amount: number;
10536
10930
  refundedAmount: number;
10537
10931
  provider: "tosspayments" | "portone" | null;
@@ -10555,7 +10949,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10555
10949
  orderId: string | null;
10556
10950
  orderName: string;
10557
10951
  customerName: string;
10558
- status: "FAILED" | "PENDING" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
10952
+ status: "PENDING" | "FAILED" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
10559
10953
  amount: number;
10560
10954
  refundedAmount: number;
10561
10955
  provider: "tosspayments" | "portone" | null;
@@ -10593,6 +10987,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10593
10987
  refunds: {
10594
10988
  refundId: string;
10595
10989
  amount: number;
10990
+ pointRefundAmount: number;
10596
10991
  reason: string;
10597
10992
  kind: string;
10598
10993
  status: string;
@@ -10654,7 +11049,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10654
11049
  masked: string | null;
10655
11050
  }[];
10656
11051
  lastVerification: {
10657
- result: "FAILED" | "SUCCESS";
11052
+ result: "SUCCESS" | "FAILED";
10658
11053
  message: string | null;
10659
11054
  checkedAt: string;
10660
11055
  } | null;
@@ -10679,7 +11074,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10679
11074
  masked: string | null;
10680
11075
  }[];
10681
11076
  lastVerification: {
10682
- result: "FAILED" | "SUCCESS";
11077
+ result: "SUCCESS" | "FAILED";
10683
11078
  message: string | null;
10684
11079
  checkedAt: string;
10685
11080
  } | null;
@@ -10703,7 +11098,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10703
11098
  masked: string | null;
10704
11099
  }[];
10705
11100
  lastVerification: {
10706
- result: "FAILED" | "SUCCESS";
11101
+ result: "SUCCESS" | "FAILED";
10707
11102
  message: string | null;
10708
11103
  checkedAt: string;
10709
11104
  } | null;
@@ -10764,7 +11159,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10764
11159
  masked: string | null;
10765
11160
  }[];
10766
11161
  lastVerification: {
10767
- result: "FAILED" | "SUCCESS";
11162
+ result: "SUCCESS" | "FAILED";
10768
11163
  message: string | null;
10769
11164
  checkedAt: string;
10770
11165
  } | null;
@@ -10789,7 +11184,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10789
11184
  masked: string | null;
10790
11185
  }[];
10791
11186
  lastVerification: {
10792
- result: "FAILED" | "SUCCESS";
11187
+ result: "SUCCESS" | "FAILED";
10793
11188
  message: string | null;
10794
11189
  checkedAt: string;
10795
11190
  } | null;
@@ -10813,7 +11208,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10813
11208
  masked: string | null;
10814
11209
  }[];
10815
11210
  lastVerification: {
10816
- result: "FAILED" | "SUCCESS";
11211
+ result: "SUCCESS" | "FAILED";
10817
11212
  message: string | null;
10818
11213
  checkedAt: string;
10819
11214
  } | null;
@@ -10879,7 +11274,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10879
11274
  masked: string | null;
10880
11275
  }[];
10881
11276
  lastVerification: {
10882
- result: "FAILED" | "SUCCESS";
11277
+ result: "SUCCESS" | "FAILED";
10883
11278
  message: string | null;
10884
11279
  checkedAt: string;
10885
11280
  } | null;
@@ -10904,7 +11299,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10904
11299
  masked: string | null;
10905
11300
  }[];
10906
11301
  lastVerification: {
10907
- result: "FAILED" | "SUCCESS";
11302
+ result: "SUCCESS" | "FAILED";
10908
11303
  message: string | null;
10909
11304
  checkedAt: string;
10910
11305
  } | null;
@@ -10928,7 +11323,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10928
11323
  masked: string | null;
10929
11324
  }[];
10930
11325
  lastVerification: {
10931
- result: "FAILED" | "SUCCESS";
11326
+ result: "SUCCESS" | "FAILED";
10932
11327
  message: string | null;
10933
11328
  checkedAt: string;
10934
11329
  } | null;
@@ -10975,7 +11370,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10975
11370
  masked: string | null;
10976
11371
  }[];
10977
11372
  lastVerification: {
10978
- result: "FAILED" | "SUCCESS";
11373
+ result: "SUCCESS" | "FAILED";
10979
11374
  message: string | null;
10980
11375
  checkedAt: string;
10981
11376
  } | null;
@@ -11000,7 +11395,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11000
11395
  masked: string | null;
11001
11396
  }[];
11002
11397
  lastVerification: {
11003
- result: "FAILED" | "SUCCESS";
11398
+ result: "SUCCESS" | "FAILED";
11004
11399
  message: string | null;
11005
11400
  checkedAt: string;
11006
11401
  } | null;
@@ -11024,7 +11419,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11024
11419
  masked: string | null;
11025
11420
  }[];
11026
11421
  lastVerification: {
11027
- result: "FAILED" | "SUCCESS";
11422
+ result: "SUCCESS" | "FAILED";
11028
11423
  message: string | null;
11029
11424
  checkedAt: string;
11030
11425
  } | null;
@@ -11081,7 +11476,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11081
11476
  masked: string | null;
11082
11477
  }[];
11083
11478
  lastVerification: {
11084
- result: "FAILED" | "SUCCESS";
11479
+ result: "SUCCESS" | "FAILED";
11085
11480
  message: string | null;
11086
11481
  checkedAt: string;
11087
11482
  } | null;
@@ -11106,7 +11501,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11106
11501
  masked: string | null;
11107
11502
  }[];
11108
11503
  lastVerification: {
11109
- result: "FAILED" | "SUCCESS";
11504
+ result: "SUCCESS" | "FAILED";
11110
11505
  message: string | null;
11111
11506
  checkedAt: string;
11112
11507
  } | null;
@@ -11130,7 +11525,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11130
11525
  masked: string | null;
11131
11526
  }[];
11132
11527
  lastVerification: {
11133
- result: "FAILED" | "SUCCESS";
11528
+ result: "SUCCESS" | "FAILED";
11134
11529
  message: string | null;
11135
11530
  checkedAt: string;
11136
11531
  } | null;
@@ -11177,7 +11572,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11177
11572
  masked: string | null;
11178
11573
  }[];
11179
11574
  lastVerification: {
11180
- result: "FAILED" | "SUCCESS";
11575
+ result: "SUCCESS" | "FAILED";
11181
11576
  message: string | null;
11182
11577
  checkedAt: string;
11183
11578
  } | null;
@@ -11202,7 +11597,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11202
11597
  masked: string | null;
11203
11598
  }[];
11204
11599
  lastVerification: {
11205
- result: "FAILED" | "SUCCESS";
11600
+ result: "SUCCESS" | "FAILED";
11206
11601
  message: string | null;
11207
11602
  checkedAt: string;
11208
11603
  } | null;
@@ -11226,7 +11621,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11226
11621
  masked: string | null;
11227
11622
  }[];
11228
11623
  lastVerification: {
11229
- result: "FAILED" | "SUCCESS";
11624
+ result: "SUCCESS" | "FAILED";
11230
11625
  message: string | null;
11231
11626
  checkedAt: string;
11232
11627
  } | null;
@@ -11282,7 +11677,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11282
11677
  masked: string | null;
11283
11678
  }[];
11284
11679
  lastVerification: {
11285
- result: "FAILED" | "SUCCESS";
11680
+ result: "SUCCESS" | "FAILED";
11286
11681
  message: string | null;
11287
11682
  checkedAt: string;
11288
11683
  } | null;
@@ -11307,7 +11702,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11307
11702
  masked: string | null;
11308
11703
  }[];
11309
11704
  lastVerification: {
11310
- result: "FAILED" | "SUCCESS";
11705
+ result: "SUCCESS" | "FAILED";
11311
11706
  message: string | null;
11312
11707
  checkedAt: string;
11313
11708
  } | null;
@@ -11331,7 +11726,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11331
11726
  masked: string | null;
11332
11727
  }[];
11333
11728
  lastVerification: {
11334
- result: "FAILED" | "SUCCESS";
11729
+ result: "SUCCESS" | "FAILED";
11335
11730
  message: string | null;
11336
11731
  checkedAt: string;
11337
11732
  } | null;
@@ -11359,7 +11754,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11359
11754
  verify: (provider: PgProvider, body?: VerifyPaymentProviderRequest) => Promise<{
11360
11755
  provider: "tosspayments" | "portone";
11361
11756
  environment: "TEST" | "LIVE";
11362
- result: "FAILED" | "SUCCESS";
11757
+ result: "SUCCESS" | "FAILED";
11363
11758
  message: string | null;
11364
11759
  checkedAt: string;
11365
11760
  }>;
@@ -11369,7 +11764,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11369
11764
  webhookId: string;
11370
11765
  url: string;
11371
11766
  eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
11372
- status: "ACTIVE" | "SUSPENDED";
11767
+ status: "SUSPENDED" | "ACTIVE";
11373
11768
  secretPrefix: string;
11374
11769
  suspendedAt: string | null;
11375
11770
  createdAt: string;
@@ -11379,7 +11774,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11379
11774
  webhookId: string;
11380
11775
  url: string;
11381
11776
  eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
11382
- status: "ACTIVE" | "SUSPENDED";
11777
+ status: "SUSPENDED" | "ACTIVE";
11383
11778
  secretPrefix: string;
11384
11779
  suspendedAt: string | null;
11385
11780
  createdAt: string;
@@ -11389,7 +11784,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11389
11784
  webhookId: string;
11390
11785
  url: string;
11391
11786
  eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
11392
- status: "ACTIVE" | "SUSPENDED";
11787
+ status: "SUSPENDED" | "ACTIVE";
11393
11788
  secretPrefix: string;
11394
11789
  suspendedAt: string | null;
11395
11790
  createdAt: string;
@@ -11399,7 +11794,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11399
11794
  webhookId: string;
11400
11795
  url: string;
11401
11796
  eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
11402
- status: "ACTIVE" | "SUSPENDED";
11797
+ status: "SUSPENDED" | "ACTIVE";
11403
11798
  secretPrefix: string;
11404
11799
  suspendedAt: string | null;
11405
11800
  createdAt: string;
@@ -11414,7 +11809,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11414
11809
  webhookId: string;
11415
11810
  url: string;
11416
11811
  eventTypes: ("ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK")[];
11417
- status: "ACTIVE" | "SUSPENDED";
11812
+ status: "SUSPENDED" | "ACTIVE";
11418
11813
  secretPrefix: string;
11419
11814
  suspendedAt: string | null;
11420
11815
  createdAt: string;
@@ -11425,7 +11820,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11425
11820
  eventId: string;
11426
11821
  eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
11427
11822
  url: string;
11428
- status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
11823
+ status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
11429
11824
  responseStatusCode: number | null;
11430
11825
  responseTimeMs: number | null;
11431
11826
  responseBodyExcerpt: string | null;
@@ -11452,7 +11847,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11452
11847
  eventId: string;
11453
11848
  eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
11454
11849
  url: string;
11455
- status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
11850
+ status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
11456
11851
  responseStatusCode: number | null;
11457
11852
  responseTimeMs: number | null;
11458
11853
  responseBodyExcerpt: string | null;
@@ -11487,7 +11882,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11487
11882
  eventId: string;
11488
11883
  eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK";
11489
11884
  url: string;
11490
- status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
11885
+ status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
11491
11886
  responseStatusCode: number | null;
11492
11887
  responseTimeMs: number | null;
11493
11888
  responseBodyExcerpt: string | null;
@@ -11583,7 +11978,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11583
11978
  method: string | null;
11584
11979
  path: string | null;
11585
11980
  statusCode: number | null;
11586
- outcome: "SUCCEEDED" | "FAILED" | "PENDING_APPROVAL" | "DENIED" | "DRY_RUN" | null;
11981
+ outcome: "FAILED" | "SUCCEEDED" | "PENDING_APPROVAL" | "DENIED" | "DRY_RUN" | null;
11587
11982
  errorCode: string | null;
11588
11983
  traceId: string | null;
11589
11984
  idempotencyKey: string | null;
@@ -11601,7 +11996,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11601
11996
  list: (params?: ApprovalListOptions) => Promise<{
11602
11997
  items: {
11603
11998
  approvalId: string;
11604
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
11999
+ status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
11605
12000
  operationId: string;
11606
12001
  method: string;
11607
12002
  path: string;
@@ -11651,7 +12046,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11651
12046
  }>;
11652
12047
  get: (approvalId: string) => Promise<{
11653
12048
  approvalId: string;
11654
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
12049
+ status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
11655
12050
  operationId: string;
11656
12051
  method: string;
11657
12052
  path: string;
@@ -11703,7 +12098,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11703
12098
  */
11704
12099
  approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
11705
12100
  approvalId: string;
11706
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
12101
+ status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
11707
12102
  operationId: string;
11708
12103
  method: string;
11709
12104
  path: string;
@@ -11751,7 +12146,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11751
12146
  }>;
11752
12147
  reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
11753
12148
  approvalId: string;
11754
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
12149
+ status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
11755
12150
  operationId: string;
11756
12151
  method: string;
11757
12152
  path: string;
@@ -11901,7 +12296,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11901
12296
  }[];
11902
12297
  templateId: string;
11903
12298
  sourceMode: "CUSTOM" | "MANAGED";
11904
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
12299
+ status: "SUSPENDED" | "CLOSED" | "ACTIVE";
11905
12300
  visibility: "COMING_SOON" | "PUBLIC";
11906
12301
  publishedVersion: {
11907
12302
  versionId: string;
@@ -11919,7 +12314,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11919
12314
  createdVia?: string | null | undefined;
11920
12315
  } | null;
11921
12316
  provisioning: {
11922
- status: "FAILED" | "PENDING" | "SYNCED";
12317
+ status: "PENDING" | "FAILED" | "SYNCED";
11923
12318
  lastErrorCode: string | null;
11924
12319
  syncedAt: string | null;
11925
12320
  };
@@ -11959,7 +12354,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11959
12354
  }[];
11960
12355
  templateId: string;
11961
12356
  sourceMode: "CUSTOM" | "MANAGED";
11962
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
12357
+ status: "SUSPENDED" | "CLOSED" | "ACTIVE";
11963
12358
  visibility: "COMING_SOON" | "PUBLIC";
11964
12359
  publishedVersion: {
11965
12360
  versionId: string;
@@ -11977,7 +12372,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11977
12372
  createdVia?: string | null | undefined;
11978
12373
  } | null;
11979
12374
  provisioning: {
11980
- status: "FAILED" | "PENDING" | "SYNCED";
12375
+ status: "PENDING" | "FAILED" | "SYNCED";
11981
12376
  lastErrorCode: string | null;
11982
12377
  syncedAt: string | null;
11983
12378
  };
@@ -11995,13 +12390,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
11995
12390
  /** `GET /v1/storefront/site/deployment` — 배포 진행(단계·기록). 만든 뒤 반영이 끝날 때까지 폴링한다 */
11996
12391
  getDeployment: () => Promise<{
11997
12392
  siteId: string;
11998
- status: "IN_PROGRESS" | "SUCCEEDED" | "FAILED";
12393
+ status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
11999
12394
  url: string;
12000
12395
  startedAt: string;
12001
12396
  finishedAt: string | null;
12002
12397
  steps: {
12003
12398
  key: "SITE" | "UPLOAD" | "PUBLISH";
12004
- status: "FAILED" | "PENDING" | "RUNNING" | "DONE";
12399
+ status: "PENDING" | "FAILED" | "RUNNING" | "DONE";
12005
12400
  finishedAt: string | null;
12006
12401
  }[];
12007
12402
  log: {
@@ -12017,13 +12412,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
12017
12412
  /** `POST /v1/storefront/site/deployment/retry` (202) — 밀린 반영을 곧바로 다시 시도한다. 이미 반영됐으면 그대로다 */
12018
12413
  retryDeployment: () => Promise<{
12019
12414
  siteId: string;
12020
- status: "IN_PROGRESS" | "SUCCEEDED" | "FAILED";
12415
+ status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
12021
12416
  url: string;
12022
12417
  startedAt: string;
12023
12418
  finishedAt: string | null;
12024
12419
  steps: {
12025
12420
  key: "SITE" | "UPLOAD" | "PUBLISH";
12026
- status: "FAILED" | "PENDING" | "RUNNING" | "DONE";
12421
+ status: "PENDING" | "FAILED" | "RUNNING" | "DONE";
12027
12422
  finishedAt: string | null;
12028
12423
  }[];
12029
12424
  log: {
@@ -12055,7 +12450,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12055
12450
  }[];
12056
12451
  templateId: string;
12057
12452
  sourceMode: "CUSTOM" | "MANAGED";
12058
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
12453
+ status: "SUSPENDED" | "CLOSED" | "ACTIVE";
12059
12454
  visibility: "COMING_SOON" | "PUBLIC";
12060
12455
  publishedVersion: {
12061
12456
  versionId: string;
@@ -12073,7 +12468,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12073
12468
  createdVia?: string | null | undefined;
12074
12469
  } | null;
12075
12470
  provisioning: {
12076
- status: "FAILED" | "PENDING" | "SYNCED";
12471
+ status: "PENDING" | "FAILED" | "SYNCED";
12077
12472
  lastErrorCode: string | null;
12078
12473
  syncedAt: string | null;
12079
12474
  };
@@ -12119,7 +12514,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12119
12514
  }[];
12120
12515
  templateId: string;
12121
12516
  sourceMode: "CUSTOM" | "MANAGED";
12122
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
12517
+ status: "SUSPENDED" | "CLOSED" | "ACTIVE";
12123
12518
  visibility: "COMING_SOON" | "PUBLIC";
12124
12519
  publishedVersion: {
12125
12520
  versionId: string;
@@ -12137,7 +12532,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12137
12532
  createdVia?: string | null | undefined;
12138
12533
  } | null;
12139
12534
  provisioning: {
12140
- status: "FAILED" | "PENDING" | "SYNCED";
12535
+ status: "PENDING" | "FAILED" | "SYNCED";
12141
12536
  lastErrorCode: string | null;
12142
12537
  syncedAt: string | null;
12143
12538
  };
@@ -12167,7 +12562,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12167
12562
  }[];
12168
12563
  templateId: string;
12169
12564
  sourceMode: "CUSTOM" | "MANAGED";
12170
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
12565
+ status: "SUSPENDED" | "CLOSED" | "ACTIVE";
12171
12566
  visibility: "COMING_SOON" | "PUBLIC";
12172
12567
  publishedVersion: {
12173
12568
  versionId: string;
@@ -12185,7 +12580,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12185
12580
  createdVia?: string | null | undefined;
12186
12581
  } | null;
12187
12582
  provisioning: {
12188
- status: "FAILED" | "PENDING" | "SYNCED";
12583
+ status: "PENDING" | "FAILED" | "SYNCED";
12189
12584
  lastErrorCode: string | null;
12190
12585
  syncedAt: string | null;
12191
12586
  };
@@ -12215,7 +12610,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12215
12610
  }[];
12216
12611
  templateId: string;
12217
12612
  sourceMode: "CUSTOM" | "MANAGED";
12218
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
12613
+ status: "SUSPENDED" | "CLOSED" | "ACTIVE";
12219
12614
  visibility: "COMING_SOON" | "PUBLIC";
12220
12615
  publishedVersion: {
12221
12616
  versionId: string;
@@ -12233,7 +12628,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12233
12628
  createdVia?: string | null | undefined;
12234
12629
  } | null;
12235
12630
  provisioning: {
12236
- status: "FAILED" | "PENDING" | "SYNCED";
12631
+ status: "PENDING" | "FAILED" | "SYNCED";
12237
12632
  lastErrorCode: string | null;
12238
12633
  syncedAt: string | null;
12239
12634
  };
@@ -12263,7 +12658,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12263
12658
  }[];
12264
12659
  templateId: string;
12265
12660
  sourceMode: "CUSTOM" | "MANAGED";
12266
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
12661
+ status: "SUSPENDED" | "CLOSED" | "ACTIVE";
12267
12662
  visibility: "COMING_SOON" | "PUBLIC";
12268
12663
  publishedVersion: {
12269
12664
  versionId: string;
@@ -12281,7 +12676,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12281
12676
  createdVia?: string | null | undefined;
12282
12677
  } | null;
12283
12678
  provisioning: {
12284
- status: "FAILED" | "PENDING" | "SYNCED";
12679
+ status: "PENDING" | "FAILED" | "SYNCED";
12285
12680
  lastErrorCode: string | null;
12286
12681
  syncedAt: string | null;
12287
12682
  };
@@ -12321,7 +12716,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12321
12716
  value: string;
12322
12717
  purpose: "ROUTING" | "OWNERSHIP";
12323
12718
  }[];
12324
- certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
12719
+ certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
12325
12720
  failureCode: string | null;
12326
12721
  verifiedAt: string | null;
12327
12722
  activatedAt: string | null;
@@ -12345,7 +12740,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12345
12740
  value: string;
12346
12741
  purpose: "ROUTING" | "OWNERSHIP";
12347
12742
  }[];
12348
- certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
12743
+ certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
12349
12744
  failureCode: string | null;
12350
12745
  verifiedAt: string | null;
12351
12746
  activatedAt: string | null;
@@ -12365,7 +12760,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12365
12760
  value: string;
12366
12761
  purpose: "ROUTING" | "OWNERSHIP";
12367
12762
  }[];
12368
- certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
12763
+ certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
12369
12764
  failureCode: string | null;
12370
12765
  verifiedAt: string | null;
12371
12766
  activatedAt: string | null;
@@ -12389,7 +12784,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12389
12784
  value: string;
12390
12785
  purpose: "ROUTING" | "OWNERSHIP";
12391
12786
  }[];
12392
- certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
12787
+ certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
12393
12788
  failureCode: string | null;
12394
12789
  verifiedAt: string | null;
12395
12790
  activatedAt: string | null;
@@ -12414,7 +12809,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12414
12809
  }[];
12415
12810
  templateId: string;
12416
12811
  sourceMode: "CUSTOM" | "MANAGED";
12417
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
12812
+ status: "SUSPENDED" | "CLOSED" | "ACTIVE";
12418
12813
  visibility: "COMING_SOON" | "PUBLIC";
12419
12814
  publishedVersion: {
12420
12815
  versionId: string;
@@ -12432,7 +12827,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12432
12827
  createdVia?: string | null | undefined;
12433
12828
  } | null;
12434
12829
  provisioning: {
12435
- status: "FAILED" | "PENDING" | "SYNCED";
12830
+ status: "PENDING" | "FAILED" | "SYNCED";
12436
12831
  lastErrorCode: string | null;
12437
12832
  syncedAt: string | null;
12438
12833
  };
@@ -12592,7 +12987,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12592
12987
  runCheck: (body: RunStorefrontCheckRequest) => Promise<{
12593
12988
  checkId: string;
12594
12989
  check: string;
12595
- status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
12990
+ status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
12596
12991
  exitCode: number | null;
12597
12992
  durationMs: number | null;
12598
12993
  outputTail: string | null;
@@ -12606,7 +13001,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12606
13001
  getCheck: (checkId: string) => Promise<{
12607
13002
  checkId: string;
12608
13003
  check: string;
12609
- status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
13004
+ status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
12610
13005
  exitCode: number | null;
12611
13006
  durationMs: number | null;
12612
13007
  outputTail: string | null;
@@ -12673,7 +13068,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12673
13068
  buildId: string;
12674
13069
  versionId: string;
12675
13070
  versionNumber: number;
12676
- status: "SUCCEEDED" | "FAILED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
13071
+ status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
12677
13072
  failureStage: string | null;
12678
13073
  errorCode: string | null;
12679
13074
  logTail: string | null;
@@ -12754,7 +13149,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12754
13149
  buildId: string;
12755
13150
  versionId: string;
12756
13151
  versionNumber: number;
12757
- status: "SUCCEEDED" | "FAILED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
13152
+ status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
12758
13153
  failureStage: string | null;
12759
13154
  errorCode: string | null;
12760
13155
  logTail: string | null;
@@ -12832,7 +13227,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12832
13227
  buildId: string;
12833
13228
  versionId: string;
12834
13229
  versionNumber: number;
12835
- status: "SUCCEEDED" | "FAILED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
13230
+ status: "FAILED" | "SUCCEEDED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
12836
13231
  failureStage: string | null;
12837
13232
  errorCode: string | null;
12838
13233
  logTail: string | null;
@@ -13117,7 +13512,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
13117
13512
  name: string;
13118
13513
  storeCode: string;
13119
13514
  storefrontUrl: string;
13120
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
13515
+ status: "SUSPENDED" | "CLOSED" | "ACTIVE";
13121
13516
  logoUrl: string | null;
13122
13517
  businessNumber: string | null;
13123
13518
  customerCenterPhone: string | null;
@@ -13165,7 +13560,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
13165
13560
  name: string;
13166
13561
  storeCode: string;
13167
13562
  storefrontUrl: string;
13168
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
13563
+ status: "SUSPENDED" | "CLOSED" | "ACTIVE";
13169
13564
  logoUrl: string | null;
13170
13565
  businessNumber: string | null;
13171
13566
  customerCenterPhone: string | null;
@@ -13186,6 +13581,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
13186
13581
  enabled: boolean;
13187
13582
  rateBp: number;
13188
13583
  };
13584
+ useAvailable: boolean;
13585
+ use: {
13586
+ enabled: boolean;
13587
+ minBalance: number;
13588
+ minAmount: number;
13589
+ unit: 1 | 100 | 10;
13590
+ maxRatioBp: number;
13591
+ includeDeliveryFee: boolean;
13592
+ };
13189
13593
  expiryDays: number | null;
13190
13594
  notice: "REVIEW_REWARD_PAUSED" | "POINTS_AVAILABLE" | null;
13191
13595
  }>;
@@ -13205,6 +13609,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
13205
13609
  enabled: boolean;
13206
13610
  rateBp: number;
13207
13611
  };
13612
+ useAvailable: boolean;
13613
+ use: {
13614
+ enabled: boolean;
13615
+ minBalance: number;
13616
+ minAmount: number;
13617
+ unit: 1 | 100 | 10;
13618
+ maxRatioBp: number;
13619
+ includeDeliveryFee: boolean;
13620
+ };
13208
13621
  expiryDays: number | null;
13209
13622
  notice: "REVIEW_REWARD_PAUSED" | "POINTS_AVAILABLE" | null;
13210
13623
  }>;
@@ -13212,7 +13625,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
13212
13625
  userId: string;
13213
13626
  name: string;
13214
13627
  email: string;
13215
- role: "OWNER" | "ADMIN" | "STAFF";
13628
+ role: "ADMIN" | "STAFF" | "OWNER";
13216
13629
  joinedAt: string;
13217
13630
  lastActiveAt: string | null;
13218
13631
  }[]>;
@@ -13489,8 +13902,29 @@ export interface PricingDelivery {
13489
13902
  remoteSurcharge: number;
13490
13903
  }>;
13491
13904
  }
13905
+ /**
13906
+ * 적립금 사용 입력(#93 P3) — 쿠폰 뒤 금액에 쓴다. 규칙은 상점 정책 `use`(`PointUsePolicy`)의 값이다.
13907
+ * 금액은 요청·잔액·최대 비율 중 작은 값을 `unit`으로 내리고, 남는 결제 금액이 100원 아래로 내려가지 않게 줄인다(적립금 전액 결제는 아직 받지 않는다).
13908
+ */
13909
+ export interface PricingPoints {
13910
+ /** 구매자가 쓰겠다는 금액 */
13911
+ requested: number;
13912
+ /** 지금 잔액 */
13913
+ balance: number;
13914
+ rules: {
13915
+ minBalance: number;
13916
+ minAmount: number;
13917
+ unit: number;
13918
+ maxRatioBp: number;
13919
+ includeDeliveryFee: boolean;
13920
+ };
13921
+ }
13922
+ /** 적립금을 쓰지 못한 이유 */
13923
+ export type PointRejectReason = "MIN_BALANCE" | "MIN_AMOUNT" | "NOT_PAYABLE";
13492
13924
  export interface PricingInput {
13493
13925
  lines: readonly PricingLine[];
13926
+ /** 적립금 사용(#93 P3). 없으면 쓰지 않는다 — 결과는 적립금 이전과 같다 */
13927
+ points?: PricingPoints | null;
13494
13928
  coupons: readonly PricingCoupon[];
13495
13929
  /** 배송비 견적. 없으면 배송비 0으로 계산하고 배송비 쿠폰은 할인할 금액이 없다 */
13496
13930
  delivery?: PricingDelivery | null;
@@ -13519,6 +13953,8 @@ export interface PricingLineResult {
13519
13953
  /** 이 줄에 들어간 쿠폰 할인 합계 — 상품 쿠폰 + 주문 쿠폰 배분 */
13520
13954
  couponDiscount: number;
13521
13955
  allocations: CouponAllocation[];
13956
+ /** 이 줄에 배분한 사용 적립금(#93 P3). 적립금을 쓰지 않으면 0 */
13957
+ pointAllocation: number;
13522
13958
  }
13523
13959
  export interface PricingCouponResult {
13524
13960
  couponKey: string;
@@ -13536,6 +13972,8 @@ export interface PricingCouponResult {
13536
13972
  export interface PricingBundleResult {
13537
13973
  bundleKey: string;
13538
13974
  couponDiscount: number;
13975
+ /** 이 배송 묶음에 배분한 사용 적립금(#93 P3) */
13976
+ pointAllocation: number;
13539
13977
  }
13540
13978
  export interface PricingResult {
13541
13979
  lines: PricingLineResult[];
@@ -13550,7 +13988,15 @@ export interface PricingResult {
13550
13988
  deliveryFee: number;
13551
13989
  /** 배송비 쿠폰 할인 */
13552
13990
  deliveryDiscountAmount: number;
13553
- /** 결제 금액 = productAmount − couponDiscountAmount + deliveryFee − deliveryDiscountAmount */
13991
+ /** 사용 적립금(#93 P3). 쓰지 않으면 0 */
13992
+ pointAmount: number;
13993
+ /** 지금 쓸 수 있는 최대 적립금 — 주문서 안내값(잔액을 모두 요청했을 때의 금액). 적립금 입력이 없으면 0 */
13994
+ pointMaxUsable: number;
13995
+ /** 요청보다 적게 썼다면 그 이유 — `MIN_PAYMENT`: 결제 금액 100원을 남기려고 줄였다 */
13996
+ pointAdjustReason: "MIN_PAYMENT" | null;
13997
+ /** 요청했지만 쓰지 못했다면 그 이유 */
13998
+ pointRejectReason: PointRejectReason | null;
13999
+ /** 결제 금액 = productAmount − couponDiscountAmount + deliveryFee − deliveryDiscountAmount − pointAmount */
13554
14000
  totalAmount: number;
13555
14001
  }
13556
14002
  /**
@@ -13579,6 +14025,20 @@ export declare function isCouponTargetLine(rule: Pick<CouponRule, "target" | "co
13579
14025
  * 사본 중 앞 장이 만료됐으면 뒤 장이 쓰인다. 결과의 `coupons`는 입력 순서 그대로다. 입력이 같으면 결과도 같다.
13580
14026
  */
13581
14027
  export declare function quotePricing(input: PricingInput): PricingResult;
14028
+ /**
14029
+ * 사용 적립금 금액(순수) — 요청·잔액·최대 비율·「결제 금액 100원 남기기」 중 작은 값을 단위로 내린다.
14030
+ * 최소 보유액·최소 사용액에 못 미치면 0이다. 결제 금액이 0원이 되는 사용(적립금 전액 결제)은 아직 받지 않는다(P4).
14031
+ */
14032
+ export declare function pointUseOf(points: PricingPoints | null, amounts: {
14033
+ productPaid: number;
14034
+ deliveryPaid: number;
14035
+ total: number;
14036
+ }): {
14037
+ amount: number;
14038
+ maxUsable: number;
14039
+ adjustReason: "MIN_PAYMENT" | null;
14040
+ rejectReason: PointRejectReason | null;
14041
+ };
13582
14042
  /**
13583
14043
  * 주문이 받은 쿠폰 한 장 — 주문 시점 규칙과 대상 줄을 굳힌 값이다(`orders.discounts`의 항목).
13584
14044
  * 환불 정산은 이 값만 읽는다. 셀러가 쿠폰을 바꾸거나 상품의 카테고리가 바뀌어도 결과가 같다.
@@ -13678,6 +14138,16 @@ export declare function settleCouponShortfall(input: CouponSettlementInput): Cou
13678
14138
  export declare function proratedPaidRefundBase(item: {
13679
14139
  totalPrice: number;
13680
14140
  couponDiscountAmount?: number | null;
14141
+ /** 주문상품에 배분된 사용 적립금(#93 P3) — 현금 환불 기준에서 뺀다. 없으면 0 */
14142
+ pointAllocation?: number | null;
14143
+ quantity: number;
14144
+ }, settledQuantity: number, cancelQuantity: number): number;
14145
+ /**
14146
+ * 주문상품의 사용 적립금 중 이번 취소 수량의 몫(#93 P3) — 누적 내림의 차분이라 나눠 취소해도 합이 배분액과 같다.
14147
+ * 현금 환불(`proratedPaidRefundBase`)과 따로 돌려준다(`pointRefundAmount`).
14148
+ */
14149
+ export declare function proratedPointRefund(item: {
14150
+ pointAllocation?: number | null;
13681
14151
  quantity: number;
13682
14152
  }, settledQuantity: number, cancelQuantity: number): number;
13683
14153
  //#endregion
@@ -14399,6 +14869,7 @@ export declare const orderWebhookEventDataSchema: z.ZodObject<{
14399
14869
  }>;
14400
14870
  testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
14401
14871
  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14872
+ pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14402
14873
  orderItemId: z.ZodOptional<z.ZodString>;
14403
14874
  fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
14404
14875
  type: z.ZodLiteral<"SHIPPING">;
@@ -14503,6 +14974,7 @@ export declare const orderCanceledWebhookEventDataSchema: z.ZodObject<{
14503
14974
  deliveryFeeChargeAmount: z.ZodNumber;
14504
14975
  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14505
14976
  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14977
+ pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14506
14978
  testPayment: z.ZodBoolean;
14507
14979
  }, z.core.$strip>;
14508
14980
  export type OrderCanceledWebhookEventData = z.infer<typeof orderCanceledWebhookEventDataSchema>;
@@ -14516,7 +14988,6 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
14516
14988
  CANCEL: "CANCEL";
14517
14989
  }>;
14518
14990
  status: z.ZodEnum<{
14519
- COMPLETED: "COMPLETED";
14520
14991
  REJECTED: "REJECTED";
14521
14992
  REQUESTED: "REQUESTED";
14522
14993
  HELD: "HELD";
@@ -14524,6 +14995,7 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
14524
14995
  COLLECTED: "COLLECTED";
14525
14996
  REDELIVERING: "REDELIVERING";
14526
14997
  APPROVED: "APPROVED";
14998
+ COMPLETED: "COMPLETED";
14527
14999
  WITHDRAWN: "WITHDRAWN";
14528
15000
  }>;
14529
15001
  quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -14533,6 +15005,7 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
14533
15005
  deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14534
15006
  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14535
15007
  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
15008
+ pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14536
15009
  testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
14537
15010
  }, z.core.$strip>;
14538
15011
  export type ClaimWebhookEventData = z.infer<typeof claimWebhookEventDataSchema>;
@@ -14575,6 +15048,7 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
14575
15048
  }>;
14576
15049
  testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
14577
15050
  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
15051
+ pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14578
15052
  orderItemId: z.ZodOptional<z.ZodString>;
14579
15053
  fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
14580
15054
  type: z.ZodLiteral<"SHIPPING">;
@@ -14682,6 +15156,7 @@ export declare const orderCanceledWebhookEventSchema: z.ZodObject<{
14682
15156
  deliveryFeeChargeAmount: z.ZodNumber;
14683
15157
  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14684
15158
  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
15159
+ pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14685
15160
  testPayment: z.ZodBoolean;
14686
15161
  }, z.core.$strip>;
14687
15162
  id: z.ZodString;
@@ -14706,7 +15181,6 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
14706
15181
  CANCEL: "CANCEL";
14707
15182
  }>;
14708
15183
  status: z.ZodEnum<{
14709
- COMPLETED: "COMPLETED";
14710
15184
  REJECTED: "REJECTED";
14711
15185
  REQUESTED: "REQUESTED";
14712
15186
  HELD: "HELD";
@@ -14714,6 +15188,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
14714
15188
  COLLECTED: "COLLECTED";
14715
15189
  REDELIVERING: "REDELIVERING";
14716
15190
  APPROVED: "APPROVED";
15191
+ COMPLETED: "COMPLETED";
14717
15192
  WITHDRAWN: "WITHDRAWN";
14718
15193
  }>;
14719
15194
  quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -14723,6 +15198,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
14723
15198
  deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14724
15199
  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14725
15200
  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
15201
+ pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14726
15202
  testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
14727
15203
  }, z.core.$strip>;
14728
15204
  id: z.ZodString;
@@ -14788,6 +15264,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
14788
15264
  }>;
14789
15265
  testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
14790
15266
  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
15267
+ pointAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14791
15268
  orderItemId: z.ZodOptional<z.ZodString>;
14792
15269
  fulfillmentSnapshot: z.ZodOptional<z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
14793
15270
  type: z.ZodLiteral<"SHIPPING">;
@@ -14893,6 +15370,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
14893
15370
  deliveryFeeChargeAmount: z.ZodNumber;
14894
15371
  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14895
15372
  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
15373
+ pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14896
15374
  testPayment: z.ZodBoolean;
14897
15375
  }, z.core.$strip>;
14898
15376
  id: z.ZodString;
@@ -14916,7 +15394,6 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
14916
15394
  CANCEL: "CANCEL";
14917
15395
  }>;
14918
15396
  status: z.ZodEnum<{
14919
- COMPLETED: "COMPLETED";
14920
15397
  REJECTED: "REJECTED";
14921
15398
  REQUESTED: "REQUESTED";
14922
15399
  HELD: "HELD";
@@ -14924,6 +15401,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
14924
15401
  COLLECTED: "COLLECTED";
14925
15402
  REDELIVERING: "REDELIVERING";
14926
15403
  APPROVED: "APPROVED";
15404
+ COMPLETED: "COMPLETED";
14927
15405
  WITHDRAWN: "WITHDRAWN";
14928
15406
  }>;
14929
15407
  quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -14933,6 +15411,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
14933
15411
  deductAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14934
15412
  couponChargeAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14935
15413
  couponChargeRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
15414
+ pointRefundAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14936
15415
  testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
14937
15416
  }, z.core.$strip>;
14938
15417
  id: z.ZodString;