@sayren/store-sdk 0.28.0 → 0.28.2

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 (29) hide show
  1. package/dist/index.d.mts +393 -324
  2. package/dist/index.mjs +184 -134
  3. package/dist/server.d.mts +1 -1
  4. package/dist/server.mjs +1 -1
  5. package/package.json +1 -1
  6. package/src/client.ts +21 -21
  7. package/src/http.ts +1 -1
  8. package/src/member-delegation.ts +1 -1
  9. package/src/schemas/api-log.ts +7 -5
  10. package/src/schemas/audit.ts +5 -5
  11. package/src/schemas/claim.ts +4 -4
  12. package/src/schemas/coupon.ts +2 -2
  13. package/src/schemas/customer.ts +3 -3
  14. package/src/schemas/fulfillment.ts +9 -11
  15. package/src/schemas/order.ts +1 -1
  16. package/src/schemas/payment.ts +7 -5
  17. package/src/schemas/product.ts +32 -12
  18. package/src/schemas/promotion.ts +4 -4
  19. package/src/schemas/refund-policy.ts +12 -12
  20. package/src/schemas/saved-option-set.ts +1 -1
  21. package/src/schemas/scope.ts +3 -3
  22. package/src/schemas/shipping-policy.ts +18 -18
  23. package/src/schemas/store.ts +106 -11
  24. package/src/schemas/storefront-hosting.ts +35 -39
  25. package/src/schemas/subscription.ts +8 -8
  26. package/src/schemas/telemetry.ts +2 -2
  27. package/src/schemas/upload.ts +1 -1
  28. package/src/schemas/webhook-event.ts +1 -1
  29. package/src/session.ts +1 -1
package/dist/index.d.mts CHANGED
@@ -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";
169
168
  DENIED: "DENIED";
170
169
  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";
194
193
  DENIED: "DENIED";
195
194
  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
216
  SUCCEEDED: "SUCCEEDED";
218
217
  FAILED: "FAILED";
219
218
  PENDING: "PENDING";
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
228
  SUCCEEDED: "SUCCEEDED";
230
229
  FAILED: "FAILED";
231
230
  PENDING: "PENDING";
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
290
  SUCCEEDED: "SUCCEEDED";
292
291
  FAILED: "FAILED";
293
292
  PENDING: "PENDING";
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
309
  SUCCEEDED: "SUCCEEDED";
311
310
  FAILED: "FAILED";
312
311
  PENDING: "PENDING";
313
312
  EXECUTING: "EXECUTING";
313
+ UNKNOWN: "UNKNOWN";
314
314
  REJECTED: "REJECTED";
315
315
  EXPIRED: "EXPIRED";
316
316
  }>;
@@ -398,7 +398,7 @@ export declare const APPROVAL_ALREADY_DECIDED_CODE = "APPROVAL_ALREADY_DECIDED";
398
398
  * 성공 값으로 돌려주지 않는다 — 돌려주면 호출부가 승인 요청을 상품·주문으로 읽는다.
399
399
  *
400
400
  * - `code = APPROVAL_REQUIRED`(202): 에이전트의 고위험 쓰기가 보류됐다. 아직 아무것도 바뀌지 않았다.
401
- * 셀러가 콘솔(`approval.approvalUrl`)에서 승인하면 서버가 원 요청을 실행한다. 같은 요청을 다시 보내지 말고
401
+ * 셀러가 상점 플랫폼(`approval.approvalUrl`)에서 승인하면 서버가 원 요청을 실행한다. 같은 요청을 다시 보내지 말고
402
402
  * `approvalRequests.get(approvalId)`로 결과를 확인한다.
403
403
  * - `code = APPROVAL_ALREADY_DECIDED`(200): 같은 멱등키로 보낸 요청의 승인이 이미 끝났다. `status`가
404
404
  * `SUCCEEDED`·`FAILED`·`UNKNOWN`이면 실행 결과(`approval.result`)를 보고, `REJECTED`·`EXPIRED`면 새 멱등키로 다시 요청한다.
@@ -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";
585
+ UNKNOWN: "UNKNOWN";
584
586
  DIRECT: "DIRECT";
587
+ CAMPAIGN: "CAMPAIGN";
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";
619
+ UNKNOWN: "UNKNOWN";
618
620
  DIRECT: "DIRECT";
621
+ CAMPAIGN: "CAMPAIGN";
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";
655
+ UNKNOWN: "UNKNOWN";
654
656
  DIRECT: "DIRECT";
657
+ CAMPAIGN: "CAMPAIGN";
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;
@@ -841,8 +841,8 @@ export type AnalyticsCheckout = z.infer<typeof analyticsCheckoutSchema>;
841
841
  //#endregion
842
842
  //#region src/schemas/api-log.d.ts
843
843
  /**
844
- * API 로그 — `/v1/api-logs`. 스토어가 해석된 관리 API(`/v1/**`) 요청을 7일간 보관한다.
845
- * 인증에 실패해 스토어를 알 수 없는 요청(401 등)은 기록되지 않는다.
844
+ * API 로그 — `/v1/api-logs`. 상점이 해석된 관리 API(`/v1/**`) 요청을 7일간 보관한다.
845
+ * 인증에 실패해 상점을 알 수 없는 요청(401 등)은 기록되지 않는다.
846
846
  * Authorization·쿠키 헤더, 요청 본문, 개인정보는 저장하지 않는다.
847
847
  */
848
848
  export declare const apiLogPrincipalTypeSchema: z.ZodEnum<{
@@ -954,7 +954,7 @@ export declare const apiLogPageSchema: z.ZodObject<{
954
954
  export type ApiLogPage = z.infer<typeof apiLogPageSchema>;
955
955
  /**
956
956
  * API 로그 요약 — `GET /api-logs/summary`. 연동 트래픽(호출 주체 `PAT`·`CLIENT`)만 집계하며
957
- * 콘솔 사용자(`USER`) 요청은 제외한다
957
+ * 상점 플랫폼 사용자(`USER`) 요청은 제외한다
958
958
  */
959
959
  export declare const apiLogSummarySchema: z.ZodObject<{
960
960
  windowHours: z.ZodNumber;
@@ -966,11 +966,11 @@ export type ApiLogSummary = z.infer<typeof apiLogSummarySchema>;
966
966
  //#endregion
967
967
  //#region src/schemas/category.d.ts
968
968
  export declare const categoryProductSortSchema: z.ZodEnum<{
969
+ NAME: "NAME";
969
970
  RECENT: "RECENT";
970
971
  POPULAR: "POPULAR";
971
972
  PRICE_LOW: "PRICE_LOW";
972
973
  PRICE_HIGH: "PRICE_HIGH";
973
- NAME: "NAME";
974
974
  }>;
975
975
  export type CategoryProductSort = z.infer<typeof categoryProductSortSchema>;
976
976
  export declare const categorySchema: z.ZodObject<{
@@ -986,11 +986,11 @@ export declare const categorySchema: z.ZodObject<{
986
986
  showPc: z.ZodBoolean;
987
987
  showMobile: z.ZodBoolean;
988
988
  productSort: z.ZodEnum<{
989
+ NAME: "NAME";
989
990
  RECENT: "RECENT";
990
991
  POPULAR: "POPULAR";
991
992
  PRICE_LOW: "PRICE_LOW";
992
993
  PRICE_HIGH: "PRICE_HIGH";
993
- NAME: "NAME";
994
994
  }>;
995
995
  metaTitle: z.ZodNullable<z.ZodString>;
996
996
  metaDescription: z.ZodNullable<z.ZodString>;
@@ -1016,11 +1016,11 @@ export declare const categoryWithPathSchema: z.ZodObject<{
1016
1016
  showPc: z.ZodBoolean;
1017
1017
  showMobile: z.ZodBoolean;
1018
1018
  productSort: z.ZodEnum<{
1019
+ NAME: "NAME";
1019
1020
  RECENT: "RECENT";
1020
1021
  POPULAR: "POPULAR";
1021
1022
  PRICE_LOW: "PRICE_LOW";
1022
1023
  PRICE_HIGH: "PRICE_HIGH";
1023
- NAME: "NAME";
1024
1024
  }>;
1025
1025
  metaTitle: z.ZodNullable<z.ZodString>;
1026
1026
  metaDescription: z.ZodNullable<z.ZodString>;
@@ -1041,11 +1041,11 @@ export declare const categoryWithPathSchema: z.ZodObject<{
1041
1041
  showPc: z.ZodBoolean;
1042
1042
  showMobile: z.ZodBoolean;
1043
1043
  productSort: z.ZodEnum<{
1044
+ NAME: "NAME";
1044
1045
  RECENT: "RECENT";
1045
1046
  POPULAR: "POPULAR";
1046
1047
  PRICE_LOW: "PRICE_LOW";
1047
1048
  PRICE_HIGH: "PRICE_HIGH";
1048
- NAME: "NAME";
1049
1049
  }>;
1050
1050
  metaTitle: z.ZodNullable<z.ZodString>;
1051
1051
  metaDescription: z.ZodNullable<z.ZodString>;
@@ -1069,11 +1069,11 @@ export declare const categorySearchResultSchema: z.ZodObject<{
1069
1069
  showPc: z.ZodBoolean;
1070
1070
  showMobile: z.ZodBoolean;
1071
1071
  productSort: z.ZodEnum<{
1072
+ NAME: "NAME";
1072
1073
  RECENT: "RECENT";
1073
1074
  POPULAR: "POPULAR";
1074
1075
  PRICE_LOW: "PRICE_LOW";
1075
1076
  PRICE_HIGH: "PRICE_HIGH";
1076
- NAME: "NAME";
1077
1077
  }>;
1078
1078
  metaTitle: z.ZodNullable<z.ZodString>;
1079
1079
  metaDescription: z.ZodNullable<z.ZodString>;
@@ -1094,11 +1094,11 @@ export declare const categorySearchResultSchema: z.ZodObject<{
1094
1094
  showPc: z.ZodBoolean;
1095
1095
  showMobile: z.ZodBoolean;
1096
1096
  productSort: z.ZodEnum<{
1097
+ NAME: "NAME";
1097
1098
  RECENT: "RECENT";
1098
1099
  POPULAR: "POPULAR";
1099
1100
  PRICE_LOW: "PRICE_LOW";
1100
1101
  PRICE_HIGH: "PRICE_HIGH";
1101
- NAME: "NAME";
1102
1102
  }>;
1103
1103
  metaTitle: z.ZodNullable<z.ZodString>;
1104
1104
  metaDescription: z.ZodNullable<z.ZodString>;
@@ -1130,11 +1130,11 @@ export declare const categoryCreateRequestSchema: z.ZodObject<{
1130
1130
  showPc: z.ZodOptional<z.ZodBoolean>;
1131
1131
  showMobile: z.ZodOptional<z.ZodBoolean>;
1132
1132
  productSort: z.ZodOptional<z.ZodEnum<{
1133
+ NAME: "NAME";
1133
1134
  RECENT: "RECENT";
1134
1135
  POPULAR: "POPULAR";
1135
1136
  PRICE_LOW: "PRICE_LOW";
1136
1137
  PRICE_HIGH: "PRICE_HIGH";
1137
- NAME: "NAME";
1138
1138
  }>>;
1139
1139
  metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1140
1140
  metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1149,11 +1149,11 @@ export declare const categoryPatchRequestSchema: z.ZodObject<{
1149
1149
  showPc: z.ZodOptional<z.ZodBoolean>;
1150
1150
  showMobile: z.ZodOptional<z.ZodBoolean>;
1151
1151
  productSort: z.ZodOptional<z.ZodEnum<{
1152
+ NAME: "NAME";
1152
1153
  RECENT: "RECENT";
1153
1154
  POPULAR: "POPULAR";
1154
1155
  PRICE_LOW: "PRICE_LOW";
1155
1156
  PRICE_HIGH: "PRICE_HIGH";
1156
- NAME: "NAME";
1157
1157
  }>>;
1158
1158
  metaTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1159
1159
  metaDescription: z.ZodOptional<z.ZodNullable<z.ZodString>>;
@@ -1232,14 +1232,14 @@ export declare const bulkResultSchema: z.ZodObject<{
1232
1232
  }, z.core.$strip>;
1233
1233
  export type BulkResult = z.infer<typeof bulkResultSchema>;
1234
1234
  export declare const orderItemStatusSchema: z.ZodEnum<{
1235
- PAID: "PAID";
1236
- CANCELED: "CANCELED";
1237
1235
  PAYMENT_WAITING: "PAYMENT_WAITING";
1236
+ PAID: "PAID";
1238
1237
  CONFIRMED: "CONFIRMED";
1239
1238
  DISPATCHED: "DISPATCHED";
1240
1239
  DELIVERING: "DELIVERING";
1241
1240
  DELIVERED: "DELIVERED";
1242
1241
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
1242
+ CANCELED: "CANCELED";
1243
1243
  }>;
1244
1244
  export type OrderItemStatus = z.infer<typeof orderItemStatusSchema>;
1245
1245
  export declare const changeTypeSchema: z.ZodEnum<{
@@ -1258,13 +1258,13 @@ export type ChangeType = z.infer<typeof changeTypeSchema>;
1258
1258
  //#endregion
1259
1259
  //#region src/schemas/claim.d.ts
1260
1260
  export declare const claimTypeSchema: z.ZodEnum<{
1261
- CANCEL: "CANCEL";
1262
1261
  RETURN: "RETURN";
1263
1262
  EXCHANGE: "EXCHANGE";
1263
+ CANCEL: "CANCEL";
1264
1264
  }>;
1265
1265
  export type ClaimType = z.infer<typeof claimTypeSchema>;
1266
1266
  export declare const claimStatusSchema: z.ZodEnum<{
1267
- COMPLETED: "COMPLETED";
1267
+ WITHDRAWN: "WITHDRAWN";
1268
1268
  REJECTED: "REJECTED";
1269
1269
  REQUESTED: "REQUESTED";
1270
1270
  HELD: "HELD";
@@ -1272,7 +1272,7 @@ export declare const claimStatusSchema: z.ZodEnum<{
1272
1272
  COLLECTED: "COLLECTED";
1273
1273
  REDELIVERING: "REDELIVERING";
1274
1274
  APPROVED: "APPROVED";
1275
- WITHDRAWN: "WITHDRAWN";
1275
+ COMPLETED: "COMPLETED";
1276
1276
  }>;
1277
1277
  export type ClaimStatus = z.infer<typeof claimStatusSchema>;
1278
1278
  export declare const claimReasonSchema: z.ZodEnum<{
@@ -1285,10 +1285,10 @@ export declare const claimReasonSchema: z.ZodEnum<{
1285
1285
  }>;
1286
1286
  export type ClaimReason = z.infer<typeof claimReasonSchema>;
1287
1287
  /**
1288
- * 반품지 (이슈 #30) — 반품·교환 수거가 안내하는 주소다. 스토어 주소록의 기본 반품지이거나,
1288
+ * 반품지 (이슈 #30) — 반품·교환 수거가 안내하는 주소다. 상점 주소록의 기본 반품지이거나,
1289
1289
  * 상품이 반품지를 따로 지정했으면 그 주소다.
1290
1290
  *
1291
- * 취소 클레임은 보낼 물건이 없어 null이고, 반품지를 등록하지 않은 스토어도 null이다.
1291
+ * 취소 클레임은 보낼 물건이 없어 null이고, 반품지를 등록하지 않은 상점도 null이다.
1292
1292
  * 구매자가 직접 보내는 수거(`BUYER_SEND`)에 이 주소가 필요하다.
1293
1293
  */
1294
1294
  export declare const claimReturnAddressSchema: z.ZodObject<{
@@ -1303,12 +1303,12 @@ export type ClaimReturnAddress = z.infer<typeof claimReturnAddressSchema>;
1303
1303
  export declare const claimSchema: z.ZodObject<{
1304
1304
  claimId: z.ZodString;
1305
1305
  type: z.ZodEnum<{
1306
- CANCEL: "CANCEL";
1307
1306
  RETURN: "RETURN";
1308
1307
  EXCHANGE: "EXCHANGE";
1308
+ CANCEL: "CANCEL";
1309
1309
  }>;
1310
1310
  status: z.ZodEnum<{
1311
- COMPLETED: "COMPLETED";
1311
+ WITHDRAWN: "WITHDRAWN";
1312
1312
  REJECTED: "REJECTED";
1313
1313
  REQUESTED: "REQUESTED";
1314
1314
  HELD: "HELD";
@@ -1316,7 +1316,7 @@ export declare const claimSchema: z.ZodObject<{
1316
1316
  COLLECTED: "COLLECTED";
1317
1317
  REDELIVERING: "REDELIVERING";
1318
1318
  APPROVED: "APPROVED";
1319
- WITHDRAWN: "WITHDRAWN";
1319
+ COMPLETED: "COMPLETED";
1320
1320
  }>;
1321
1321
  orderId: z.ZodString;
1322
1322
  orderItemId: z.ZodString;
@@ -1332,8 +1332,8 @@ export declare const claimSchema: z.ZodObject<{
1332
1332
  }>;
1333
1333
  reasonDetail: z.ZodNullable<z.ZodString>;
1334
1334
  responsibility: z.ZodEnum<{
1335
- BUYER: "BUYER";
1336
1335
  SELLER: "SELLER";
1336
+ BUYER: "BUYER";
1337
1337
  }>;
1338
1338
  claimDeliveryFee: z.ZodNumber;
1339
1339
  expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
@@ -1378,9 +1378,9 @@ export declare const claimListQuerySchema: z.ZodObject<{
1378
1378
  page: z.ZodOptional<z.ZodString>;
1379
1379
  size: z.ZodOptional<z.ZodString>;
1380
1380
  type: z.ZodOptional<z.ZodEnum<{
1381
- CANCEL: "CANCEL";
1382
1381
  RETURN: "RETURN";
1383
1382
  EXCHANGE: "EXCHANGE";
1383
+ CANCEL: "CANCEL";
1384
1384
  }>>;
1385
1385
  status: z.ZodOptional<z.ZodString>;
1386
1386
  orderItemId: z.ZodOptional<z.ZodString>;
@@ -1391,12 +1391,12 @@ export declare const claimListQuerySchema: z.ZodObject<{
1391
1391
  export declare const claimDetailSchema: z.ZodObject<{
1392
1392
  claimId: z.ZodString;
1393
1393
  type: z.ZodEnum<{
1394
- CANCEL: "CANCEL";
1395
1394
  RETURN: "RETURN";
1396
1395
  EXCHANGE: "EXCHANGE";
1396
+ CANCEL: "CANCEL";
1397
1397
  }>;
1398
1398
  status: z.ZodEnum<{
1399
- COMPLETED: "COMPLETED";
1399
+ WITHDRAWN: "WITHDRAWN";
1400
1400
  REJECTED: "REJECTED";
1401
1401
  REQUESTED: "REQUESTED";
1402
1402
  HELD: "HELD";
@@ -1404,7 +1404,7 @@ export declare const claimDetailSchema: z.ZodObject<{
1404
1404
  COLLECTED: "COLLECTED";
1405
1405
  REDELIVERING: "REDELIVERING";
1406
1406
  APPROVED: "APPROVED";
1407
- WITHDRAWN: "WITHDRAWN";
1407
+ COMPLETED: "COMPLETED";
1408
1408
  }>;
1409
1409
  orderId: z.ZodString;
1410
1410
  orderItemId: z.ZodString;
@@ -1420,8 +1420,8 @@ export declare const claimDetailSchema: z.ZodObject<{
1420
1420
  }>;
1421
1421
  reasonDetail: z.ZodNullable<z.ZodString>;
1422
1422
  responsibility: z.ZodEnum<{
1423
- BUYER: "BUYER";
1424
1423
  SELLER: "SELLER";
1424
+ BUYER: "BUYER";
1425
1425
  }>;
1426
1426
  claimDeliveryFee: z.ZodNumber;
1427
1427
  expectedRefundAmount: z.ZodNullable<z.ZodNumber>;
@@ -1453,7 +1453,7 @@ export declare const claimDetailSchema: z.ZodObject<{
1453
1453
  }, z.core.$strip>>;
1454
1454
  histories: z.ZodOptional<z.ZodArray<z.ZodObject<{
1455
1455
  status: z.ZodEnum<{
1456
- COMPLETED: "COMPLETED";
1456
+ WITHDRAWN: "WITHDRAWN";
1457
1457
  REJECTED: "REJECTED";
1458
1458
  REQUESTED: "REQUESTED";
1459
1459
  HELD: "HELD";
@@ -1461,12 +1461,12 @@ export declare const claimDetailSchema: z.ZodObject<{
1461
1461
  COLLECTED: "COLLECTED";
1462
1462
  REDELIVERING: "REDELIVERING";
1463
1463
  APPROVED: "APPROVED";
1464
- WITHDRAWN: "WITHDRAWN";
1464
+ COMPLETED: "COMPLETED";
1465
1465
  }>;
1466
1466
  actor: z.ZodEnum<{
1467
+ SELLER: "SELLER";
1467
1468
  SYSTEM: "SYSTEM";
1468
1469
  BUYER: "BUYER";
1469
- SELLER: "SELLER";
1470
1470
  }>;
1471
1471
  occurredAt: z.ZodString;
1472
1472
  }, z.core.$strip>>>;
@@ -1480,11 +1480,11 @@ export declare const claimHoldResultSchema: z.ZodObject<{
1480
1480
  export type ClaimHoldResult = z.infer<typeof claimHoldResultSchema>;
1481
1481
  export declare const rejectClaimRequestSchema: z.ZodObject<{
1482
1482
  reason: z.ZodEnum<{
1483
+ ETC: "ETC";
1483
1484
  USED_PRODUCT: "USED_PRODUCT";
1484
1485
  MISSING_COMPONENT: "MISSING_COMPONENT";
1485
1486
  PERIOD_EXPIRED: "PERIOD_EXPIRED";
1486
1487
  BUYER_FAULT_DAMAGE: "BUYER_FAULT_DAMAGE";
1487
- ETC: "ETC";
1488
1488
  }>;
1489
1489
  detail: z.ZodString;
1490
1490
  evidenceImages: z.ZodOptional<z.ZodArray<z.ZodURL>>;
@@ -1520,8 +1520,8 @@ export declare const couponStatusSchema: z.ZodEnum<{
1520
1520
  export type CouponStatus = z.infer<typeof couponStatusSchema>;
1521
1521
  /** 지금 만들 수 있는 발급 방식 — 다운로드·가입 자동 지급은 뒤 단계다 */
1522
1522
  export declare const couponIssueMethodSchema: z.ZodEnum<{
1523
- CODE: "CODE";
1524
1523
  MANUAL: "MANUAL";
1524
+ CODE: "CODE";
1525
1525
  }>;
1526
1526
  export type CouponIssueMethod = z.infer<typeof couponIssueMethodSchema>;
1527
1527
  /** 코드 형식 — 영문·숫자·`-`·`_` 6~30자. 대소문자를 구분하지 않고 서버가 대문자로 저장한다 */
@@ -1572,8 +1572,8 @@ export declare const createCouponRequestSchema: z.ZodObject<{
1572
1572
  excludeCategoryIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
1573
1573
  }, z.core.$strict>>;
1574
1574
  issueMethod: z.ZodEnum<{
1575
- CODE: "CODE";
1576
1575
  MANUAL: "MANUAL";
1576
+ CODE: "CODE";
1577
1577
  }>;
1578
1578
  code: z.ZodOptional<z.ZodString>;
1579
1579
  startsAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
@@ -1690,8 +1690,8 @@ export declare const couponListQuerySchema: z.ZodObject<{
1690
1690
  DELIVERY: "DELIVERY";
1691
1691
  }>>;
1692
1692
  issueMethod: z.ZodOptional<z.ZodEnum<{
1693
- CODE: "CODE";
1694
1693
  MANUAL: "MANUAL";
1694
+ CODE: "CODE";
1695
1695
  }>>;
1696
1696
  q: z.ZodOptional<z.ZodString>;
1697
1697
  }, z.core.$strip>;
@@ -1870,8 +1870,8 @@ export declare const consentKindSchema: z.ZodEnum<{
1870
1870
  }>;
1871
1871
  export type ConsentKind = z.infer<typeof consentKindSchema>;
1872
1872
  export declare const consentActionSchema: z.ZodEnum<{
1873
- WITHDRAWN: "WITHDRAWN";
1874
1873
  AGREED: "AGREED";
1874
+ WITHDRAWN: "WITHDRAWN";
1875
1875
  }>;
1876
1876
  export type ConsentAction = z.infer<typeof consentActionSchema>;
1877
1877
  /**
@@ -1880,12 +1880,12 @@ export type ConsentAction = z.infer<typeof consentActionSchema>;
1880
1880
  * `RECONSENT` 약관 개정 재동의 · `MEMBER_UPDATE` 구매자가 직접 변경 · `SELLER` 셀러가 처리
1881
1881
  */
1882
1882
  export declare const consentSourceSchema: z.ZodEnum<{
1883
- SELLER: "SELLER";
1884
1883
  SIGNUP: "SIGNUP";
1885
1884
  SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
1886
1885
  DELEGATED: "DELEGATED";
1887
1886
  RECONSENT: "RECONSENT";
1888
1887
  MEMBER_UPDATE: "MEMBER_UPDATE";
1888
+ SELLER: "SELLER";
1889
1889
  }>;
1890
1890
  export type ConsentSource = z.infer<typeof consentSourceSchema>;
1891
1891
  /** 동의 이력 한 줄 — 추가만 되고 지워지지 않는다(구매자 탈퇴 시에만 함께 지워진다) */
@@ -1899,16 +1899,16 @@ export declare const customerConsentSchema: z.ZodObject<{
1899
1899
  version: z.ZodNullable<z.ZodString>;
1900
1900
  documentUrl: z.ZodNullable<z.ZodString>;
1901
1901
  action: z.ZodEnum<{
1902
- WITHDRAWN: "WITHDRAWN";
1903
1902
  AGREED: "AGREED";
1903
+ WITHDRAWN: "WITHDRAWN";
1904
1904
  }>;
1905
1905
  source: z.ZodEnum<{
1906
- SELLER: "SELLER";
1907
1906
  SIGNUP: "SIGNUP";
1908
1907
  SOCIAL_SIGNUP: "SOCIAL_SIGNUP";
1909
1908
  DELEGATED: "DELEGATED";
1910
1909
  RECONSENT: "RECONSENT";
1911
1910
  MEMBER_UPDATE: "MEMBER_UPDATE";
1911
+ SELLER: "SELLER";
1912
1912
  }>;
1913
1913
  occurredAt: z.ZodString;
1914
1914
  }, z.core.$strip>;
@@ -1992,10 +1992,10 @@ export declare const customerDetailSchema: z.ZodObject<{
1992
1992
  marketingAgreed: z.ZodBoolean;
1993
1993
  loginMethods: z.ZodArray<z.ZodObject<{
1994
1994
  method: z.ZodEnum<{
1995
+ password: "password";
1995
1996
  kakao: "kakao";
1996
1997
  naver: "naver";
1997
1998
  google: "google";
1998
- password: "password";
1999
1999
  }>;
2000
2000
  linkedAt: z.ZodString;
2001
2001
  }, z.core.$strip>>;
@@ -2073,14 +2073,14 @@ export declare const customerOrderSchema: z.ZodObject<{
2073
2073
  optionName: z.ZodNullable<z.ZodString>;
2074
2074
  quantity: z.ZodNumber;
2075
2075
  status: z.ZodEnum<{
2076
- PAID: "PAID";
2077
- CANCELED: "CANCELED";
2078
2076
  PAYMENT_WAITING: "PAYMENT_WAITING";
2077
+ PAID: "PAID";
2079
2078
  CONFIRMED: "CONFIRMED";
2080
2079
  DISPATCHED: "DISPATCHED";
2081
2080
  DELIVERING: "DELIVERING";
2082
2081
  DELIVERED: "DELIVERED";
2083
2082
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
2083
+ CANCELED: "CANCELED";
2084
2084
  }>;
2085
2085
  claimStatus: z.ZodNullable<z.ZodEnum<{
2086
2086
  CANCEL_REQUESTED: "CANCEL_REQUESTED";
@@ -2093,10 +2093,10 @@ export type CustomerOrder = z.infer<typeof customerOrderSchema>;
2093
2093
  /** `POST /v1/customers/{id}/withdraw` 본문 */
2094
2094
  export declare const withdrawCustomerRequestSchema: z.ZodObject<{
2095
2095
  reason: z.ZodEnum<{
2096
- OTHER: "OTHER";
2097
2096
  BUYER_REQUEST: "BUYER_REQUEST";
2098
2097
  DORMANT: "DORMANT";
2099
2098
  ABUSE: "ABUSE";
2099
+ OTHER: "OTHER";
2100
2100
  }>;
2101
2101
  memo: z.ZodOptional<z.ZodString>;
2102
2102
  }, z.core.$strip>;
@@ -2191,11 +2191,11 @@ export declare const inquirySchema: z.ZodObject<{
2191
2191
  productName: z.ZodString;
2192
2192
  orderItemId: z.ZodNullable<z.ZodString>;
2193
2193
  category: z.ZodEnum<{
2194
+ ETC: "ETC";
2194
2195
  PRODUCT: "PRODUCT";
2195
2196
  DELIVERY: "DELIVERY";
2196
2197
  RETURN: "RETURN";
2197
2198
  EXCHANGE: "EXCHANGE";
2198
- ETC: "ETC";
2199
2199
  }>;
2200
2200
  content: z.ZodString;
2201
2201
  secret: z.ZodBoolean;
@@ -2210,10 +2210,10 @@ export declare const inquirySchema: z.ZodObject<{
2210
2210
  }, z.core.$strip>;
2211
2211
  export type Inquiry = z.infer<typeof inquirySchema>;
2212
2212
  export declare const customerInquiryCategorySchema: z.ZodEnum<{
2213
+ ETC: "ETC";
2213
2214
  DELIVERY: "DELIVERY";
2214
2215
  RETURN: "RETURN";
2215
2216
  EXCHANGE: "EXCHANGE";
2216
- ETC: "ETC";
2217
2217
  PAYMENT: "PAYMENT";
2218
2218
  }>;
2219
2219
  export type CustomerInquiryCategory = z.infer<typeof customerInquiryCategorySchema>;
@@ -2222,10 +2222,10 @@ export declare const sellerCustomerInquirySchema: z.ZodObject<{
2222
2222
  inquiryId: z.ZodString;
2223
2223
  memberMaskedName: z.ZodString;
2224
2224
  category: z.ZodEnum<{
2225
+ ETC: "ETC";
2225
2226
  DELIVERY: "DELIVERY";
2226
2227
  RETURN: "RETURN";
2227
2228
  EXCHANGE: "EXCHANGE";
2228
- ETC: "ETC";
2229
2229
  PAYMENT: "PAYMENT";
2230
2230
  }>;
2231
2231
  title: z.ZodString;
@@ -2260,10 +2260,10 @@ export declare const customerInquiryListQuerySchema: z.ZodObject<{
2260
2260
  false: "false";
2261
2261
  }>>;
2262
2262
  category: z.ZodOptional<z.ZodEnum<{
2263
+ ETC: "ETC";
2263
2264
  DELIVERY: "DELIVERY";
2264
2265
  RETURN: "RETURN";
2265
2266
  EXCHANGE: "EXCHANGE";
2266
- ETC: "ETC";
2267
2267
  PAYMENT: "PAYMENT";
2268
2268
  }>>;
2269
2269
  from: z.ZodOptional<z.ZodString>;
@@ -2790,8 +2790,8 @@ export type ReviewReportResult = z.infer<typeof reviewReportResultSchema>;
2790
2790
  * 이름은 이행 방식이다 — `SHIPPING`이 택배 발송이듯 `MANUAL`은 셀러가 직접 제공한다는 뜻이다.
2791
2791
  */
2792
2792
  export declare const fulfillmentTypeSchema: z.ZodEnum<{
2793
- MANUAL: "MANUAL";
2794
2793
  SHIPPING: "SHIPPING";
2794
+ MANUAL: "MANUAL";
2795
2795
  }>;
2796
2796
  export type FulfillmentType = z.infer<typeof fulfillmentTypeSchema>;
2797
2797
  /**
@@ -2836,7 +2836,7 @@ export declare const deliveryTypeSchema: z.ZodEnum<{
2836
2836
  }>;
2837
2837
  export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
2838
2838
  /**
2839
- * 상품 이행 — 등록(POST). 배송 상품의 `shipping`을 생략하면 기본값(유료 배송·스토어 기본 배송비·기본 출고지·반품지)이다.
2839
+ * 상품 이행 — 등록(POST). 배송 상품의 `shipping`을 생략하면 기본값(유료 배송·상점 기본 배송비·기본 출고지·반품지)이다.
2840
2840
  */
2841
2841
  export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2842
2842
  type: z.ZodLiteral<"SHIPPING">;
@@ -2980,14 +2980,14 @@ export declare const orderSummarySchema: z.ZodObject<{
2980
2980
  itemCount: z.ZodNumber;
2981
2981
  totalAmount: z.ZodNumber;
2982
2982
  representativeStatus: z.ZodEnum<{
2983
- PAID: "PAID";
2984
- CANCELED: "CANCELED";
2985
2983
  PAYMENT_WAITING: "PAYMENT_WAITING";
2984
+ PAID: "PAID";
2986
2985
  CONFIRMED: "CONFIRMED";
2987
2986
  DISPATCHED: "DISPATCHED";
2988
2987
  DELIVERING: "DELIVERING";
2989
2988
  DELIVERED: "DELIVERED";
2990
2989
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
2990
+ CANCELED: "CANCELED";
2991
2991
  }>;
2992
2992
  orderedAt: z.ZodString;
2993
2993
  testPayment: z.ZodBoolean;
@@ -3015,14 +3015,14 @@ export declare const orderItemSchema: z.ZodObject<{
3015
3015
  orderItemId: z.ZodString;
3016
3016
  orderId: z.ZodString;
3017
3017
  status: z.ZodEnum<{
3018
- PAID: "PAID";
3019
- CANCELED: "CANCELED";
3020
3018
  PAYMENT_WAITING: "PAYMENT_WAITING";
3019
+ PAID: "PAID";
3021
3020
  CONFIRMED: "CONFIRMED";
3022
3021
  DISPATCHED: "DISPATCHED";
3023
3022
  DELIVERING: "DELIVERING";
3024
3023
  DELIVERED: "DELIVERED";
3025
3024
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
3025
+ CANCELED: "CANCELED";
3026
3026
  }>;
3027
3027
  claimStatus: z.ZodNullable<z.ZodEnum<{
3028
3028
  CANCEL_REQUESTED: "CANCEL_REQUESTED";
@@ -3174,14 +3174,14 @@ export declare const orderSchema: z.ZodObject<{
3174
3174
  orderItemId: z.ZodString;
3175
3175
  orderId: z.ZodString;
3176
3176
  status: z.ZodEnum<{
3177
- PAID: "PAID";
3178
- CANCELED: "CANCELED";
3179
3177
  PAYMENT_WAITING: "PAYMENT_WAITING";
3178
+ PAID: "PAID";
3180
3179
  CONFIRMED: "CONFIRMED";
3181
3180
  DISPATCHED: "DISPATCHED";
3182
3181
  DELIVERING: "DELIVERING";
3183
3182
  DELIVERED: "DELIVERED";
3184
3183
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
3184
+ CANCELED: "CANCELED";
3185
3185
  }>;
3186
3186
  claimStatus: z.ZodNullable<z.ZodEnum<{
3187
3187
  CANCEL_REQUESTED: "CANCEL_REQUESTED";
@@ -3266,14 +3266,14 @@ export declare const orderSummaryPageSchema: z.ZodObject<{
3266
3266
  itemCount: z.ZodNumber;
3267
3267
  totalAmount: z.ZodNumber;
3268
3268
  representativeStatus: z.ZodEnum<{
3269
- PAID: "PAID";
3270
- CANCELED: "CANCELED";
3271
3269
  PAYMENT_WAITING: "PAYMENT_WAITING";
3270
+ PAID: "PAID";
3272
3271
  CONFIRMED: "CONFIRMED";
3273
3272
  DISPATCHED: "DISPATCHED";
3274
3273
  DELIVERING: "DELIVERING";
3275
3274
  DELIVERED: "DELIVERED";
3276
3275
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
3276
+ CANCELED: "CANCELED";
3277
3277
  }>;
3278
3278
  orderedAt: z.ZodString;
3279
3279
  testPayment: z.ZodBoolean;
@@ -3290,14 +3290,14 @@ export declare const orderItemPageSchema: z.ZodObject<{
3290
3290
  orderItemId: z.ZodString;
3291
3291
  orderId: z.ZodString;
3292
3292
  status: z.ZodEnum<{
3293
- PAID: "PAID";
3294
- CANCELED: "CANCELED";
3295
3293
  PAYMENT_WAITING: "PAYMENT_WAITING";
3294
+ PAID: "PAID";
3296
3295
  CONFIRMED: "CONFIRMED";
3297
3296
  DISPATCHED: "DISPATCHED";
3298
3297
  DELIVERING: "DELIVERING";
3299
3298
  DELIVERED: "DELIVERED";
3300
3299
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
3300
+ CANCELED: "CANCELED";
3301
3301
  }>;
3302
3302
  claimStatus: z.ZodNullable<z.ZodEnum<{
3303
3303
  CANCEL_REQUESTED: "CANCEL_REQUESTED";
@@ -3381,14 +3381,14 @@ export declare const orderListQuerySchema: z.ZodObject<{
3381
3381
  orderedFrom: z.ZodString;
3382
3382
  orderedTo: z.ZodOptional<z.ZodString>;
3383
3383
  status: z.ZodOptional<z.ZodEnum<{
3384
- PAID: "PAID";
3385
- CANCELED: "CANCELED";
3386
3384
  PAYMENT_WAITING: "PAYMENT_WAITING";
3385
+ PAID: "PAID";
3387
3386
  CONFIRMED: "CONFIRMED";
3388
3387
  DISPATCHED: "DISPATCHED";
3389
3388
  DELIVERING: "DELIVERING";
3390
3389
  DELIVERED: "DELIVERED";
3391
3390
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
3391
+ CANCELED: "CANCELED";
3392
3392
  }>>;
3393
3393
  keyword: z.ZodOptional<z.ZodString>;
3394
3394
  fulfillmentType: z.ZodOptional<z.ZodString>;
@@ -3441,16 +3441,16 @@ export interface OrderItemListParams extends PageParams {
3441
3441
  testPayment?: "true" | "false";
3442
3442
  }
3443
3443
  export declare const deliveryMethodSchema: z.ZodEnum<{
3444
- DIRECT: "DIRECT";
3445
3444
  COURIER: "COURIER";
3445
+ DIRECT: "DIRECT";
3446
3446
  QUICK: "QUICK";
3447
3447
  NOTHING: "NOTHING";
3448
3448
  }>;
3449
3449
  export type DeliveryMethod = z.infer<typeof deliveryMethodSchema>;
3450
3450
  export declare const dispatchRequestSchema: z.ZodObject<{
3451
3451
  deliveryMethod: z.ZodEnum<{
3452
- DIRECT: "DIRECT";
3453
3452
  COURIER: "COURIER";
3453
+ DIRECT: "DIRECT";
3454
3454
  QUICK: "QUICK";
3455
3455
  NOTHING: "NOTHING";
3456
3456
  }>;
@@ -3462,8 +3462,8 @@ export type DispatchRequest = z.infer<typeof dispatchRequestSchema>;
3462
3462
  export declare const deliveryInfoSchema: z.ZodObject<{
3463
3463
  orderItemId: z.ZodString;
3464
3464
  deliveryMethod: z.ZodEnum<{
3465
- DIRECT: "DIRECT";
3466
3465
  COURIER: "COURIER";
3466
+ DIRECT: "DIRECT";
3467
3467
  QUICK: "QUICK";
3468
3468
  NOTHING: "NOTHING";
3469
3469
  }>;
@@ -3489,8 +3489,8 @@ export declare const trackingStageResponseSchema: z.ZodString;
3489
3489
  export declare const deliveryStatusSchema: z.ZodObject<{
3490
3490
  orderItemId: z.ZodString;
3491
3491
  deliveryMethod: z.ZodEnum<{
3492
- DIRECT: "DIRECT";
3493
3492
  COURIER: "COURIER";
3493
+ DIRECT: "DIRECT";
3494
3494
  QUICK: "QUICK";
3495
3495
  NOTHING: "NOTHING";
3496
3496
  }>;
@@ -3534,10 +3534,10 @@ export declare const carrierSchema: z.ZodObject<{
3534
3534
  export type Carrier = z.infer<typeof carrierSchema>;
3535
3535
  export declare const holdOrderItemRequestSchema: z.ZodObject<{
3536
3536
  reason: z.ZodEnum<{
3537
- ETC: "ETC";
3538
3537
  OUT_OF_STOCK: "OUT_OF_STOCK";
3539
3538
  CUSTOMER_REQUEST: "CUSTOMER_REQUEST";
3540
3539
  CUSTOMS: "CUSTOMS";
3540
+ ETC: "ETC";
3541
3541
  }>;
3542
3542
  detail: z.ZodOptional<z.ZodString>;
3543
3543
  expectedDispatchDate: z.ZodString;
@@ -3545,8 +3545,8 @@ export declare const holdOrderItemRequestSchema: z.ZodObject<{
3545
3545
  export type HoldOrderItemRequest = z.infer<typeof holdOrderItemRequestSchema>;
3546
3546
  export declare const cancelBySellerRequestSchema: z.ZodObject<{
3547
3547
  reason: z.ZodEnum<{
3548
- ETC: "ETC";
3549
3548
  OUT_OF_STOCK: "OUT_OF_STOCK";
3549
+ ETC: "ETC";
3550
3550
  PRICE_ERROR: "PRICE_ERROR";
3551
3551
  DELIVERY_IMPOSSIBLE: "DELIVERY_IMPOSSIBLE";
3552
3552
  }>;
@@ -3608,9 +3608,9 @@ export declare const addressChangeRequestListSchema: z.ZodArray<z.ZodRecord<z.Zo
3608
3608
  //#endregion
3609
3609
  //#region src/schemas/payment.d.ts
3610
3610
  /**
3611
- * 스토어 결제(PG) 설정과 매출 리포트 계약.
3611
+ * 상점 결제(PG) 설정과 매출 리포트 계약.
3612
3612
  *
3613
- * PG는 셀러가 직접 계약한다. 자격 증명은 스토어별로 저장되고, 비밀 값(시크릿 키·API Secret·
3613
+ * PG는 셀러가 직접 계약한다. 자격 증명은 상점별로 저장되고, 비밀 값(시크릿 키·API Secret·
3614
3614
  * 웹훅 시크릿)은 저장 후 다시 조회할 수 없다. 응답에는 앞 4자리 마스킹만 나온다. 공개 값
3615
3615
  * (클라이언트 키·Store ID·채널 키)은 원래 브라우저 결제창에 노출되는 값이라 그대로 돌려준다.
3616
3616
  */
@@ -3657,7 +3657,7 @@ export type PgVerificationResult = z.infer<typeof pgVerificationResultSchema>;
3657
3657
  /**
3658
3658
  * 토스페이먼츠 결제위젯 키 접두사. 결제창은 API 개별 연동(`*_ck_`·`*_sk_`)만 쓴다. 위젯 키는 결제창 SDK가
3659
3659
  * `NOT_SUPPORTED_WIDGET_KEY`로, 서버 API가 404 `NOT_FOUND_MERCHANT`로 거부하므로 저장 전에 막는다.
3660
- * 요청 스키마·api 어댑터·콘솔 폼이 같은 상수를 쓴다(원천). `g` 플래그가 없어 `.test()`가 상태를 갖지 않는다.
3660
+ * 요청 스키마·api 어댑터·상점 플랫폼 폼이 같은 상수를 쓴다(원천). `g` 플래그가 없어 `.test()`가 상태를 갖지 않는다.
3661
3661
  */
3662
3662
  export declare const TOSS_WIDGET_CLIENT_KEY_PATTERN: RegExp;
3663
3663
  /** 토스페이먼츠 결제위젯 시크릿 키 접두사. {@link TOSS_WIDGET_CLIENT_KEY_PATTERN} 참고 */
@@ -4692,15 +4692,15 @@ export declare const MAX_ADDON_GROUPS = 5;
4692
4692
  export declare const MAX_CUSTOM_INPUTS = 5;
4693
4693
  /** 직접 입력 항목 최대 글자 수의 상한 */
4694
4694
  export declare const MAX_CUSTOM_INPUT_LENGTH = 200;
4695
- /** 조합 수가 이 값 이상이면 콘솔이 경고한다(상한은 `MAX_VARIANTS`) */
4695
+ /** 조합 수가 이 값 이상이면 상점 플랫폼이 경고한다(상한은 `MAX_VARIANTS`) */
4696
4696
  export declare const VARIANT_COUNT_WARNING = 100;
4697
4697
  /**
4698
4698
  * 옵션 값 정렬 순서 — 등록순·가나다순·낮은 추가금순·높은 추가금순. 서버가 저장할 때 이 순서로 값의 `sortOrder`를 매긴다.
4699
4699
  * 추가금순은 추가 선택 값이면 값의 추가금, 조합 값이면 그 값이 든 조합 추가금의 최솟값으로 비교하고 같으면 등록순이다.
4700
4700
  */
4701
4701
  export declare const optionSortSchema: z.ZodEnum<{
4702
- NAME: "NAME";
4703
4702
  REGISTERED: "REGISTERED";
4703
+ NAME: "NAME";
4704
4704
  PRICE_ASC: "PRICE_ASC";
4705
4705
  PRICE_DESC: "PRICE_DESC";
4706
4706
  }>;
@@ -4741,7 +4741,7 @@ export declare const customInputSchema: z.ZodObject<{
4741
4741
  }, z.core.$strip>;
4742
4742
  export type CustomInput = z.infer<typeof customInputSchema>;
4743
4743
  /**
4744
- * 직접 입력 항목명에 쓸 수 없는 개인정보성 단어 — 콘솔 검사와 서버 400(`CUSTOM_INPUT_LABEL_FORBIDDEN`)이 이 목록 하나를 쓴다.
4744
+ * 직접 입력 항목명에 쓸 수 없는 개인정보성 단어 — 상점 플랫폼 검사와 서버 400(`CUSTOM_INPUT_LABEL_FORBIDDEN`)이 이 목록 하나를 쓴다.
4745
4745
  * 구매자 개인정보는 주문 정보로 받는다. 직접 입력 항목으로 받으면 보관·파기 규칙 밖에 남는다.
4746
4746
  */
4747
4747
  export declare const CUSTOM_INPUT_FORBIDDEN_WORDS: readonly ["연락처", "전화", "휴대폰", "핸드폰", "폰번호", "메일", "주소", "주민", "생년월일", "생일", "실명", "계좌", "카드번호", "비밀번호", "여권", "통관", "phone", "mobile", "mail", "address"];
@@ -4879,8 +4879,8 @@ export declare const productSchema: z.ZodObject<{
4879
4879
  sortOrder: z.ZodNumber;
4880
4880
  }, z.core.$strip>>>>;
4881
4881
  optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
4882
- NAME: "NAME";
4883
4882
  REGISTERED: "REGISTERED";
4883
+ NAME: "NAME";
4884
4884
  PRICE_ASC: "PRICE_ASC";
4885
4885
  PRICE_DESC: "PRICE_DESC";
4886
4886
  }>>>;
@@ -5023,8 +5023,8 @@ export declare const optionModelRequestSchema: z.ZodObject<{
5023
5023
  usable: z.ZodDefault<z.ZodBoolean>;
5024
5024
  }, z.core.$strip>>>;
5025
5025
  optionSort: z.ZodOptional<z.ZodEnum<{
5026
- NAME: "NAME";
5027
5026
  REGISTERED: "REGISTERED";
5027
+ NAME: "NAME";
5028
5028
  PRICE_ASC: "PRICE_ASC";
5029
5029
  PRICE_DESC: "PRICE_DESC";
5030
5030
  }>>;
@@ -5079,8 +5079,8 @@ export declare const optionModelSchema: z.ZodObject<{
5079
5079
  sortOrder: z.ZodNumber;
5080
5080
  }, z.core.$strip>>>>;
5081
5081
  optionSort: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
5082
- NAME: "NAME";
5083
5082
  REGISTERED: "REGISTERED";
5083
+ NAME: "NAME";
5084
5084
  PRICE_ASC: "PRICE_ASC";
5085
5085
  PRICE_DESC: "PRICE_DESC";
5086
5086
  }>>>;
@@ -5164,8 +5164,8 @@ export declare const productCreateRequestSchema: z.ZodObject<{
5164
5164
  usable: z.ZodDefault<z.ZodBoolean>;
5165
5165
  }, z.core.$strip>>>;
5166
5166
  optionSort: z.ZodOptional<z.ZodEnum<{
5167
- NAME: "NAME";
5168
5167
  REGISTERED: "REGISTERED";
5168
+ NAME: "NAME";
5169
5169
  PRICE_ASC: "PRICE_ASC";
5170
5170
  PRICE_DESC: "PRICE_DESC";
5171
5171
  }>>;
@@ -5249,8 +5249,8 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
5249
5249
  usable: z.ZodDefault<z.ZodBoolean>;
5250
5250
  }, z.core.$strip>>>;
5251
5251
  optionSort: z.ZodOptional<z.ZodEnum<{
5252
- NAME: "NAME";
5253
5252
  REGISTERED: "REGISTERED";
5253
+ NAME: "NAME";
5254
5254
  PRICE_ASC: "PRICE_ASC";
5255
5255
  PRICE_DESC: "PRICE_DESC";
5256
5256
  }>>;
@@ -5284,6 +5284,7 @@ export declare const productPatchRequestSchema: z.ZodObject<{
5284
5284
  SALE: "SALE";
5285
5285
  OUT_OF_STOCK: "OUT_OF_STOCK";
5286
5286
  }>>;
5287
+ images: z.ZodOptional<z.ZodArray<z.ZodURL>>;
5287
5288
  fulfillment: z.ZodOptional<z.ZodDiscriminatedUnion<[z.ZodObject<{
5288
5289
  type: z.ZodLiteral<"SHIPPING">;
5289
5290
  shipping: z.ZodObject<{
@@ -5310,11 +5311,11 @@ export declare const productPatchRequestSchema: z.ZodObject<{
5310
5311
  }, z.core.$strict>;
5311
5312
  export type ProductPatchRequest = z.infer<typeof productPatchRequestSchema>;
5312
5313
  export declare const productSortSchema: z.ZodEnum<{
5314
+ "updatedAt.desc": "updatedAt.desc";
5313
5315
  "createdAt.desc": "createdAt.desc";
5314
5316
  "createdAt.asc": "createdAt.asc";
5315
5317
  "salePrice.asc": "salePrice.asc";
5316
5318
  "salePrice.desc": "salePrice.desc";
5317
- "updatedAt.desc": "updatedAt.desc";
5318
5319
  }>;
5319
5320
  export type ProductSort = z.infer<typeof productSortSchema>;
5320
5321
  export interface ProductListParams extends PageParams {
@@ -5338,11 +5339,11 @@ export declare const productListQuerySchema: z.ZodObject<{
5338
5339
  keyword: z.ZodOptional<z.ZodString>;
5339
5340
  sellerCode: z.ZodOptional<z.ZodString>;
5340
5341
  sort: z.ZodOptional<z.ZodEnum<{
5342
+ "updatedAt.desc": "updatedAt.desc";
5341
5343
  "createdAt.desc": "createdAt.desc";
5342
5344
  "createdAt.asc": "createdAt.asc";
5343
5345
  "salePrice.asc": "salePrice.asc";
5344
5346
  "salePrice.desc": "salePrice.desc";
5345
- "updatedAt.desc": "updatedAt.desc";
5346
5347
  }>>;
5347
5348
  }, z.core.$strip>;
5348
5349
  export declare const discountRequestSchema: z.ZodObject<{
@@ -5363,7 +5364,7 @@ export type DiscountRequest = z.infer<typeof discountRequestSchema>;
5363
5364
  * **불러오기는 복사다.** 저장 옵션을 고치거나 지워도 이미 불러온 상품의 옵션은 그대로다. 재고·SKU·사용 여부는 상품마다
5364
5365
  * 달라 저장하지 않는다. 추가금은 조합별이 아니라 **값별**로 둔다 — 조합 옵션으로 불러오면 조합 추가금은 고른 값 추가금의 합이다.
5365
5366
  */
5366
- /** 스토어당 저장 옵션 최대 개수 */
5367
+ /** 상점당 저장 옵션 최대 개수 */
5367
5368
  export declare const MAX_SAVED_OPTION_SETS = 200;
5368
5369
  /** 저장 옵션 이름 최대 글자 수 */
5369
5370
  export declare const MAX_SAVED_OPTION_SET_NAME = 50;
@@ -5398,8 +5399,8 @@ export declare const savedOptionSetSchema: z.ZodObject<{
5398
5399
  optionSetId: z.ZodString;
5399
5400
  name: z.ZodString;
5400
5401
  optionSort: z.ZodEnum<{
5401
- NAME: "NAME";
5402
5402
  REGISTERED: "REGISTERED";
5403
+ NAME: "NAME";
5403
5404
  PRICE_ASC: "PRICE_ASC";
5404
5405
  PRICE_DESC: "PRICE_DESC";
5405
5406
  }>;
@@ -5453,8 +5454,8 @@ export declare const savedCustomInputRequestSchema: z.ZodObject<{
5453
5454
  export declare const savedOptionSetRequestSchema: z.ZodObject<{
5454
5455
  name: z.ZodString;
5455
5456
  optionSort: z.ZodDefault<z.ZodEnum<{
5456
- NAME: "NAME";
5457
5457
  REGISTERED: "REGISTERED";
5458
+ NAME: "NAME";
5458
5459
  PRICE_ASC: "PRICE_ASC";
5459
5460
  PRICE_DESC: "PRICE_DESC";
5460
5461
  }>>;
@@ -5499,8 +5500,8 @@ export declare const savedOptionSetFromProductResultSchema: z.ZodObject<{
5499
5500
  optionSetId: z.ZodString;
5500
5501
  name: z.ZodString;
5501
5502
  optionSort: z.ZodEnum<{
5502
- NAME: "NAME";
5503
5503
  REGISTERED: "REGISTERED";
5504
+ NAME: "NAME";
5504
5505
  PRICE_ASC: "PRICE_ASC";
5505
5506
  PRICE_DESC: "PRICE_DESC";
5506
5507
  }>;
@@ -5562,14 +5563,14 @@ export declare const savedOptionSetListQuerySchema: z.ZodObject<{
5562
5563
  //#endregion
5563
5564
  //#region src/schemas/store.d.ts
5564
5565
  /**
5565
- * 스토어 코드 규칙 — 스토어프론트 API가 테넌트를 가르는 값이다(`X-Store-Code` 헤더).
5566
+ * 상점 코드 규칙 — 스토어프론트 API가 테넌트를 가르는 값이다(`X-Store-Code` 헤더).
5566
5567
  * **개설할 때 서버가 랜덤으로 발급하고** 이후 바꿀 수 없다. 이미 나간 링크와 승인된 결제가
5567
5568
  * 이 값에 묶여 있어서 바꾸면 함께 깨진다.
5568
5569
  *
5569
5570
  * 호스트 라벨로도 쓸 수 있게 DNS 라벨 규칙까지 좁힌다. 하이픈으로 시작하거나 끝나는 라벨은 호스트가 될 수 없다.
5570
5571
  */
5571
5572
  export declare const STORE_CODE_PATTERN: RegExp;
5572
- /** 플랫폼이 쓰거나 쓸 호스트 이름 — 스토어 코드로 내주지 않는다 */
5573
+ /** 플랫폼이 쓰거나 쓸 호스트 이름 — 상점 코드로 내주지 않는다 */
5573
5574
  export declare const RESERVED_STORE_CODES: readonly string[];
5574
5575
  export declare function isReservedStoreCode(code: string): boolean;
5575
5576
  export declare const storeCodeSchema: z.ZodString;
@@ -5582,7 +5583,7 @@ export declare const MAX_ANALYTICS_ALLOWED_ORIGINS = 20;
5582
5583
  /** 자동 배송완료·자동 구매확정 대기일 상한 */
5583
5584
  export declare const MAX_AUTO_TRANSITION_DAYS = 30;
5584
5585
  /**
5585
- * 약관 버전 — 스토어가 정하는 문자열이다(`1`·`2`·`2026-09-26`·`v1.2` 등). 형식은 강제하지 않고 값이 다르면 다른 버전이다.
5586
+ * 약관 버전 — 상점이 정하는 문자열이다(`1`·`2`·`2026-09-26`·`v1.2` 등). 형식은 강제하지 않고 값이 다르면 다른 버전이다.
5586
5587
  * 올리면 그 약관에 동의한 구매자의 `reconsentRequired`가 켜지고, 재동의가 이력에 남는다. 되돌리면 재동의 요구도 풀린다.
5587
5588
  */
5588
5589
  export declare const policyVersionSchema: z.ZodString;
@@ -5591,12 +5592,47 @@ export declare const policyVersionSchema: z.ZodString;
5591
5592
  * 나중에 주소를 바꿔도 "무엇에 동의했는지"가 남는다. `null`로 지울 수 있다.
5592
5593
  */
5593
5594
  export declare const policyDocumentUrlSchema: z.ZodNullable<z.ZodURL>;
5595
+ /**
5596
+ * 사업자등록번호 — 숫자 10자리. 하이픈(`123-45-67890`)과 공백은 받고 서버가 숫자만 남겨 저장한다.
5597
+ * 국세청 검증번호(체크섬)는 보지 않는다.
5598
+ */
5599
+ export declare const BUSINESS_NUMBER_PATTERN: RegExp;
5600
+ /** 사업자등록번호에서 숫자만 남긴다 — 저장·비교는 이 값으로 한다 */
5601
+ export declare function normalizeBusinessNumber(value: string): string;
5602
+ export declare const businessNumberSchema: z.ZodNullable<z.ZodString>;
5603
+ /** 사업자 정보 필드의 길이 상한 — 상점 플랫폼 입력 칸과 같다 */
5604
+ export declare const BUSINESS_INFO_MAX_LENGTH: {
5605
+ readonly businessName: 100;
5606
+ readonly representativeName: 50;
5607
+ readonly mailOrderSalesNumber: 50;
5608
+ readonly businessAddress: 200;
5609
+ readonly privacyOfficerName: 50;
5610
+ };
5611
+ /**
5612
+ * `PATCH /v1/store`의 사업자 정보 필드(이슈 #81) — 전자상거래법 표기(스토어프론트 푸터)용이다.
5613
+ * 바꿀 필드만 보내고 `null`을 주면 지운다. 스토어프론트 `GET /store`가 같은 값을 싣는다.
5614
+ */
5615
+ export declare const businessInfoPatchShape: {
5616
+ businessName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5617
+ representativeName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5618
+ businessNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5619
+ mailOrderSalesNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5620
+ businessAddress: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5621
+ customerCenterEmail: z.ZodOptional<z.ZodNullable<z.ZodEmail>>;
5622
+ privacyOfficerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5623
+ privacyOfficerEmail: z.ZodOptional<z.ZodNullable<z.ZodEmail>>;
5624
+ };
5625
+ export declare const businessInfoResponseShape: {
5626
+ businessName: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5627
+ representativeName: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5628
+ mailOrderSalesNumber: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5629
+ businessAddress: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5630
+ customerCenterEmail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5631
+ privacyOfficerName: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5632
+ privacyOfficerEmail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5633
+ };
5594
5634
  /** `PATCH /v1/store` 본문 — 바꿀 필드만 보낸다 */
5595
5635
  export declare const updateStoreRequestSchema: z.ZodObject<{
5596
- name: z.ZodOptional<z.ZodString>;
5597
- logoUrl: z.ZodOptional<z.ZodURL>;
5598
- customerCenterPhone: z.ZodOptional<z.ZodString>;
5599
- businessHours: z.ZodOptional<z.ZodString>;
5600
5636
  analyticsAllowedOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
5601
5637
  storefrontOrigins: z.ZodOptional<z.ZodArray<z.ZodString>>;
5602
5638
  guestCheckoutEnabled: z.ZodOptional<z.ZodBoolean>;
@@ -5620,21 +5656,21 @@ export declare const updateStoreRequestSchema: z.ZodObject<{
5620
5656
  privacyVersion: z.ZodOptional<z.ZodString>;
5621
5657
  termsUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
5622
5658
  privacyUrl: z.ZodOptional<z.ZodNullable<z.ZodURL>>;
5659
+ businessName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5660
+ representativeName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5661
+ businessNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5662
+ mailOrderSalesNumber: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5663
+ businessAddress: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5664
+ customerCenterEmail: z.ZodOptional<z.ZodNullable<z.ZodEmail>>;
5665
+ privacyOfficerName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5666
+ privacyOfficerEmail: z.ZodOptional<z.ZodNullable<z.ZodEmail>>;
5667
+ name: z.ZodOptional<z.ZodString>;
5668
+ logoUrl: z.ZodOptional<z.ZodURL>;
5669
+ customerCenterPhone: z.ZodOptional<z.ZodNullable<z.ZodString>>;
5670
+ businessHours: z.ZodOptional<z.ZodString>;
5623
5671
  }, z.core.$strip>;
5624
5672
  export type UpdateStoreRequest = z.infer<typeof updateStoreRequestSchema>;
5625
5673
  export declare const storeSchema: z.ZodObject<{
5626
- storeId: z.ZodString;
5627
- name: z.ZodString;
5628
- storeCode: z.ZodString;
5629
- storefrontUrl: z.ZodURL;
5630
- status: z.ZodEnum<{
5631
- ACTIVE: "ACTIVE";
5632
- SUSPENDED: "SUSPENDED";
5633
- CLOSED: "CLOSED";
5634
- }>;
5635
- logoUrl: z.ZodNullable<z.ZodURL>;
5636
- businessNumber: z.ZodNullable<z.ZodString>;
5637
- customerCenterPhone: z.ZodNullable<z.ZodString>;
5638
5674
  analyticsAllowedOrigins: z.ZodArray<z.ZodString>;
5639
5675
  storefrontOrigins: z.ZodArray<z.ZodString>;
5640
5676
  guestCheckoutEnabled: z.ZodBoolean;
@@ -5662,6 +5698,25 @@ export declare const storeSchema: z.ZodObject<{
5662
5698
  privacyUrl: z.ZodNullable<z.ZodString>;
5663
5699
  memberCount: z.ZodNumber;
5664
5700
  createdAt: z.ZodString;
5701
+ businessName: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5702
+ representativeName: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5703
+ mailOrderSalesNumber: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5704
+ businessAddress: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5705
+ customerCenterEmail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5706
+ privacyOfficerName: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5707
+ privacyOfficerEmail: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
5708
+ storeId: z.ZodString;
5709
+ name: z.ZodString;
5710
+ storeCode: z.ZodString;
5711
+ storefrontUrl: z.ZodURL;
5712
+ status: z.ZodEnum<{
5713
+ ACTIVE: "ACTIVE";
5714
+ SUSPENDED: "SUSPENDED";
5715
+ CLOSED: "CLOSED";
5716
+ }>;
5717
+ logoUrl: z.ZodNullable<z.ZodURL>;
5718
+ businessNumber: z.ZodNullable<z.ZodString>;
5719
+ customerCenterPhone: z.ZodNullable<z.ZodString>;
5665
5720
  }, z.core.$strip>;
5666
5721
  export type Store = z.infer<typeof storeSchema>;
5667
5722
  export declare const storeMemberSchema: z.ZodObject<{
@@ -5679,7 +5734,7 @@ export declare const storeMemberSchema: z.ZodObject<{
5679
5734
  export type StoreMember = z.infer<typeof storeMemberSchema>;
5680
5735
  /**
5681
5736
  * 초대 메일 발송 결과 — `SENDING`은 발송 요청 중(결과를 아직 적지 못함), `NOT_CONFIGURED`는 메일 발송이 설정되지 않아
5682
- * 보내지 않은 것이다. 스토어의 월 메일 한도(요금제)를 다 써서 보내지 않았으면 `FAILED` + `deliveryErrorCode: MAIL_QUOTA_EXCEEDED`다. 발송 실패는 초대를 무효로 만들지 않는다 — 재발송으로 다시 보낸다
5737
+ * 보내지 않은 것이다. 상점의 월 메일 한도(요금제)를 다 써서 보내지 않았으면 `FAILED` + `deliveryErrorCode: MAIL_QUOTA_EXCEEDED`다. 발송 실패는 초대를 무효로 만들지 않는다 — 재발송으로 다시 보낸다
5683
5738
  */
5684
5739
  export declare const invitationDeliveryStatusSchema: z.ZodEnum<{
5685
5740
  FAILED: "FAILED";
@@ -5696,10 +5751,10 @@ export declare const invitationSchema: z.ZodObject<{
5696
5751
  STAFF: "STAFF";
5697
5752
  }>;
5698
5753
  status: z.ZodEnum<{
5754
+ CANCELED: "CANCELED";
5699
5755
  PENDING: "PENDING";
5700
5756
  EXPIRED: "EXPIRED";
5701
5757
  ACCEPTED: "ACCEPTED";
5702
- CANCELED: "CANCELED";
5703
5758
  }>;
5704
5759
  invitedBy: z.ZodString;
5705
5760
  expiresAt: z.ZodString;
@@ -5736,10 +5791,10 @@ export type UpdateMemberRoleRequest = z.infer<typeof updateMemberRoleRequestSche
5736
5791
  /** `GET /v1/store/invitations` 쿼리 — OpenAPI 문서용 형태 */
5737
5792
  export declare const invitationListQuerySchema: z.ZodObject<{
5738
5793
  status: z.ZodOptional<z.ZodEnum<{
5794
+ CANCELED: "CANCELED";
5739
5795
  PENDING: "PENDING";
5740
5796
  EXPIRED: "EXPIRED";
5741
5797
  ACCEPTED: "ACCEPTED";
5742
- CANCELED: "CANCELED";
5743
5798
  }>>;
5744
5799
  }, z.core.$strip>;
5745
5800
  /** `PATCH /v1/store/members/{userId}` 응답 — 바뀐 역할 */
@@ -5755,22 +5810,22 @@ export type StoreMemberRoleUpdated = z.infer<typeof storeMemberRoleUpdatedSchema
5755
5810
  * 주소 유형 — 출고지·반품지.
5756
5811
  */
5757
5812
  export declare const addressTypeSchema: z.ZodEnum<{
5758
- RETURN: "RETURN";
5759
5813
  SHIPPING: "SHIPPING";
5814
+ RETURN: "RETURN";
5760
5815
  }>;
5761
5816
  export type AddressType = z.infer<typeof addressTypeSchema>;
5762
5817
  /** `GET /v1/seller-addresses` 쿼리 — OpenAPI 문서용 형태. 기본 주소 우선, 그다음 등록순이다 */
5763
5818
  export declare const sellerAddressListQuerySchema: z.ZodObject<{
5764
5819
  type: z.ZodOptional<z.ZodEnum<{
5765
- RETURN: "RETURN";
5766
5820
  SHIPPING: "SHIPPING";
5821
+ RETURN: "RETURN";
5767
5822
  }>>;
5768
5823
  }, z.core.$strip>;
5769
5824
  export declare const sellerAddressSchema: z.ZodObject<{
5770
5825
  addressId: z.ZodString;
5771
5826
  type: z.ZodEnum<{
5772
- RETURN: "RETURN";
5773
5827
  SHIPPING: "SHIPPING";
5828
+ RETURN: "RETURN";
5774
5829
  }>;
5775
5830
  name: z.ZodString;
5776
5831
  isDefault: z.ZodBoolean;
@@ -5784,8 +5839,8 @@ export declare const sellerAddressSchema: z.ZodObject<{
5784
5839
  export type SellerAddress = z.infer<typeof sellerAddressSchema>;
5785
5840
  export declare const sellerAddressRequestSchema: z.ZodObject<{
5786
5841
  type: z.ZodEnum<{
5787
- RETURN: "RETURN";
5788
5842
  SHIPPING: "SHIPPING";
5843
+ RETURN: "RETURN";
5789
5844
  }>;
5790
5845
  name: z.ZodString;
5791
5846
  contactName: z.ZodString;
@@ -5800,7 +5855,7 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
5800
5855
  /**
5801
5856
  * 스토어프론트 호스팅 (이슈 #53, M1: 템플릿 발행) — 관리 API `/v1/storefront/**`의 계약이다.
5802
5857
  *
5803
- * 셀러는 템플릿을 골라 사이트를 만들고 `{slug}.{호스팅 도메인}` 주소를 받는다. 스토어를 만들어도 사이트는 생기지 않고
5858
+ * 셀러는 템플릿을 골라 사이트를 만들고 `{slug}.{호스팅 도메인}` 주소를 받는다. 상점을 만들어도 사이트는 생기지 않고
5804
5859
  * `POST /v1/storefront/site`가 유일한 생성 경로다. 템플릿은 만들 때만 고르고 바꾸지 않는다. 발행은 버전 단위이고,
5805
5860
  * 되돌리기는 이전 버전을 다시 발행하는 것이다(재빌드 없음). 상태의 원천은 api DB이고 Cloudflare 쪽 반영
5806
5861
  * (라우팅 표·사이트 Worker)은 커밋 뒤 비동기다 — 반영 상태는 `provisioning`으로 본다.
@@ -5811,13 +5866,13 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
5811
5866
  * 오류 코드:
5812
5867
  * - 403 `STOREFRONT_HOSTING_DISABLED` — 플랫폼 스위치가 꺼져 새 사이트를 만들 수 없다
5813
5868
  * - 404 `STOREFRONT_SITE_NOT_FOUND` · `STOREFRONT_TEMPLATE_NOT_FOUND` · `STOREFRONT_VERSION_NOT_FOUND`
5814
- * - 409 `STOREFRONT_SITE_EXISTS` — 이미 사이트가 있다(스토어당 1개)
5869
+ * - 409 `STOREFRONT_SITE_EXISTS` — 이미 사이트가 있다(상점당 1개)
5815
5870
  * - 409 `STOREFRONT_SLUG_TAKEN` — 다른 사이트가 쓰거나 보류 중인 슬러그다
5816
- * - 409 `STOREFRONT_SLUG_CHANGE_LIMIT` — 슬러그는 스토어당 30일에 3번까지 바꾼다
5817
- * - 409 `STOREFRONT_SITE_CREATE_LIMIT` — 사이트는 스토어당 30일에 3번까지 만든다
5871
+ * - 409 `STOREFRONT_SLUG_CHANGE_LIMIT` — 슬러그는 상점당 30일에 3번까지 바꾼다
5872
+ * - 409 `STOREFRONT_SITE_CREATE_LIMIT` — 사이트는 상점당 30일에 3번까지 만든다
5818
5873
  * - 409 `STOREFRONT_SITE_CHANGED` — 읽은 상태(`expected*`)와 현재 상태가 다르다. 다시 읽고 시도한다
5819
5874
  * - 409 `STOREFRONT_SITE_NOT_ACTIVE` — 정지(`SUSPENDED`)된 사이트는 바꾸거나 끌 수 없다
5820
- * - 409 `STORE_SUSPENDED` — 정지된 스토어에는 사이트를 만들 수 없다
5875
+ * - 409 `STORE_SUSPENDED` — 정지된 상점에는 사이트를 만들 수 없다
5821
5876
  * - 409 `STOREFRONT_VERSION_NOT_READY` — 빌드가 끝나지 않았거나 실패한 버전은 발행할 수 없다
5822
5877
  * - 409 `STOREFRONT_NO_ROLLBACK_TARGET` — 되돌릴 이전 발행 버전이 없다
5823
5878
  * - 409 `STOREFRONT_NOT_READY` — 공개 전환: 판매 중인 상품(샘플 제외)이 없다(이슈 #70). 상품을 등록한 뒤 공개한다
@@ -5843,7 +5898,7 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
5843
5898
  * - 502 `STOREFRONT_SANDBOX_UNAVAILABLE` — 편집 Sandbox 호출이 실패했다. 잠시 뒤 다시 한다
5844
5899
  *
5845
5900
  * 소스 내려받기·올리기(#60, `/v1/storefront/site/source/**`, `sayren` CLI):
5846
- * - 409 `SOURCE_CHANGED` — 작업 트리가 내려받은 뒤(`expectedBaseRef`) 바뀌었다(콘솔·AI 편집). `error.details.currentRef`
5901
+ * - 409 `SOURCE_CHANGED` — 작업 트리가 내려받은 뒤(`expectedBaseRef`) 바뀌었다(상점 플랫폼·AI 편집). `error.details.currentRef`
5847
5902
  * - 409 `EDIT_SESSION_OPEN` — 편집 환경이 열려 있다. `endEditSession: true`로 끄고 진행할 수 있다
5848
5903
  * - 409 `SOURCE_BLOBS_MISSING` — 올리지 않은 파일 내용이 있다(`error.details.hashes`). `POST source/blobs`로 올리고 다시 한다
5849
5904
  * - 409 `DEPENDENCY_REJECTED` — 쓸 수 없는 npm 의존성이다(`error.details.rejected: [{ name, version, reason, detail }]`)
@@ -5853,11 +5908,11 @@ export type SellerAddressRequest = z.infer<typeof sellerAddressRequestSchema>;
5853
5908
  * - 404 `STOREFRONT_SOURCE_NOT_FOUND` — 그 스냅샷이 없다
5854
5909
  */
5855
5910
  /**
5856
- * 슬러그 형식 — 스토어 코드와 같은 DNS 라벨 규칙(소문자·숫자·하이픈 3~30자, 하이픈으로 시작·끝 불가)에
5911
+ * 슬러그 형식 — 상점 코드와 같은 DNS 라벨 규칙(소문자·숫자·하이픈 3~30자, 하이픈으로 시작·끝 불가)에
5857
5912
  * 연속 하이픈 금지를 더한다. `--`는 버전 미리보기 주소(`v3--{slug}`)와 punycode(`xn--`)가 쓰는 구분자다.
5858
5913
  */
5859
5914
  export declare const STOREFRONT_SLUG_PATTERN: RegExp;
5860
- /** 호스팅 도메인에서 플랫폼이 쓰거나 쓸 이름 — 스토어 코드 예약어에 호스팅 전용 이름을 더한다 */
5915
+ /** 호스팅 도메인에서 플랫폼이 쓰거나 쓸 이름 — 상점 코드 예약어에 호스팅 전용 이름을 더한다 */
5861
5916
  export declare const RESERVED_STOREFRONT_SLUGS: readonly string[];
5862
5917
  /**
5863
5918
  * 편집 미리보기 호스트 접미사 — 편집 미리보기 주소는 `{사이트 id 정규화}-preview.{호스팅 도메인}`이다(M2b). 사이트 주소와 같은
@@ -5866,7 +5921,7 @@ export declare const RESERVED_STOREFRONT_SLUGS: readonly string[];
5866
5921
  export declare const STOREFRONT_EDIT_PREVIEW_SUFFIX = "-preview";
5867
5922
  /**
5868
5923
  * 공식 쇼케이스 슬러그 접두사(이슈 #72) — `demo-{템플릿 id}`는 템플릿 미리보기용 쇼케이스 사이트 주소다. 쇼케이스로 지정된
5869
- * 스토어만 쓸 수 있다(서버가 스토어 용도로 판정한다). 공식 미리보기를 흉내 내는 주소를 막는다
5924
+ * 상점만 쓸 수 있다(서버가 상점 용도로 판정한다). 공식 미리보기를 흉내 내는 주소를 막는다
5870
5925
  */
5871
5926
  export declare const STOREFRONT_SHOWCASE_SLUG_PREFIX = "demo-";
5872
5927
  export declare function isShowcaseStorefrontSlug(slug: string): boolean;
@@ -5882,9 +5937,9 @@ export declare const storefrontSlugSchema: z.ZodString;
5882
5937
  export declare const STOREFRONT_SLUG_HOLD_DAYS = 90;
5883
5938
  /** 슬러그 변경 한도 — 이 기간(일) 안에 */
5884
5939
  export declare const STOREFRONT_SLUG_CHANGE_WINDOW_DAYS = 30;
5885
- /** 슬러그 변경 한도 — 횟수(스토어 단위. 끄고 다시 만들어도 이어서 센다) */
5940
+ /** 슬러그 변경 한도 — 횟수(상점 단위. 끄고 다시 만들어도 이어서 센다) */
5886
5941
  export declare const STOREFRONT_SLUG_CHANGE_LIMIT = 3;
5887
- /** 사이트 만들기 한도 — 같은 창(30일) 안의 횟수(스토어 단위). 끄고 만들기를 되풀이해 이름을 묶어 두지 못하게 한다 */
5942
+ /** 사이트 만들기 한도 — 같은 창(30일) 안의 횟수(상점 단위). 끄고 만들기를 되풀이해 이름을 묶어 두지 못하게 한다 */
5888
5943
  export declare const STOREFRONT_SITE_CREATE_LIMIT = 3;
5889
5944
  export declare const storefrontTemplateSchema: z.ZodObject<{
5890
5945
  templateId: z.ZodString;
@@ -5979,7 +6034,7 @@ export declare const storefrontProvisioningSchema: z.ZodObject<{
5979
6034
  export type StorefrontProvisioning = z.infer<typeof storefrontProvisioningSchema>;
5980
6035
  /**
5981
6036
  * 편집 미리보기 주소(M2b) — 사이트마다 `{사이트 id 정규화}-preview.{호스팅 도메인}` 호스트 하나다. 호스팅 도메인의 와일드카드
5982
- * 인증서가 덮으므로 따로 준비할 것이 없다. 이 주소는 편집 미리보기 링크(콘솔 전용)로 받은 쿠키가 있어야 열린다.
6037
+ * 인증서가 덮으므로 따로 준비할 것이 없다. 이 주소는 편집 미리보기 링크(상점 플랫폼 전용)로 받은 쿠키가 있어야 열린다.
5983
6038
  */
5984
6039
  export declare const storefrontEditPreviewSchema: z.ZodObject<{
5985
6040
  hostname: z.ZodNullable<z.ZodString>;
@@ -6162,7 +6217,7 @@ export declare const storefrontSlugAvailabilitySchema: z.ZodObject<{
6162
6217
  }, z.core.$strip>;
6163
6218
  export type StorefrontSlugAvailability = z.infer<typeof storefrontSlugAvailabilitySchema>;
6164
6219
  /**
6165
- * 배포 진행 — 사이트의 지금 발행 상태가 공개 주소에 반영되기까지의 단계와 기록이다(콘솔의 스토어프론트 만들기 3단계가 폴링한다).
6220
+ * 배포 진행 — 사이트의 지금 발행 상태가 공개 주소에 반영되기까지의 단계와 기록이다(상점 플랫폼의 스토어프론트 만들기 3단계가 폴링한다).
6166
6221
  * 만들기(`POST /v1/storefront/site`)는 곧바로 201로 답하고 반영은 그 뒤에 비동기로 하므로, 끝났는지는 이 조회로 본다.
6167
6222
  * 템플릿 사이트는 미리 빌드한 템플릿 산출물을 올리므로 빌드 단계가 없다. 기록은 사이트 상태에서 만든 요약이다.
6168
6223
  */
@@ -6195,9 +6250,9 @@ export type StorefrontDeploymentLog = z.infer<typeof storefrontDeploymentLogSche
6195
6250
  export declare const storefrontDeploymentSchema: z.ZodObject<{
6196
6251
  siteId: z.ZodString;
6197
6252
  status: z.ZodEnum<{
6198
- IN_PROGRESS: "IN_PROGRESS";
6199
6253
  SUCCEEDED: "SUCCEEDED";
6200
6254
  FAILED: "FAILED";
6255
+ IN_PROGRESS: "IN_PROGRESS";
6201
6256
  }>;
6202
6257
  url: z.ZodString;
6203
6258
  startedAt: z.ZodString;
@@ -6282,7 +6337,7 @@ export declare const storefrontSlugAvailabilityQuerySchema: z.ZodObject<{
6282
6337
  slug: z.ZodString;
6283
6338
  }, z.core.$strip>;
6284
6339
  /**
6285
- * 오픈 준비 중 미리보기 링크 — 콘솔에서 로그인한 OWNER·ADMIN만 받는다(PAT·에이전트 불가). 링크는 5분 안에 한 번 열면
6340
+ * 오픈 준비 중 미리보기 링크 — 상점 플랫폼에서 로그인한 OWNER·ADMIN만 받는다(PAT·에이전트 불가). 링크는 5분 안에 한 번 열면
6286
6341
  * 그 브라우저에 12시간짜리 미리보기 쿠키가 생기고 오픈 준비 중인 사이트의 실제 화면을 본다. 링크를 남에게 넘기면 그 사람도
6287
6342
  * 볼 수 있으므로 공유하지 않는다.
6288
6343
  */
@@ -6305,7 +6360,7 @@ export declare const STOREFRONT_PLATFORM_DOMAINS: readonly string[];
6305
6360
  * 것만 둔다(여기 없는 접미사도 TXT 소유 확인을 통과할 수 없어 연결되지 않는다 — 이 목록은 추가 단계에서 빨리 알려 주는 안내다).
6306
6361
  */
6307
6362
  export declare const STOREFRONT_PUBLIC_SUFFIXES: readonly string[];
6308
- /** 스토어당 연결할 수 있는 도메인 수 기본값 — 요금제(#44) 전의 상한이다. 실제 값은 `GET …/domains`의 `limit` */
6363
+ /** 상점당 연결할 수 있는 도메인 수 기본값 — 요금제(#44) 전의 상한이다. 실제 값은 `GET …/domains`의 `limit` */
6309
6364
  export declare const STOREFRONT_CUSTOM_DOMAIN_LIMIT_DEFAULT = 2;
6310
6365
  /** DNS를 넣을 때까지 기다리는 기간(일) — 지나면 `FAILED`(`DNS_NOT_CONFIGURED`) */
6311
6366
  export declare const STOREFRONT_DOMAIN_DNS_WAIT_DAYS = 7;
@@ -6330,8 +6385,8 @@ export declare function storefrontCustomHostnameProblem(hostname: string, hostin
6330
6385
  /** 소유 확인 TXT 레코드의 전체 이름 */
6331
6386
  export declare function storefrontDomainTxtNameOf(hostname: string): string;
6332
6387
  export declare const storefrontCustomDomainStatusSchema: z.ZodEnum<{
6333
- ACTIVE: "ACTIVE";
6334
6388
  FAILED: "FAILED";
6389
+ ACTIVE: "ACTIVE";
6335
6390
  PENDING_DNS: "PENDING_DNS";
6336
6391
  PENDING_VALIDATION: "PENDING_VALIDATION";
6337
6392
  }>;
@@ -6357,8 +6412,8 @@ export declare const storefrontSiteDomainSchema: z.ZodObject<{
6357
6412
  CUSTOM: "CUSTOM";
6358
6413
  }>;
6359
6414
  status: z.ZodEnum<{
6360
- ACTIVE: "ACTIVE";
6361
6415
  FAILED: "FAILED";
6416
+ ACTIVE: "ACTIVE";
6362
6417
  PENDING_DNS: "PENDING_DNS";
6363
6418
  PENDING_VALIDATION: "PENDING_VALIDATION";
6364
6419
  }>;
@@ -6376,9 +6431,9 @@ export declare const storefrontSiteDomainSchema: z.ZodObject<{
6376
6431
  }>;
6377
6432
  }, z.core.$strip>>;
6378
6433
  certificateStatus: z.ZodNullable<z.ZodEnum<{
6379
- ACTIVE: "ACTIVE";
6380
6434
  FAILED: "FAILED";
6381
6435
  PENDING: "PENDING";
6436
+ ACTIVE: "ACTIVE";
6382
6437
  }>>;
6383
6438
  failureCode: z.ZodNullable<z.ZodString>;
6384
6439
  verifiedAt: z.ZodNullable<z.ZodString>;
@@ -6400,8 +6455,8 @@ export declare const storefrontSiteDomainsSchema: z.ZodObject<{
6400
6455
  CUSTOM: "CUSTOM";
6401
6456
  }>;
6402
6457
  status: z.ZodEnum<{
6403
- ACTIVE: "ACTIVE";
6404
6458
  FAILED: "FAILED";
6459
+ ACTIVE: "ACTIVE";
6405
6460
  PENDING_DNS: "PENDING_DNS";
6406
6461
  PENDING_VALIDATION: "PENDING_VALIDATION";
6407
6462
  }>;
@@ -6419,9 +6474,9 @@ export declare const storefrontSiteDomainsSchema: z.ZodObject<{
6419
6474
  }>;
6420
6475
  }, z.core.$strip>>;
6421
6476
  certificateStatus: z.ZodNullable<z.ZodEnum<{
6422
- ACTIVE: "ACTIVE";
6423
6477
  FAILED: "FAILED";
6424
6478
  PENDING: "PENDING";
6479
+ ACTIVE: "ACTIVE";
6425
6480
  }>>;
6426
6481
  failureCode: z.ZodNullable<z.ZodString>;
6427
6482
  verifiedAt: z.ZodNullable<z.ZodString>;
@@ -6480,7 +6535,7 @@ export declare const storefrontEditSessionStatusSchema: z.ZodEnum<{
6480
6535
  RUNNING: "RUNNING";
6481
6536
  STARTING: "STARTING";
6482
6537
  }>;
6483
- /** 편집 환경을 띄우는 단계 — 콘솔 진행 표시용이다. 값은 늘어날 수 있다 */
6538
+ /** 편집 환경을 띄우는 단계 — 상점 플랫폼 진행 표시용이다. 값은 늘어날 수 있다 */
6484
6539
  export declare const STOREFRONT_EDIT_START_STAGES: readonly ["CONTAINER", "RESTORE", "DEV_SERVER"];
6485
6540
  export declare const storefrontEditSessionSchema: z.ZodObject<{
6486
6541
  sessionId: z.ZodString;
@@ -6655,8 +6710,8 @@ export declare const runStorefrontCheckRequestSchema: z.ZodObject<{
6655
6710
  }, z.core.$strip>;
6656
6711
  export type RunStorefrontCheckRequest = z.infer<typeof runStorefrontCheckRequestSchema>;
6657
6712
  export declare const storefrontCheckStatusSchema: z.ZodEnum<{
6658
- UNKNOWN: "UNKNOWN";
6659
6713
  FAILED: "FAILED";
6714
+ UNKNOWN: "UNKNOWN";
6660
6715
  RUNNING: "RUNNING";
6661
6716
  QUEUED: "QUEUED";
6662
6717
  PASSED: "PASSED";
@@ -6669,8 +6724,8 @@ export declare const storefrontCheckSchema: z.ZodObject<{
6669
6724
  checkId: z.ZodString;
6670
6725
  check: z.ZodString;
6671
6726
  status: z.ZodEnum<{
6672
- UNKNOWN: "UNKNOWN";
6673
6727
  FAILED: "FAILED";
6728
+ UNKNOWN: "UNKNOWN";
6674
6729
  RUNNING: "RUNNING";
6675
6730
  QUEUED: "QUEUED";
6676
6731
  PASSED: "PASSED";
@@ -7041,7 +7096,7 @@ export declare const storefrontVersionCreatedSchema: z.ZodObject<{
7041
7096
  }, z.core.$strip>;
7042
7097
  export type StorefrontVersionCreated = z.infer<typeof storefrontVersionCreatedSchema>;
7043
7098
  /**
7044
- * `POST /v1/storefront/site/editing/preview-link` — 편집 미리보기(dev 서버) 링크. 콘솔에서 로그인한 OWNER·ADMIN만
7099
+ * `POST /v1/storefront/site/editing/preview-link` — 편집 미리보기(dev 서버) 링크. 상점 플랫폼에서 로그인한 OWNER·ADMIN만
7045
7100
  * 받는다(PAT·에이전트 불가). 5분 안에 열면 그 브라우저에 미리보기 호스트 전용 쿠키(12시간)가 생긴다. 편집 환경이
7046
7101
  * 없으면 409 `EDIT_SESSION_REQUIRED`다(편집 환경이 `STARTING`이면 링크는 주고, 미리보기 화면이 기동 대기를 보여 준다).
7047
7102
  */
@@ -7151,8 +7206,8 @@ export type StorefrontSourceReplaced = z.infer<typeof storefrontSourceReplacedSc
7151
7206
  * - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
7152
7207
  */
7153
7208
  export declare const uploadPurposeSchema: z.ZodEnum<{
7154
- description: "description";
7155
7209
  "product-image": "product-image";
7210
+ description: "description";
7156
7211
  }>;
7157
7212
  export type UploadPurpose = z.infer<typeof uploadPurposeSchema>;
7158
7213
  export interface UploadPurposeLimit {
@@ -7177,7 +7232,7 @@ export interface UploadRejection {
7177
7232
  }
7178
7233
  /**
7179
7234
  * 용도 제한 위반 여부. 통과하면 `null`.
7180
- * 서버가 던지는 오류와 콘솔이 먼저 띄우는 안내가 갈리지 않도록 한 함수로 판정한다.
7235
+ * 서버가 던지는 오류와 상점 플랫폼이 먼저 띄우는 안내가 갈리지 않도록 한 함수로 판정한다.
7181
7236
  */
7182
7237
  export declare function uploadRejection(purpose: UploadPurpose, filename: string, size?: number): UploadRejection | null;
7183
7238
  /**
@@ -7190,8 +7245,8 @@ export declare function uploadRejection(purpose: UploadPurpose, filename: string
7190
7245
  export declare const uploadRequestSchema: z.ZodObject<{
7191
7246
  filename: z.ZodString;
7192
7247
  purpose: z.ZodDefault<z.ZodEnum<{
7193
- description: "description";
7194
7248
  "product-image": "product-image";
7249
+ description: "description";
7195
7250
  }>>;
7196
7251
  size: z.ZodOptional<z.ZodNumber>;
7197
7252
  }, z.core.$strip>;
@@ -7236,7 +7291,7 @@ export type MyAccount = z.infer<typeof myAccountSchema>;
7236
7291
  //#endregion
7237
7292
  //#region src/session.d.ts
7238
7293
  /**
7239
- * SDK 세션 매니저 — 콘솔(액세스 토큰)의 저장·무음 갱신·회전을 캡슐화한다.
7294
+ * SDK 세션 매니저 — 상점 플랫폼(액세스 토큰)의 저장·무음 갱신·회전을 캡슐화한다.
7240
7295
  *
7241
7296
  * 저장 매체(쿠키/localStorage/…)와 그 속성(Max-Age·SameSite·Secure·Path)은 **어댑터(앱) 책임**이다.
7242
7297
  * SDK는 "무엇을 어떤 키로 저장할지"만 알고, "어떻게 저장할지"는 SessionStorage 어댑터에 위임한다.
@@ -7338,11 +7393,11 @@ interface StoreClientOptions {
7338
7393
  /** 예: https://api.example.com/v1 */
7339
7394
  baseUrl: string;
7340
7395
  /**
7341
- * 계정 토큰(accounts가 발급한 JWT — 콘솔 로그인, 개인 액세스 토큰, 연결된 앱의 토큰).
7342
- * 계정 API(`/me/*`)와 스토어 API 모두에 Bearer로 싣는다. `session`을 주면 생략해도 세션 토큰을 쓴다.
7396
+ * 계정 토큰(accounts가 발급한 JWT — 상점 플랫폼 로그인, 개인 액세스 토큰, 연결된 앱의 토큰).
7397
+ * 계정 API(`/me/*`)와 상점 API 모두에 Bearer로 싣는다. `session`을 주면 생략해도 세션 토큰을 쓴다.
7343
7398
  */
7344
7399
  accessToken?: TokenSource;
7345
- /** 대상 스토어 id — 스토어 API 요청에 `X-Store-Id`로 싣는다. 계정 API(`/me/*`)에는 싣지 않는다 */
7400
+ /** 대상 상점 id — 상점 API 요청에 `X-Store-Id`로 싣는다. 계정 API(`/me/*`)에는 싣지 않는다 */
7346
7401
  storeId?: TokenSource;
7347
7402
  /**
7348
7403
  * SDK 세션 매니저 — 전달하면 Bearer 토큰·401 refresh·복구 불가 시 clear를
@@ -7371,7 +7426,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7371
7426
  createdAt: string;
7372
7427
  } | null>;
7373
7428
  auth: {
7374
- /** 소속 스토어 목록 */
7429
+ /** 소속 상점 목록 */
7375
7430
  listMyStores: () => Promise<{
7376
7431
  storeId: string;
7377
7432
  storeName: string;
@@ -7487,7 +7542,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7487
7542
  usable: boolean;
7488
7543
  sortOrder: number;
7489
7544
  }[];
7490
- optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
7545
+ optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
7491
7546
  fulfillment: UnknownFulfillment | {
7492
7547
  type: "SHIPPING";
7493
7548
  shipping: {
@@ -7584,7 +7639,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7584
7639
  usable: boolean;
7585
7640
  sortOrder: number;
7586
7641
  }[];
7587
- optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
7642
+ optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
7588
7643
  fulfillment: UnknownFulfillment | {
7589
7644
  type: "SHIPPING";
7590
7645
  shipping: {
@@ -7681,7 +7736,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7681
7736
  usable: boolean;
7682
7737
  sortOrder: number;
7683
7738
  }[];
7684
- optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
7739
+ optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
7685
7740
  fulfillment: UnknownFulfillment | {
7686
7741
  type: "SHIPPING";
7687
7742
  shipping: {
@@ -7781,7 +7836,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7781
7836
  usable: boolean;
7782
7837
  sortOrder: number;
7783
7838
  }[];
7784
- optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
7839
+ optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
7785
7840
  }>;
7786
7841
  /**
7787
7842
  * 옵션 모델 전체 교체 — variants는 valueNames로 축 값을 지목한다.
@@ -7834,7 +7889,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7834
7889
  usable: boolean;
7835
7890
  sortOrder: number;
7836
7891
  }[];
7837
- optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
7892
+ optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
7838
7893
  }>;
7839
7894
  /** 재고 변경 — stockQuantity(절대값) 또는 adjustment(증감) 하나만 전달한다 */
7840
7895
  updateVariantStock: (productId: string, variantId: string, body: VariantStockRequest) => Promise<{
@@ -7872,7 +7927,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7872
7927
  contents: {
7873
7928
  optionSetId: string;
7874
7929
  name: string;
7875
- optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
7930
+ optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
7876
7931
  groups: {
7877
7932
  name: string;
7878
7933
  kind: string;
@@ -7896,7 +7951,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7896
7951
  get: (optionSetId: string) => Promise<{
7897
7952
  optionSetId: string;
7898
7953
  name: string;
7899
- optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
7954
+ optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
7900
7955
  groups: {
7901
7956
  name: string;
7902
7957
  kind: string;
@@ -7916,11 +7971,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
7916
7971
  createdAt: string;
7917
7972
  updatedAt: string;
7918
7973
  }>;
7919
- /** 이름이 겹치면 409 `OPTION_SET_NAME_TAKEN`, 스토어당 200개를 넘으면 409 `OPTION_SET_LIMIT_EXCEEDED` */
7974
+ /** 이름이 겹치면 409 `OPTION_SET_NAME_TAKEN`, 상점당 200개를 넘으면 409 `OPTION_SET_LIMIT_EXCEEDED` */
7920
7975
  create: (body: SavedOptionSetRequestInput) => Promise<{
7921
7976
  optionSetId: string;
7922
7977
  name: string;
7923
- optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
7978
+ optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
7924
7979
  groups: {
7925
7980
  name: string;
7926
7981
  kind: string;
@@ -7944,7 +7999,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7944
7999
  update: (optionSetId: string, body: SavedOptionSetRequestInput) => Promise<{
7945
8000
  optionSetId: string;
7946
8001
  name: string;
7947
- optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
8002
+ optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
7948
8003
  groups: {
7949
8004
  name: string;
7950
8005
  kind: string;
@@ -7970,7 +8025,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
7970
8025
  optionSet: {
7971
8026
  optionSetId: string;
7972
8027
  name: string;
7973
- optionSort: "NAME" | "REGISTERED" | "PRICE_ASC" | "PRICE_DESC";
8028
+ optionSort: "REGISTERED" | "NAME" | "PRICE_ASC" | "PRICE_DESC";
7974
8029
  groups: {
7975
8030
  name: string;
7976
8031
  kind: string;
@@ -8009,7 +8064,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8009
8064
  visible: boolean;
8010
8065
  showPc: boolean;
8011
8066
  showMobile: boolean;
8012
- productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
8067
+ productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
8013
8068
  metaTitle: string | null;
8014
8069
  metaDescription: string | null;
8015
8070
  metaKeywords: string | null;
@@ -8029,7 +8084,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8029
8084
  visible: boolean;
8030
8085
  showPc: boolean;
8031
8086
  showMobile: boolean;
8032
- productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
8087
+ productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
8033
8088
  metaTitle: string | null;
8034
8089
  metaDescription: string | null;
8035
8090
  metaKeywords: string | null;
@@ -8048,7 +8103,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8048
8103
  visible: boolean;
8049
8104
  showPc: boolean;
8050
8105
  showMobile: boolean;
8051
- productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
8106
+ productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
8052
8107
  metaTitle: string | null;
8053
8108
  metaDescription: string | null;
8054
8109
  metaKeywords: string | null;
@@ -8068,7 +8123,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8068
8123
  visible: boolean;
8069
8124
  showPc: boolean;
8070
8125
  showMobile: boolean;
8071
- productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
8126
+ productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
8072
8127
  metaTitle: string | null;
8073
8128
  metaDescription: string | null;
8074
8129
  metaKeywords: string | null;
@@ -8087,7 +8142,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8087
8142
  visible: boolean;
8088
8143
  showPc: boolean;
8089
8144
  showMobile: boolean;
8090
- productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
8145
+ productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
8091
8146
  metaTitle: string | null;
8092
8147
  metaDescription: string | null;
8093
8148
  metaKeywords: string | null;
@@ -8116,7 +8171,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8116
8171
  visible: boolean;
8117
8172
  showPc: boolean;
8118
8173
  showMobile: boolean;
8119
- productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
8174
+ productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
8120
8175
  metaTitle: string | null;
8121
8176
  metaDescription: string | null;
8122
8177
  metaKeywords: string | null;
@@ -8135,7 +8190,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8135
8190
  visible: boolean;
8136
8191
  showPc: boolean;
8137
8192
  showMobile: boolean;
8138
- productSort: "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH" | "NAME";
8193
+ productSort: "NAME" | "RECENT" | "POPULAR" | "PRICE_LOW" | "PRICE_HIGH";
8139
8194
  metaTitle: string | null;
8140
8195
  metaDescription: string | null;
8141
8196
  metaKeywords: string | null;
@@ -8161,7 +8216,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8161
8216
  ordererName: string;
8162
8217
  itemCount: number;
8163
8218
  totalAmount: number;
8164
- representativeStatus: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
8219
+ representativeStatus: "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
8165
8220
  orderedAt: string;
8166
8221
  testPayment: boolean;
8167
8222
  }[];
@@ -8226,7 +8281,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8226
8281
  items: {
8227
8282
  orderItemId: string;
8228
8283
  orderId: string;
8229
- status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
8284
+ status: "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
8230
8285
  claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
8231
8286
  productId: string;
8232
8287
  productName: string;
@@ -8279,7 +8334,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8279
8334
  }>;
8280
8335
  /**
8281
8336
  * `POST /v1/orders/{orderId}/cash-receipt/reissue` — 실패했거나 재시도 대기 중인 현금영수증을 지금 다시 발급·취소한다.
8282
- * 콘솔 OWNER·ADMIN 전용(PAT·M2M 403 `INSUFFICIENT_ROLE`). 404 `CASH_RECEIPT_NOT_FOUND`, 409 `CASH_RECEIPT_NOT_REISSUABLE`
8337
+ * 상점 플랫폼 OWNER·ADMIN 전용(PAT·M2M 403 `INSUFFICIENT_ROLE`). 404 `CASH_RECEIPT_NOT_FOUND`, 409 `CASH_RECEIPT_NOT_REISSUABLE`
8283
8338
  */
8284
8339
  reissueCashReceipt: (orderId: string) => Promise<{
8285
8340
  cashReceiptId: string;
@@ -8311,7 +8366,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8311
8366
  contents: {
8312
8367
  orderItemId: string;
8313
8368
  orderId: string;
8314
- status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
8369
+ status: "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
8315
8370
  claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
8316
8371
  productId: string;
8317
8372
  productName: string;
@@ -8395,7 +8450,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8395
8450
  }>;
8396
8451
  dispatch: (orderItemId: string, body: DispatchRequest, idempotencyKey?: string) => Promise<{
8397
8452
  orderItemId: string;
8398
- deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
8453
+ deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
8399
8454
  carrierCode: string | null;
8400
8455
  carrierName: string | null;
8401
8456
  trackingNumber: string | null;
@@ -8419,12 +8474,12 @@ export declare function createStoreClient(options: StoreClientOptions): {
8419
8474
  updateTracking: (orderItemId: string, carrierCode: string, trackingNumber: string) => Promise<void>;
8420
8475
  /**
8421
8476
  * 배송완료 처리 — `DISPATCHED`·`DELIVERING`만 넘어간다. 응답의 `autoDecisionDate`가 자동 구매확정 예정일이다
8422
- * (스토어 설정 `autoConfirmDays`가 0이면 null).
8477
+ * (상점 설정 `autoConfirmDays`가 0이면 null).
8423
8478
  */
8424
8479
  markDelivered: (orderItemId: string, idempotencyKey?: string) => Promise<{
8425
8480
  orderItemId: string;
8426
8481
  orderId: string;
8427
- status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
8482
+ status: "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
8428
8483
  claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
8429
8484
  productId: string;
8430
8485
  productName: string;
@@ -8492,7 +8547,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8492
8547
  fulfill: (orderItemId: string, body?: FulfillRequest, idempotencyKey?: string) => Promise<{
8493
8548
  orderItemId: string;
8494
8549
  orderId: string;
8495
- status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
8550
+ status: "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
8496
8551
  claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
8497
8552
  productId: string;
8498
8553
  productName: string;
@@ -8555,7 +8610,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8555
8610
  }>;
8556
8611
  getDelivery: (orderItemId: string) => Promise<{
8557
8612
  orderItemId: string;
8558
- deliveryMethod: "DIRECT" | "COURIER" | "QUICK" | "NOTHING";
8613
+ deliveryMethod: "COURIER" | "DIRECT" | "QUICK" | "NOTHING";
8559
8614
  carrierCode: string | null;
8560
8615
  carrierName: string | null;
8561
8616
  trackingNumber: string | null;
@@ -8592,15 +8647,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
8592
8647
  totalPages: number;
8593
8648
  contents: {
8594
8649
  claimId: string;
8595
- type: "CANCEL" | "RETURN" | "EXCHANGE";
8596
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
8650
+ type: "RETURN" | "EXCHANGE" | "CANCEL";
8651
+ status: "WITHDRAWN" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED";
8597
8652
  orderId: string;
8598
8653
  orderItemId: string;
8599
8654
  productName: string;
8600
8655
  quantity: number;
8601
8656
  reason: "CHANGE_OF_MIND" | "WRONG_ORDER" | "DEFECTIVE" | "WRONG_DELIVERY" | "DIFFERENT_FROM_PAGE" | "DELAY";
8602
8657
  reasonDetail: string | null;
8603
- responsibility: "BUYER" | "SELLER";
8658
+ responsibility: "SELLER" | "BUYER";
8604
8659
  claimDeliveryFee: number;
8605
8660
  expectedRefundAmount: number | null;
8606
8661
  expectedDeliveryFeeRefundAmount: number | null;
@@ -8630,15 +8685,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
8630
8685
  }>;
8631
8686
  get: (claimId: string) => Promise<{
8632
8687
  claimId: string;
8633
- type: "CANCEL" | "RETURN" | "EXCHANGE";
8634
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
8688
+ type: "RETURN" | "EXCHANGE" | "CANCEL";
8689
+ status: "WITHDRAWN" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED";
8635
8690
  orderId: string;
8636
8691
  orderItemId: string;
8637
8692
  productName: string;
8638
8693
  quantity: number;
8639
8694
  reason: "CHANGE_OF_MIND" | "WRONG_ORDER" | "DEFECTIVE" | "WRONG_DELIVERY" | "DIFFERENT_FROM_PAGE" | "DELAY";
8640
8695
  reasonDetail: string | null;
8641
- responsibility: "BUYER" | "SELLER";
8696
+ responsibility: "SELLER" | "BUYER";
8642
8697
  claimDeliveryFee: number;
8643
8698
  expectedRefundAmount: number | null;
8644
8699
  expectedDeliveryFeeRefundAmount: number | null;
@@ -8665,8 +8720,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
8665
8720
  address2: string | null;
8666
8721
  } | null;
8667
8722
  histories?: {
8668
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
8669
- actor: "SYSTEM" | "BUYER" | "SELLER";
8723
+ status: "WITHDRAWN" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED";
8724
+ actor: "SELLER" | "SYSTEM" | "BUYER";
8670
8725
  occurredAt: string;
8671
8726
  }[] | undefined;
8672
8727
  }>;
@@ -8696,15 +8751,15 @@ export declare function createStoreClient(options: StoreClientOptions): {
8696
8751
  /** 교환 완료 — 재배송 중인 교환을 셀러가 명시적으로 끝낸다 */
8697
8752
  completeExchange: (claimId: string) => Promise<{
8698
8753
  claimId: string;
8699
- type: "CANCEL" | "RETURN" | "EXCHANGE";
8700
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
8754
+ type: "RETURN" | "EXCHANGE" | "CANCEL";
8755
+ status: "WITHDRAWN" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "COMPLETED";
8701
8756
  orderId: string;
8702
8757
  orderItemId: string;
8703
8758
  productName: string;
8704
8759
  quantity: number;
8705
8760
  reason: "CHANGE_OF_MIND" | "WRONG_ORDER" | "DEFECTIVE" | "WRONG_DELIVERY" | "DIFFERENT_FROM_PAGE" | "DELAY";
8706
8761
  reasonDetail: string | null;
8707
- responsibility: "BUYER" | "SELLER";
8762
+ responsibility: "SELLER" | "BUYER";
8708
8763
  claimDeliveryFee: number;
8709
8764
  expectedRefundAmount: number | null;
8710
8765
  expectedDeliveryFeeRefundAmount: number | null;
@@ -8747,7 +8802,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8747
8802
  productId: string;
8748
8803
  productName: string;
8749
8804
  orderItemId: string | null;
8750
- category: "PRODUCT" | "DELIVERY" | "RETURN" | "EXCHANGE" | "ETC";
8805
+ category: "ETC" | "PRODUCT" | "DELIVERY" | "RETURN" | "EXCHANGE";
8751
8806
  content: string;
8752
8807
  secret: boolean;
8753
8808
  writerMaskedName: string;
@@ -8765,7 +8820,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8765
8820
  productId: string;
8766
8821
  productName: string;
8767
8822
  orderItemId: string | null;
8768
- category: "PRODUCT" | "DELIVERY" | "RETURN" | "EXCHANGE" | "ETC";
8823
+ category: "ETC" | "PRODUCT" | "DELIVERY" | "RETURN" | "EXCHANGE";
8769
8824
  content: string;
8770
8825
  secret: boolean;
8771
8826
  writerMaskedName: string;
@@ -8781,7 +8836,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8781
8836
  updateAnswer: (inquiryId: string, content: string) => Promise<void>;
8782
8837
  };
8783
8838
  /**
8784
- * 구매자 로그인 설정 — 이메일·비밀번호 허용, 소셜 공급자 연결. 비밀 값을 다루므로 콘솔에 로그인한 OWNER만 호출할 수 있다
8839
+ * 구매자 로그인 설정 — 이메일·비밀번호 허용, 소셜 공급자 연결. 비밀 값을 다루므로 상점 플랫폼에 로그인한 OWNER만 호출할 수 있다
8785
8840
  */
8786
8841
  loginSettings: {
8787
8842
  get: () => Promise<{
@@ -8877,7 +8932,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8877
8932
  }[];
8878
8933
  }>;
8879
8934
  };
8880
- /** 구매자 관리 — 조회 `customer:r`, 탈퇴 처리 `customer:rw`(콘솔 OWNER·ADMIN) */
8935
+ /** 구매자 관리 — 조회 `customer:r`, 탈퇴 처리 `customer:rw`(상점 플랫폼 OWNER·ADMIN) */
8881
8936
  customers: {
8882
8937
  list: (params?: PageParams & Omit<z.input<typeof customerListQuerySchema>, "page" | "size">) => Promise<{
8883
8938
  page: number;
@@ -8906,7 +8961,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8906
8961
  point: number;
8907
8962
  marketingAgreed: boolean;
8908
8963
  loginMethods: {
8909
- method: "kakao" | "naver" | "google" | "password";
8964
+ method: "password" | "kakao" | "naver" | "google";
8910
8965
  linkedAt: string;
8911
8966
  }[];
8912
8967
  consents: {
@@ -8973,7 +9028,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
8973
9028
  productName: string;
8974
9029
  optionName: string | null;
8975
9030
  quantity: number;
8976
- status: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED";
9031
+ status: "PAYMENT_WAITING" | "PAID" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | "CANCELED";
8977
9032
  claimStatus: "CANCEL_REQUESTED" | "RETURN_REQUESTED" | "EXCHANGE_REQUESTED" | null;
8978
9033
  }[];
8979
9034
  }[];
@@ -8991,8 +9046,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
8991
9046
  kind: "TERMS" | "PRIVACY" | "MARKETING";
8992
9047
  version: string | null;
8993
9048
  documentUrl: string | null;
8994
- action: "WITHDRAWN" | "AGREED";
8995
- source: "SELLER" | "SIGNUP" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE";
9049
+ action: "AGREED" | "WITHDRAWN";
9050
+ source: "SIGNUP" | "SOCIAL_SIGNUP" | "DELEGATED" | "RECONSENT" | "MEMBER_UPDATE" | "SELLER";
8996
9051
  occurredAt: string;
8997
9052
  }[];
8998
9053
  }>;
@@ -9398,7 +9453,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9398
9453
  contents: {
9399
9454
  inquiryId: string;
9400
9455
  memberMaskedName: string;
9401
- category: "DELIVERY" | "RETURN" | "EXCHANGE" | "ETC" | "PAYMENT";
9456
+ category: "ETC" | "DELIVERY" | "RETURN" | "EXCHANGE" | "PAYMENT";
9402
9457
  title: string;
9403
9458
  content: string;
9404
9459
  orderItemId: string | null;
@@ -9414,7 +9469,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9414
9469
  get: (inquiryId: string) => Promise<{
9415
9470
  inquiryId: string;
9416
9471
  memberMaskedName: string;
9417
- category: "DELIVERY" | "RETURN" | "EXCHANGE" | "ETC" | "PAYMENT";
9472
+ category: "ETC" | "DELIVERY" | "RETURN" | "EXCHANGE" | "PAYMENT";
9418
9473
  title: string;
9419
9474
  content: string;
9420
9475
  orderItemId: string | null;
@@ -9598,9 +9653,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
9598
9653
  }>;
9599
9654
  /** `GET /v1/analytics/sources` — 채널·소스·캠페인·기기별 세션과 구매 */
9600
9655
  sources: (params: AnalyticsSourcesParams) => Promise<{
9601
- groupBy: "CAMPAIGN" | "CHANNEL" | "SOURCE" | "DEVICE";
9656
+ groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
9602
9657
  rows: {
9603
- channel: "DIRECT" | "ORGANIC_SEARCH" | "SOCIAL" | "PAID" | "EMAIL" | "CAMPAIGN" | "REFERRAL" | "UNKNOWN" | null;
9658
+ channel: "PAID" | "UNKNOWN" | "DIRECT" | "CAMPAIGN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
9604
9659
  source: string | null;
9605
9660
  medium: string | null;
9606
9661
  campaign: string | null;
@@ -9705,7 +9760,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
9705
9760
  checkout: (params: AnalyticsRangeParams) => Promise<{
9706
9761
  sessions: number;
9707
9762
  outcomes: {
9708
- outcome: "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "OTHER" | "IN_PROGRESS";
9763
+ outcome: "OTHER" | "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "IN_PROGRESS";
9709
9764
  sessions: number;
9710
9765
  }[];
9711
9766
  from: string;
@@ -9826,8 +9881,8 @@ export declare function createStoreClient(options: StoreClientOptions): {
9826
9881
  }>;
9827
9882
  };
9828
9883
  /**
9829
- * 결제(PG) 설정 — **콘솔 OWNER 전용**. ADMIN·STAFF·PAT·M2M·3rd-party 앱 토큰은 스코프가 있어도
9830
- * 403 `INSUFFICIENT_ROLE`이다(조회 포함). OWNER 여부는 요청 시점의 스토어 멤버십으로 다시 확인하므로
9884
+ * 결제(PG) 설정 — **상점 플랫폼 OWNER 전용**. ADMIN·STAFF·PAT·M2M·3rd-party 앱 토큰은 스코프가 있어도
9885
+ * 403 `INSUFFICIENT_ROLE`이다(조회 포함). OWNER 여부는 요청 시점의 상점 멤버십으로 다시 확인하므로
9831
9886
  * 양도·강등 직후에도 바로 403이다. 비밀 값(시크릿 키·API Secret·웹훅 시크릿)은 요청으로만 보내고
9832
9887
  * 응답에는 `secrets[].masked`(앞 4자리 마스킹)만 나온다.
9833
9888
  */
@@ -10714,7 +10769,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10714
10769
  payload: string;
10715
10770
  }>;
10716
10771
  };
10717
- /** API 로그 (보관 7일, 콘솔 OWNER/ADMIN) */
10772
+ /** API 로그 (보관 7일, 상점 플랫폼 OWNER/ADMIN) */
10718
10773
  apiLogs: {
10719
10774
  /** 최신순 커서 페이지네이션. 다음 페이지는 응답의 `nextCursor`를 `cursor`로 넘긴다 */
10720
10775
  list: (params?: ApiLogListOptions) => Promise<{
@@ -10746,7 +10801,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10746
10801
  serverErrors: number;
10747
10802
  }>;
10748
10803
  };
10749
- /** 감사 로그 (관리 API 쓰기의 행위자·대상·결과, 콘솔 OWNER/ADMIN, `audit:r`) */
10804
+ /** 감사 로그 (관리 API 쓰기의 행위자·대상·결과, 상점 플랫폼 OWNER/ADMIN, `audit:r`) */
10750
10805
  auditLogs: {
10751
10806
  /** 최신순 커서 페이지네이션. 다음 페이지는 응답의 `nextCursor`를 `cursor`로 넘긴다 */
10752
10807
  list: (params?: AuditLogListOptions) => Promise<{
@@ -10780,14 +10835,14 @@ export declare function createStoreClient(options: StoreClientOptions): {
10780
10835
  }>;
10781
10836
  };
10782
10837
  /**
10783
- * 승인 요청 — 에이전트의 고위험 쓰기가 202로 보류된 건. 목록·승인·거절은 콘솔 OWNER/ADMIN,
10838
+ * 승인 요청 — 에이전트의 고위험 쓰기가 202로 보류된 건. 목록·승인·거절은 상점 플랫폼 OWNER/ADMIN,
10784
10839
  * 단건 조회는 요청한 토큰도 할 수 있다(상태 확인용).
10785
10840
  */
10786
10841
  approvalRequests: {
10787
10842
  list: (params?: ApprovalListOptions) => Promise<{
10788
10843
  items: {
10789
10844
  approvalId: string;
10790
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
10845
+ status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
10791
10846
  operationId: string;
10792
10847
  method: string;
10793
10848
  path: string;
@@ -10837,7 +10892,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10837
10892
  }>;
10838
10893
  get: (approvalId: string) => Promise<{
10839
10894
  approvalId: string;
10840
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
10895
+ status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
10841
10896
  operationId: string;
10842
10897
  method: string;
10843
10898
  path: string;
@@ -10889,7 +10944,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10889
10944
  */
10890
10945
  approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
10891
10946
  approvalId: string;
10892
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
10947
+ status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
10893
10948
  operationId: string;
10894
10949
  method: string;
10895
10950
  path: string;
@@ -10937,7 +10992,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
10937
10992
  }>;
10938
10993
  reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
10939
10994
  approvalId: string;
10940
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
10995
+ status: "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
10941
10996
  operationId: string;
10942
10997
  method: string;
10943
10998
  path: string;
@@ -11034,7 +11089,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11034
11089
  sellerAddresses: {
11035
11090
  list: (type?: AddressType) => Promise<{
11036
11091
  addressId: string;
11037
- type: "RETURN" | "SHIPPING";
11092
+ type: "SHIPPING" | "RETURN";
11038
11093
  name: string;
11039
11094
  isDefault: boolean;
11040
11095
  contactName: string;
@@ -11129,7 +11184,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11129
11184
  }>;
11130
11185
  /**
11131
11186
  * `POST /v1/storefront/site` (201) — 템플릿으로 사이트를 만들고 v1을 발행한다. 공개 상태는 오픈 준비 중이다.
11132
- * 사이트를 만드는 유일한 경로다(스토어를 만들어도 사이트는 생기지 않는다). 템플릿은 여기서만 고른다
11187
+ * 사이트를 만드는 유일한 경로다(상점을 만들어도 사이트는 생기지 않는다). 템플릿은 여기서만 고른다
11133
11188
  */
11134
11189
  create: (body: CreateStorefrontSiteRequest) => Promise<{
11135
11190
  siteId: string;
@@ -11181,7 +11236,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11181
11236
  /** `GET /v1/storefront/site/deployment` — 배포 진행(단계·기록). 만든 뒤 반영이 끝날 때까지 폴링한다 */
11182
11237
  getDeployment: () => Promise<{
11183
11238
  siteId: string;
11184
- status: "IN_PROGRESS" | "SUCCEEDED" | "FAILED";
11239
+ status: "SUCCEEDED" | "FAILED" | "IN_PROGRESS";
11185
11240
  url: string;
11186
11241
  startedAt: string;
11187
11242
  finishedAt: string | null;
@@ -11203,7 +11258,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11203
11258
  /** `POST /v1/storefront/site/deployment/retry` (202) — 밀린 반영을 곧바로 다시 시도한다. 이미 반영됐으면 그대로다 */
11204
11259
  retryDeployment: () => Promise<{
11205
11260
  siteId: string;
11206
- status: "IN_PROGRESS" | "SUCCEEDED" | "FAILED";
11261
+ status: "SUCCEEDED" | "FAILED" | "IN_PROGRESS";
11207
11262
  url: string;
11208
11263
  startedAt: string;
11209
11264
  finishedAt: string | null;
@@ -11484,7 +11539,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11484
11539
  }>;
11485
11540
  /**
11486
11541
  * `POST /v1/storefront/site/preview-link` — 오픈 준비 중인 사이트를 구성원이 볼 수 있는 5분짜리 링크.
11487
- * 콘솔에서 로그인한 OWNER·ADMIN만 받는다
11542
+ * 상점 플랫폼에서 로그인한 OWNER·ADMIN만 받는다
11488
11543
  */
11489
11544
  createPreviewLink: (body?: CreateStorefrontPreviewLinkRequest) => Promise<{
11490
11545
  url: string;
@@ -11499,7 +11554,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11499
11554
  domainId: string;
11500
11555
  hostname: string;
11501
11556
  kind: "PLATFORM" | "CUSTOM";
11502
- status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
11557
+ status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
11503
11558
  isPrimary: boolean;
11504
11559
  dnsRecords: {
11505
11560
  type: "CNAME" | "TXT";
@@ -11507,7 +11562,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11507
11562
  value: string;
11508
11563
  purpose: "ROUTING" | "OWNERSHIP";
11509
11564
  }[];
11510
- certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
11565
+ certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
11511
11566
  failureCode: string | null;
11512
11567
  verifiedAt: string | null;
11513
11568
  activatedAt: string | null;
@@ -11523,7 +11578,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11523
11578
  domainId: string;
11524
11579
  hostname: string;
11525
11580
  kind: "PLATFORM" | "CUSTOM";
11526
- status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
11581
+ status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
11527
11582
  isPrimary: boolean;
11528
11583
  dnsRecords: {
11529
11584
  type: "CNAME" | "TXT";
@@ -11531,7 +11586,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11531
11586
  value: string;
11532
11587
  purpose: "ROUTING" | "OWNERSHIP";
11533
11588
  }[];
11534
- certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
11589
+ certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
11535
11590
  failureCode: string | null;
11536
11591
  verifiedAt: string | null;
11537
11592
  activatedAt: string | null;
@@ -11543,7 +11598,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11543
11598
  domainId: string;
11544
11599
  hostname: string;
11545
11600
  kind: "PLATFORM" | "CUSTOM";
11546
- status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
11601
+ status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
11547
11602
  isPrimary: boolean;
11548
11603
  dnsRecords: {
11549
11604
  type: "CNAME" | "TXT";
@@ -11551,7 +11606,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11551
11606
  value: string;
11552
11607
  purpose: "ROUTING" | "OWNERSHIP";
11553
11608
  }[];
11554
- certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
11609
+ certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
11555
11610
  failureCode: string | null;
11556
11611
  verifiedAt: string | null;
11557
11612
  activatedAt: string | null;
@@ -11567,7 +11622,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11567
11622
  domainId: string;
11568
11623
  hostname: string;
11569
11624
  kind: "PLATFORM" | "CUSTOM";
11570
- status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
11625
+ status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
11571
11626
  isPrimary: boolean;
11572
11627
  dnsRecords: {
11573
11628
  type: "CNAME" | "TXT";
@@ -11575,7 +11630,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11575
11630
  value: string;
11576
11631
  purpose: "ROUTING" | "OWNERSHIP";
11577
11632
  }[];
11578
- certificateStatus: "ACTIVE" | "FAILED" | "PENDING" | null;
11633
+ certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
11579
11634
  failureCode: string | null;
11580
11635
  verifiedAt: string | null;
11581
11636
  activatedAt: string | null;
@@ -11713,7 +11768,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11713
11768
  }>;
11714
11769
  /**
11715
11770
  * `POST /v1/storefront/site/editing/preview-link` — 편집 미리보기(dev 서버) 5분짜리 링크.
11716
- * 콘솔에서 로그인한 OWNER·ADMIN만 받는다(에이전트 불가)
11771
+ * 상점 플랫폼에서 로그인한 OWNER·ADMIN만 받는다(에이전트 불가)
11717
11772
  */
11718
11773
  createEditPreviewLink: (body?: CreateStorefrontEditPreviewLinkRequest) => Promise<{
11719
11774
  url: string;
@@ -11778,7 +11833,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11778
11833
  runCheck: (body: RunStorefrontCheckRequest) => Promise<{
11779
11834
  checkId: string;
11780
11835
  check: string;
11781
- status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
11836
+ status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
11782
11837
  exitCode: number | null;
11783
11838
  durationMs: number | null;
11784
11839
  outputTail: string | null;
@@ -11792,7 +11847,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11792
11847
  getCheck: (checkId: string) => Promise<{
11793
11848
  checkId: string;
11794
11849
  check: string;
11795
- status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
11850
+ status: "FAILED" | "UNKNOWN" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
11796
11851
  exitCode: number | null;
11797
11852
  durationMs: number | null;
11798
11853
  outputTail: string | null;
@@ -12156,14 +12211,14 @@ export declare function createStoreClient(options: StoreClientOptions): {
12156
12211
  subscription: {
12157
12212
  /**
12158
12213
  * `GET /v1/store/subscription` — 스코프 `store:r`. 현재 요금제·상태·사용량 기간·한도·이번 기간 사용량.
12159
- * 결제 수단·청구 금액은 싣지 않는다. 요금제 변경은 셀러 콘솔에서만 한다
12214
+ * 결제 수단·청구 금액은 싣지 않는다. 요금제 변경은 상점 플랫폼에서만 한다
12160
12215
  */
12161
12216
  get: () => Promise<{
12162
12217
  plan: {
12163
12218
  code: string;
12164
12219
  name: string;
12165
12220
  };
12166
- status: "ACTIVE" | "CANCELED" | "PAST_DUE" | "INCOMPLETE";
12221
+ status: "CANCELED" | "ACTIVE" | "PAST_DUE" | "INCOMPLETE";
12167
12222
  interval: "MONTH" | null;
12168
12223
  cancelAtPeriodEnd: boolean;
12169
12224
  period: {
@@ -12265,14 +12320,6 @@ export declare function createStoreClient(options: StoreClientOptions): {
12265
12320
  };
12266
12321
  store: {
12267
12322
  get: () => Promise<{
12268
- storeId: string;
12269
- name: string;
12270
- storeCode: string;
12271
- storefrontUrl: string;
12272
- status: "ACTIVE" | "SUSPENDED" | "CLOSED";
12273
- logoUrl: string | null;
12274
- businessNumber: string | null;
12275
- customerCenterPhone: string | null;
12276
12323
  analyticsAllowedOrigins: string[];
12277
12324
  storefrontOrigins: string[];
12278
12325
  guestCheckoutEnabled: boolean;
@@ -12300,12 +12347,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
12300
12347
  privacyUrl: string | null;
12301
12348
  memberCount: number;
12302
12349
  createdAt: string;
12303
- }>;
12304
- /**
12305
- * `PATCH /v1/store` — 스코프 `store:rw`. 바꿀 필드만 보낸다. `analyticsAllowedOrigins`는 방문 분석 수집을 받을
12306
- * 스토어프론트 오리진 목록이다(빈 배열이면 모든 오리진 허용).
12307
- */
12308
- update: (body: UpdateStoreRequest) => Promise<{
12350
+ businessName: string | null;
12351
+ representativeName: string | null;
12352
+ mailOrderSalesNumber: string | null;
12353
+ businessAddress: string | null;
12354
+ customerCenterEmail: string | null;
12355
+ privacyOfficerName: string | null;
12356
+ privacyOfficerEmail: string | null;
12309
12357
  storeId: string;
12310
12358
  name: string;
12311
12359
  storeCode: string;
@@ -12314,6 +12362,12 @@ export declare function createStoreClient(options: StoreClientOptions): {
12314
12362
  logoUrl: string | null;
12315
12363
  businessNumber: string | null;
12316
12364
  customerCenterPhone: string | null;
12365
+ }>;
12366
+ /**
12367
+ * `PATCH /v1/store` — 스코프 `store:rw`. 바꿀 필드만 보낸다. `analyticsAllowedOrigins`는 방문 분석 수집을 받을
12368
+ * 스토어프론트 오리진 목록이다(빈 배열이면 모든 오리진 허용).
12369
+ */
12370
+ update: (body: UpdateStoreRequest) => Promise<{
12317
12371
  analyticsAllowedOrigins: string[];
12318
12372
  storefrontOrigins: string[];
12319
12373
  guestCheckoutEnabled: boolean;
@@ -12341,6 +12395,21 @@ export declare function createStoreClient(options: StoreClientOptions): {
12341
12395
  privacyUrl: string | null;
12342
12396
  memberCount: number;
12343
12397
  createdAt: string;
12398
+ businessName: string | null;
12399
+ representativeName: string | null;
12400
+ mailOrderSalesNumber: string | null;
12401
+ businessAddress: string | null;
12402
+ customerCenterEmail: string | null;
12403
+ privacyOfficerName: string | null;
12404
+ privacyOfficerEmail: string | null;
12405
+ storeId: string;
12406
+ name: string;
12407
+ storeCode: string;
12408
+ storefrontUrl: string;
12409
+ status: "ACTIVE" | "SUSPENDED" | "CLOSED";
12410
+ logoUrl: string | null;
12411
+ businessNumber: string | null;
12412
+ customerCenterPhone: string | null;
12344
12413
  }>;
12345
12414
  listMembers: () => Promise<{
12346
12415
  userId: string;
@@ -12363,7 +12432,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12363
12432
  invitationId: string;
12364
12433
  email: string;
12365
12434
  role: "ADMIN" | "STAFF";
12366
- status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
12435
+ status: "CANCELED" | "PENDING" | "EXPIRED" | "ACCEPTED";
12367
12436
  invitedBy: string;
12368
12437
  expiresAt: string;
12369
12438
  createdAt: string;
@@ -12375,13 +12444,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
12375
12444
  }[]>;
12376
12445
  /**
12377
12446
  * `POST /v1/store/invitations` (201) — 스코프 `member:rw`. 초대 메일을 보낸다. 발송 결과는 응답의
12378
- * `deliveryStatus`다(발송이 실패해도 초대는 만들어진다). 스토어·초대한 사람·받는 주소별 발송 한도가 있다(429, `details.limit`).
12447
+ * `deliveryStatus`다(발송이 실패해도 초대는 만들어진다). 상점·초대한 사람·받는 주소별 발송 한도가 있다(429, `details.limit`).
12379
12448
  */
12380
12449
  invite: (body: InviteMemberRequest) => Promise<{
12381
12450
  invitationId: string;
12382
12451
  email: string;
12383
12452
  role: "ADMIN" | "STAFF";
12384
- status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
12453
+ status: "CANCELED" | "PENDING" | "EXPIRED" | "ACCEPTED";
12385
12454
  invitedBy: string;
12386
12455
  expiresAt: string;
12387
12456
  createdAt: string;
@@ -12396,7 +12465,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12396
12465
  invitationId: string;
12397
12466
  email: string;
12398
12467
  role: "ADMIN" | "STAFF";
12399
- status: "PENDING" | "EXPIRED" | "ACCEPTED" | "CANCELED";
12468
+ status: "CANCELED" | "PENDING" | "EXPIRED" | "ACCEPTED";
12400
12469
  invitedBy: string;
12401
12470
  expiresAt: string;
12402
12471
  createdAt: string;
@@ -12628,7 +12697,7 @@ export interface PricingInput {
12628
12697
  coupons: readonly PricingCoupon[];
12629
12698
  /** 배송비 견적. 없으면 배송비 0으로 계산하고 배송비 쿠폰은 할인할 금액이 없다 */
12630
12699
  delivery?: PricingDelivery | null;
12631
- /** 이 스토어에서 결제 완료 주문이 없는 회원인가 */
12700
+ /** 이 상점에서 결제 완료 주문이 없는 회원인가 */
12632
12701
  firstOrder: boolean;
12633
12702
  /** 회원 주문인가 */
12634
12703
  isMember: boolean;
@@ -12750,7 +12819,7 @@ export interface CouponSettlementInput {
12750
12819
  coupons: readonly AppliedCouponSnapshot[];
12751
12820
  lines: readonly CouponSettlementLine[];
12752
12821
  settlements: Readonly<Record<string, Partial<CouponSettlementState> | undefined>>;
12753
- /** 스토어 환불 정책 `couponShortfallCharge` */
12822
+ /** 상점 환불 정책 `couponShortfallCharge` */
12754
12823
  shortfallCharge: boolean;
12755
12824
  /** 판매자 귀책(직권취소, 불량·오배송 반품) — 미달분을 청구하지 않는다 */
12756
12825
  sellerFault: boolean;
@@ -12816,7 +12885,7 @@ export declare function proratedPaidRefundBase(item: {
12816
12885
  }, settledQuantity: number, cancelQuantity: number): number;
12817
12886
  //#endregion
12818
12887
  //#region src/schemas/refund-policy.d.ts
12819
- /** 유효 환불 정책 — 스토어 기본 + 상품별 덮어쓰기를 합친 결과 */
12888
+ /** 유효 환불 정책 — 상점 기본 + 상품별 덮어쓰기를 합친 결과 */
12820
12889
  export declare const refundPolicySchema: z.ZodObject<{
12821
12890
  preShipmentDeliveryFeeRefund: z.ZodBoolean;
12822
12891
  returnDeliveryFee: z.ZodNumber;
@@ -12827,14 +12896,14 @@ export declare const refundPolicySchema: z.ZodObject<{
12827
12896
  }, z.core.$strip>;
12828
12897
  export type RefundPolicy = z.infer<typeof refundPolicySchema>;
12829
12898
  /**
12830
- * 스토어가 정하지 않았을 때 서버가 쓰는 값.
12899
+ * 상점이 정하지 않았을 때 서버가 쓰는 값.
12831
12900
  *
12832
12901
  * `as const`가 아니라 `RefundPolicy`로 타입을 좁힌다 — 리터럴 타입이면 `Partial<typeof …>`로 일부만 바꿀 때
12833
12902
  * `true` 자리에 `false`를 넣을 수 없다.
12834
12903
  */
12835
12904
  export declare const REFUND_POLICY_DEFAULTS: RefundPolicy;
12836
12905
  /**
12837
- * 부분 정책 — 스토어 설정 요청과 상품별 덮어쓰기가 쓴다. 준 항목만 바뀐다.
12906
+ * 부분 정책 — 상점 설정 요청과 상품별 덮어쓰기가 쓴다. 준 항목만 바뀐다.
12838
12907
  *
12839
12908
  * `strictObject`라 모르는 키는 400이다. 오타(`returnFee` 등)를 조용히 무시하면 셀러는 저장됐다고
12840
12909
  * 믿는데 정책은 기본값으로 남는다.
@@ -12850,7 +12919,7 @@ export declare const refundPolicyPatchSchema: z.ZodObject<{
12850
12919
  export type RefundPolicyPatch = z.infer<typeof refundPolicyPatchSchema>;
12851
12920
  /**
12852
12921
  * 상품별 덮어쓰기 — 쿠폰 조건 미달 차감(`couponShortfallCharge`)은 주문 단위 규칙이라 상품이 정하지 않는다.
12853
- * 스토어 정책만 읽는다(이슈 #47).
12922
+ * 상점 정책만 읽는다(이슈 #47).
12854
12923
  */
12855
12924
  export declare const productRefundPolicyPatchSchema: z.ZodObject<{
12856
12925
  preShipmentDeliveryFeeRefund: z.ZodOptional<z.ZodBoolean>;
@@ -12861,11 +12930,11 @@ export declare const productRefundPolicyPatchSchema: z.ZodObject<{
12861
12930
  }, z.core.$strict>;
12862
12931
  /** 정책 해석에 쓰는 상품 값 — 상품별 덮어쓰기 */
12863
12932
  export interface RefundPolicyProductInput {
12864
- /** 상품별 덮어쓰기. 없으면 스토어 기본을 그대로 쓴다 */
12933
+ /** 상품별 덮어쓰기. 없으면 상점 기본을 그대로 쓴다 */
12865
12934
  refundPolicy?: RefundPolicyPatch | null;
12866
12935
  }
12867
12936
  /**
12868
- * 유효 정책 해석 — 상품별 덮어쓰기 → 스토어 기본 → `REFUND_POLICY_DEFAULTS` 순이다.
12937
+ * 유효 정책 해석 — 상품별 덮어쓰기 → 상점 기본 → `REFUND_POLICY_DEFAULTS` 순이다.
12869
12938
  *
12870
12939
  * 반품·교환 배송비의 원천은 정책 하나다(이슈 #57 결정 3). 상품의 레거시 반품비·교환비 필드와의 연결은 없앴고,
12871
12940
  * 레거시 값은 마이그레이션이 상품별 정책으로 옮겼다.
@@ -12874,9 +12943,9 @@ export declare function resolveRefundPolicy(storePolicy?: RefundPolicyPatch | nu
12874
12943
  /**
12875
12944
  * 상품의 **덮어쓰기 자체** — 덮어쓰기가 없으면 null.
12876
12945
  *
12877
- * `resolveRefundPolicy`가 합친 결과로는 "상품이 정한 값"과 "스토어 기본을 물려받은 값"을 가를 수 없다.
12878
- * 관리 API 응답의 `refundPolicy`와 콘솔 폼의 덮어쓰기 스위치가 이 함수를 원천으로 쓴다 — 가르지 못하면
12879
- * 스토어 기본을 쓰는 상품을 저장할 때 그 순간의 기본값이 상품에 박힌다.
12946
+ * `resolveRefundPolicy`가 합친 결과로는 "상품이 정한 값"과 "상점 기본을 물려받은 값"을 가를 수 없다.
12947
+ * 관리 API 응답의 `refundPolicy`와 상점 플랫폼 폼의 덮어쓰기 스위치가 이 함수를 원천으로 쓴다 — 가르지 못하면
12948
+ * 상점 기본을 쓰는 상품을 저장할 때 그 순간의 기본값이 상품에 박힌다.
12880
12949
  */
12881
12950
  export declare function productRefundPolicyOverride(product?: RefundPolicyProductInput | null): RefundPolicyPatch | null;
12882
12951
  /** 반품·교환 배송비 키 — 배송이 없는 상품의 정책에는 두지 않는다 */
@@ -12898,10 +12967,10 @@ export declare function proratedRefundBase(totalPrice: number, quantity: number,
12898
12967
  //#endregion
12899
12968
  //#region src/schemas/scope.d.ts
12900
12969
  /**
12901
- * 스토어 스코프 카탈로그 (auth-spec §7) — 형식 `{리소스}:{r|rw}`, rw는 r을 함의한다.
12970
+ * 상점 스코프 카탈로그 (auth-spec §7) — 형식 `{리소스}:{r|rw}`, rw는 r을 함의한다.
12902
12971
  *
12903
12972
  * 관리 API가 요구하는 스코프와 역할별 자동 부여 스코프의 **단일 원천**이다.
12904
- * 서버(apps/api)가 이 상수를 그대로 가져다 역할→스코프를 산출하므로, 콘솔 권한 매트릭스와
12973
+ * 서버(apps/api)가 이 상수를 그대로 가져다 역할→스코프를 산출하므로, 상점 플랫폼 권한 매트릭스와
12905
12974
  * 서버 인가가 갈라지지 않는다.
12906
12975
  */
12907
12976
  export declare const scopeAccessSchema: z.ZodEnum<{
@@ -12949,7 +13018,7 @@ export declare const storeScopeResourceSchema: z.ZodEnum<{
12949
13018
  export declare function isStoreScope(scope: string): boolean;
12950
13019
  /**
12951
13020
  * 역할별 자동 부여 스코프 (auth-spec §7).
12952
- * 계정 토큰으로 스토어를 호출할 때의 스코프는 그 스토어에서의 역할로 이 표에서 결정된다.
13021
+ * 계정 토큰으로 상점을 호출할 때의 스코프는 그 상점에서의 역할로 이 표에서 결정된다.
12953
13022
  */
12954
13023
  export declare const STORE_ROLE_SCOPES: {
12955
13024
  readonly OWNER: readonly ["product:rw", "category:rw", "order:rw", "claim:rw", "inquiry:rw", "review:rw", "settlement:r", "analytics:r", "webhook:rw", "store:rw", "member:rw", "customer:rw", "audit:r", "promotion:rw", "storefront:rw"];
@@ -12958,7 +13027,7 @@ export declare const STORE_ROLE_SCOPES: {
12958
13027
  };
12959
13028
  //#endregion
12960
13029
  //#region src/schemas/shipping-policy.d.ts
12961
- /** 유효 배송비 정책 — 스토어가 정하지 않은 항목은 `SHIPPING_POLICY_DEFAULTS`로 채운 값이다 */
13030
+ /** 유효 배송비 정책 — 상점이 정하지 않은 항목은 `SHIPPING_POLICY_DEFAULTS`로 채운 값이다 */
12962
13031
  export declare const shippingPolicySchema: z.ZodObject<{
12963
13032
  baseDeliveryFee: z.ZodNumber;
12964
13033
  freeThreshold: z.ZodNullable<z.ZodNumber>;
@@ -12967,7 +13036,7 @@ export declare const shippingPolicySchema: z.ZodObject<{
12967
13036
  }, z.core.$strip>;
12968
13037
  export type ShippingPolicy = z.infer<typeof shippingPolicySchema>;
12969
13038
  /**
12970
- * 스토어가 정하지 않았을 때 서버가 쓰는 값.
13039
+ * 상점이 정하지 않았을 때 서버가 쓰는 값.
12971
13040
  *
12972
13041
  * `as const`가 아니라 `ShippingPolicy`로 좁힌다 — 리터럴 타입이면 `Partial<typeof …>`로 일부만 바꿀 때
12973
13042
  * `null` 자리에 숫자를 넣을 수 없다(`REFUND_POLICY_DEFAULTS`와 같은 이유).
@@ -12986,7 +13055,7 @@ export declare const shippingPolicyPatchSchema: z.ZodObject<{
12986
13055
  isolatedSurcharge: z.ZodOptional<z.ZodNumber>;
12987
13056
  }, z.core.$strict>;
12988
13057
  export type ShippingPolicyPatch = z.infer<typeof shippingPolicyPatchSchema>;
12989
- /** 유효 정책 해석 — 스토어가 정한 항목 + `SHIPPING_POLICY_DEFAULTS` */
13058
+ /** 유효 정책 해석 — 상점이 정한 항목 + `SHIPPING_POLICY_DEFAULTS` */
12990
13059
  export declare function resolveShippingPolicy(patch?: ShippingPolicyPatch | null): ShippingPolicy;
12991
13060
  /** 지역 구분 — 우편번호로 판정한다 */
12992
13061
  export declare const remoteAreaSchema: z.ZodEnum<{
@@ -12996,10 +13065,10 @@ export declare const remoteAreaSchema: z.ZodEnum<{
12996
13065
  }>;
12997
13066
  export type RemoteArea = z.infer<typeof remoteAreaSchema>;
12998
13067
  /**
12999
- * 제주·도서산간 우편번호 범위 — **코드 상수다.** 금액은 스토어가 정하고 범위는 플랫폼이 고정한다.
13068
+ * 제주·도서산간 우편번호 범위 — **코드 상수다.** 금액은 상점이 정하고 범위는 플랫폼이 고정한다.
13000
13069
  *
13001
13070
  * 국내 택배사가 공표하는 제주·도서산간 할증 구간을 5자리 우편번호 범위로 옮긴 표다. 셀러마다
13002
- * 범위가 다르면 같은 주소에 다른 금액이 나가고 CS가 셀러 수만큼 갈라진다. 스토어별 범위 편집은
13071
+ * 범위가 다르면 같은 주소에 다른 금액이 나가고 CS가 셀러 수만큼 갈라진다. 상점별 범위 편집은
13003
13072
  * 후속 과제이고, 지금은 이 표가 유일한 원천이다.
13004
13073
  *
13005
13074
  * ## 근거
@@ -13038,7 +13107,7 @@ export type RemoteArea = z.infer<typeof remoteAreaSchema>;
13038
13107
  * 도로명주소·건물관리번호 단위 판정은 후속 과제다.
13039
13108
  *
13040
13109
  * 범위는 **닫힌 구간**(`from` ≤ zip ≤ `to`)이고 겹치지 않는다. 앞에서부터 처음 맞는 항목을 쓴다.
13041
- * 순서는 콘솔 「추가 배송비 지역」 표의 행 순서이기도 하다(`remoteAreaGroups`). 제주를 먼저 두고
13110
+ * 순서는 상점 플랫폼 「추가 배송비 지역」 표의 행 순서이기도 하다(`remoteAreaGroups`). 제주를 먼저 두고
13042
13111
  * 도서산간은 우편번호 오름차순으로 둔다.
13043
13112
  */
13044
13113
  export declare const REMOTE_AREA_ZIP_RANGES: ReadonlyArray<{
@@ -13063,7 +13132,7 @@ export interface DeliveryBundleProduct {
13063
13132
  deliveryType: DeliveryType;
13064
13133
  deliveryFee: number;
13065
13134
  conditionalFreeAmount: number | null;
13066
- /** 출고지 주소 id(`seller_addresses`). null이면 스토어 기본 출고지를 쓰는 상품끼리 한 묶음이다 */
13135
+ /** 출고지 주소 id(`seller_addresses`). null이면 상점 기본 출고지를 쓰는 상품끼리 한 묶음이다 */
13067
13136
  shippingAddressId?: string | null;
13068
13137
  /**
13069
13138
  * 상품 유형 (이슈 #48). 생략·null이면 배송 상품이다. 배송이 필요 없는 유형은 묶음을 만들지 않는다.
@@ -13097,7 +13166,7 @@ export interface DeliveryFeeLine {
13097
13166
  * 기본 배송비를 면제한 근거 — 면제하지 않았으면 null이다.
13098
13167
  *
13099
13168
  * 환불 정산이 근거를 구분해야 한다. 조건부 무료 기준 미달 차감은 **상품별 조건부 무료(`CONDITIONAL`)로
13100
- * 면제된 묶음만** 대상이다. 스토어 전체 무료 기준(`STORE_THRESHOLD`)이나 무료배송 상품(`FREE`)은 셀러가
13169
+ * 면제된 묶음만** 대상이다. 상점 전체 무료 기준(`STORE_THRESHOLD`)이나 무료배송 상품(`FREE`)은 셀러가
13101
13170
  * 배송비를 받지 않기로 한 것이므로, 일부 취소로 기준이 깨져도 구매자에게 배송비를 물리지 않는다.
13102
13171
  *
13103
13172
  * 세 값이 겹치면 `FREE` → `STORE_THRESHOLD` → `CONDITIONAL` 순으로 센 근거를 남긴다.
@@ -13111,7 +13180,7 @@ export type DeliveryFeeWaiver = z.infer<typeof deliveryFeeWaiverSchema>;
13111
13180
  /** 묶음 하나의 견적 */
13112
13181
  export interface DeliveryBundleQuote {
13113
13182
  bundleKey: string;
13114
- /** 이 묶음에 든 상품 id — 스냅샷 검증과 콘솔 안내에 쓴다 */
13183
+ /** 이 묶음에 든 상품 id — 스냅샷 검증과 상점 플랫폼 안내에 쓴다 */
13115
13184
  productIds: string[];
13116
13185
  /** 실제 청구한 기본 배송비 — 무료배송·무료 기준 충족이면 0 */
13117
13186
  fee: number;
@@ -13134,10 +13203,10 @@ export interface DeliveryQuote {
13134
13203
  /** 청구할 배송비 총액 = `baseFee` + `remoteSurcharge` */
13135
13204
  deliveryFee: number;
13136
13205
  remoteArea: RemoteArea;
13137
- /** 스토어 전체 무료 기준(`freeThreshold`) 충족으로 기본 배송비를 면제했는가 */
13206
+ /** 상점 전체 무료 기준(`freeThreshold`) 충족으로 기본 배송비를 면제했는가 */
13138
13207
  freeByThreshold: boolean;
13139
13208
  /**
13140
- * 배송이 필요한 줄의 상품 금액 합 — 스토어 전체 무료 기준의 판정 금액이다(이슈 #48). 비실물 줄은 빠진다.
13209
+ * 배송이 필요한 줄의 상품 금액 합 — 상점 전체 무료 기준의 판정 금액이다(이슈 #48). 비실물 줄은 빠진다.
13141
13210
  * 주문 상품 금액 합(`productAmount`)과 다를 수 있다.
13142
13211
  */
13143
13212
  shippableAmount: number;
@@ -13156,7 +13225,7 @@ export interface DeliveryQuoteInput {
13156
13225
  * 배송비 계산 — **순수 함수다.** 장바구니 요약, 주문서 금액, 결제 시작의 최종 확정,
13157
13226
  * 주문 배송비 스냅샷이 모두 이 한 곳을 쓴다.
13158
13227
  *
13159
- * 순서가 규칙이다. 묶음별 조건부 무료를 먼저 보고, 그다음 스토어 전체 무료 기준으로 기본 배송비를
13228
+ * 순서가 규칙이다. 묶음별 조건부 무료를 먼저 보고, 그다음 상점 전체 무료 기준으로 기본 배송비를
13160
13229
  * 한꺼번에 0으로 만들고, 마지막에 지역 추가 배송비를 묶음마다 더한다. 추가 배송비는 무료 기준에
13161
13230
  * 걸리지 않는다.
13162
13231
  */
@@ -13164,8 +13233,8 @@ export declare function quoteDelivery(input: DeliveryQuoteInput): DeliveryQuote;
13164
13233
  //#endregion
13165
13234
  //#region src/schemas/subscription.d.ts
13166
13235
  /**
13167
- * 요금제·구독 — `GET /v1/store/subscription`(스코프 `store:r`). 구독 단위는 스토어다.
13168
- * 결제 수단·청구 금액은 싣지 않는다. 요금제 변경은 셀러 콘솔에서만 한다.
13236
+ * 요금제·구독 — `GET /v1/store/subscription`(스코프 `store:r`). 구독 단위는 상점이다.
13237
+ * 결제 수단·청구 금액은 싣지 않는다. 요금제 변경은 상점 플랫폼에서만 한다.
13169
13238
  */
13170
13239
  /** 요금제 코드 — 이름(`plan.name`)이 바뀌어도 코드는 바뀌지 않는다. 값은 추가만 한다 */
13171
13240
  export declare const planCodeSchema: z.ZodEnum<{
@@ -13193,8 +13262,8 @@ export declare const responsePlanCodeSchema: z.ZodUnion<readonly [z.ZodEnum<{
13193
13262
  }>, z.ZodString]>;
13194
13263
  export type ResponsePlanCode = PlanCode | (string & {});
13195
13264
  export declare const subscriptionStatusSchema: z.ZodEnum<{
13196
- ACTIVE: "ACTIVE";
13197
13265
  CANCELED: "CANCELED";
13266
+ ACTIVE: "ACTIVE";
13198
13267
  PAST_DUE: "PAST_DUE";
13199
13268
  INCOMPLETE: "INCOMPLETE";
13200
13269
  }>;
@@ -13244,8 +13313,8 @@ export declare const storeSubscriptionSchema: z.ZodObject<{
13244
13313
  name: z.ZodString;
13245
13314
  }, z.core.$strip>;
13246
13315
  status: z.ZodEnum<{
13247
- ACTIVE: "ACTIVE";
13248
13316
  CANCELED: "CANCELED";
13317
+ ACTIVE: "ACTIVE";
13249
13318
  PAST_DUE: "PAST_DUE";
13250
13319
  INCOMPLETE: "INCOMPLETE";
13251
13320
  }>;
@@ -13329,7 +13398,7 @@ export declare const planErrorDetailsSchema: z.ZodObject<{
13329
13398
  }, z.core.$loose>;
13330
13399
  export type PlanErrorDetails = z.infer<typeof planErrorDetailsSchema>;
13331
13400
  /**
13332
- * 요금제 기능 키 값 — 요금제 비교표·콘솔 요금제 화면이 쓴다. 키는 서버 판정의 기능 키와 같다(추가만 한다). 상위 요금제는 하위 요금제
13401
+ * 요금제 기능 키 값 — 요금제 비교표·상점 플랫폼 요금제 화면이 쓴다. 키는 서버 판정의 기능 키와 같다(추가만 한다). 상위 요금제는 하위 요금제
13333
13402
  * 기능을 모두 포함한다
13334
13403
  */
13335
13404
  export declare const planEntitlementsSchema: z.ZodObject<{
@@ -13477,7 +13546,7 @@ export type PublicPlans = z.infer<typeof publicPlansSchema>;
13477
13546
  * 세는 것이다. 그 숫자가 규칙과 안내를 고치는 근거가 된다.
13478
13547
  *
13479
13548
  * **보내지 않는 것**: 파일 경로·소스 코드·위반 상세(`detail`)·토큰·사람 식별자. 규칙 id와 개수뿐이다.
13480
- * 테넌트는 요청 토큰이 정한다(본문에 스토어 id가 없다). 옵트아웃은 클라이언트의 `SAYREN_TELEMETRY=0`이다.
13549
+ * 테넌트는 요청 토큰이 정한다(본문에 상점 id가 없다). 옵트아웃은 클라이언트의 `SAYREN_TELEMETRY=0`이다.
13481
13550
  *
13482
13551
  * 알 수 없는 키는 저장하지 않고 버린다(`.strict()`를 쓰지 않는다) — 새 버전 클라이언트가 필드를
13483
13552
  * 하나 더 실었다고 계측 전체가 400으로 날아가면 그 버전의 숫자가 통째로 빈다.
@@ -13522,14 +13591,14 @@ export type McpToolEvent = z.infer<typeof mcpToolEventSchema>;
13522
13591
  export declare const orderWebhookEventDataSchema: z.ZodObject<{
13523
13592
  orderId: z.ZodString;
13524
13593
  status: z.ZodEnum<{
13525
- PAID: "PAID";
13526
- CANCELED: "CANCELED";
13527
13594
  PAYMENT_WAITING: "PAYMENT_WAITING";
13595
+ PAID: "PAID";
13528
13596
  CONFIRMED: "CONFIRMED";
13529
13597
  DISPATCHED: "DISPATCHED";
13530
13598
  DELIVERING: "DELIVERING";
13531
13599
  DELIVERED: "DELIVERED";
13532
13600
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
13601
+ CANCELED: "CANCELED";
13533
13602
  }>;
13534
13603
  testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
13535
13604
  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -13571,14 +13640,14 @@ export declare const orderFulfilledWebhookEventDataSchema: z.ZodObject<{
13571
13640
  orderId: z.ZodString;
13572
13641
  orderItemId: z.ZodString;
13573
13642
  status: z.ZodEnum<{
13574
- PAID: "PAID";
13575
- CANCELED: "CANCELED";
13576
13643
  PAYMENT_WAITING: "PAYMENT_WAITING";
13644
+ PAID: "PAID";
13577
13645
  CONFIRMED: "CONFIRMED";
13578
13646
  DISPATCHED: "DISPATCHED";
13579
13647
  DELIVERING: "DELIVERING";
13580
13648
  DELIVERED: "DELIVERED";
13581
13649
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
13650
+ CANCELED: "CANCELED";
13582
13651
  }>;
13583
13652
  fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
13584
13653
  type: z.ZodLiteral<"SHIPPING">;
@@ -13610,24 +13679,24 @@ export declare const orderCanceledWebhookEventDataSchema: z.ZodObject<{
13610
13679
  orderId: z.ZodString;
13611
13680
  orderItemId: z.ZodString;
13612
13681
  status: z.ZodEnum<{
13613
- PAID: "PAID";
13614
- CANCELED: "CANCELED";
13615
13682
  PAYMENT_WAITING: "PAYMENT_WAITING";
13683
+ PAID: "PAID";
13616
13684
  CONFIRMED: "CONFIRMED";
13617
13685
  DISPATCHED: "DISPATCHED";
13618
13686
  DELIVERING: "DELIVERING";
13619
13687
  DELIVERED: "DELIVERED";
13620
13688
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
13689
+ CANCELED: "CANCELED";
13621
13690
  }>;
13622
13691
  itemStatus: z.ZodEnum<{
13623
- PAID: "PAID";
13624
- CANCELED: "CANCELED";
13625
13692
  PAYMENT_WAITING: "PAYMENT_WAITING";
13693
+ PAID: "PAID";
13626
13694
  CONFIRMED: "CONFIRMED";
13627
13695
  DISPATCHED: "DISPATCHED";
13628
13696
  DELIVERING: "DELIVERING";
13629
13697
  DELIVERED: "DELIVERED";
13630
13698
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
13699
+ CANCELED: "CANCELED";
13631
13700
  }>;
13632
13701
  reason: z.ZodString;
13633
13702
  quantity: z.ZodNumber;
@@ -13645,12 +13714,12 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
13645
13714
  orderId: z.ZodString;
13646
13715
  orderItemId: z.ZodString;
13647
13716
  claimType: z.ZodEnum<{
13648
- CANCEL: "CANCEL";
13649
13717
  RETURN: "RETURN";
13650
13718
  EXCHANGE: "EXCHANGE";
13719
+ CANCEL: "CANCEL";
13651
13720
  }>;
13652
13721
  status: z.ZodEnum<{
13653
- COMPLETED: "COMPLETED";
13722
+ WITHDRAWN: "WITHDRAWN";
13654
13723
  REJECTED: "REJECTED";
13655
13724
  REQUESTED: "REQUESTED";
13656
13725
  HELD: "HELD";
@@ -13658,7 +13727,7 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
13658
13727
  COLLECTED: "COLLECTED";
13659
13728
  REDELIVERING: "REDELIVERING";
13660
13729
  APPROVED: "APPROVED";
13661
- WITHDRAWN: "WITHDRAWN";
13730
+ COMPLETED: "COMPLETED";
13662
13731
  }>;
13663
13732
  quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
13664
13733
  refundAmount: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
@@ -13698,14 +13767,14 @@ export declare const orderWebhookEventSchema: z.ZodObject<{
13698
13767
  data: z.ZodObject<{
13699
13768
  orderId: z.ZodString;
13700
13769
  status: z.ZodEnum<{
13701
- PAID: "PAID";
13702
- CANCELED: "CANCELED";
13703
13770
  PAYMENT_WAITING: "PAYMENT_WAITING";
13771
+ PAID: "PAID";
13704
13772
  CONFIRMED: "CONFIRMED";
13705
13773
  DISPATCHED: "DISPATCHED";
13706
13774
  DELIVERING: "DELIVERING";
13707
13775
  DELIVERED: "DELIVERED";
13708
13776
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
13777
+ CANCELED: "CANCELED";
13709
13778
  }>;
13710
13779
  testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
13711
13780
  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -13749,14 +13818,14 @@ export declare const orderFulfilledWebhookEventSchema: z.ZodObject<{
13749
13818
  orderId: z.ZodString;
13750
13819
  orderItemId: z.ZodString;
13751
13820
  status: z.ZodEnum<{
13752
- PAID: "PAID";
13753
- CANCELED: "CANCELED";
13754
13821
  PAYMENT_WAITING: "PAYMENT_WAITING";
13822
+ PAID: "PAID";
13755
13823
  CONFIRMED: "CONFIRMED";
13756
13824
  DISPATCHED: "DISPATCHED";
13757
13825
  DELIVERING: "DELIVERING";
13758
13826
  DELIVERED: "DELIVERED";
13759
13827
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
13828
+ CANCELED: "CANCELED";
13760
13829
  }>;
13761
13830
  fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
13762
13831
  type: z.ZodLiteral<"SHIPPING">;
@@ -13789,24 +13858,24 @@ export declare const orderCanceledWebhookEventSchema: z.ZodObject<{
13789
13858
  orderId: z.ZodString;
13790
13859
  orderItemId: z.ZodString;
13791
13860
  status: z.ZodEnum<{
13792
- PAID: "PAID";
13793
- CANCELED: "CANCELED";
13794
13861
  PAYMENT_WAITING: "PAYMENT_WAITING";
13862
+ PAID: "PAID";
13795
13863
  CONFIRMED: "CONFIRMED";
13796
13864
  DISPATCHED: "DISPATCHED";
13797
13865
  DELIVERING: "DELIVERING";
13798
13866
  DELIVERED: "DELIVERED";
13799
13867
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
13868
+ CANCELED: "CANCELED";
13800
13869
  }>;
13801
13870
  itemStatus: z.ZodEnum<{
13802
- PAID: "PAID";
13803
- CANCELED: "CANCELED";
13804
13871
  PAYMENT_WAITING: "PAYMENT_WAITING";
13872
+ PAID: "PAID";
13805
13873
  CONFIRMED: "CONFIRMED";
13806
13874
  DISPATCHED: "DISPATCHED";
13807
13875
  DELIVERING: "DELIVERING";
13808
13876
  DELIVERED: "DELIVERED";
13809
13877
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
13878
+ CANCELED: "CANCELED";
13810
13879
  }>;
13811
13880
  reason: z.ZodString;
13812
13881
  quantity: z.ZodNumber;
@@ -13835,12 +13904,12 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
13835
13904
  orderId: z.ZodString;
13836
13905
  orderItemId: z.ZodString;
13837
13906
  claimType: z.ZodEnum<{
13838
- CANCEL: "CANCEL";
13839
13907
  RETURN: "RETURN";
13840
13908
  EXCHANGE: "EXCHANGE";
13909
+ CANCEL: "CANCEL";
13841
13910
  }>;
13842
13911
  status: z.ZodEnum<{
13843
- COMPLETED: "COMPLETED";
13912
+ WITHDRAWN: "WITHDRAWN";
13844
13913
  REJECTED: "REJECTED";
13845
13914
  REQUESTED: "REQUESTED";
13846
13915
  HELD: "HELD";
@@ -13848,7 +13917,7 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
13848
13917
  COLLECTED: "COLLECTED";
13849
13918
  REDELIVERING: "REDELIVERING";
13850
13919
  APPROVED: "APPROVED";
13851
- WITHDRAWN: "WITHDRAWN";
13920
+ COMPLETED: "COMPLETED";
13852
13921
  }>;
13853
13922
  quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
13854
13923
  refundAmount: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
@@ -13911,14 +13980,14 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
13911
13980
  data: z.ZodObject<{
13912
13981
  orderId: z.ZodString;
13913
13982
  status: z.ZodEnum<{
13914
- PAID: "PAID";
13915
- CANCELED: "CANCELED";
13916
13983
  PAYMENT_WAITING: "PAYMENT_WAITING";
13984
+ PAID: "PAID";
13917
13985
  CONFIRMED: "CONFIRMED";
13918
13986
  DISPATCHED: "DISPATCHED";
13919
13987
  DELIVERING: "DELIVERING";
13920
13988
  DELIVERED: "DELIVERED";
13921
13989
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
13990
+ CANCELED: "CANCELED";
13922
13991
  }>;
13923
13992
  testPayment: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
13924
13993
  couponDiscountAmount: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
@@ -13961,14 +14030,14 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
13961
14030
  orderId: z.ZodString;
13962
14031
  orderItemId: z.ZodString;
13963
14032
  status: z.ZodEnum<{
13964
- PAID: "PAID";
13965
- CANCELED: "CANCELED";
13966
14033
  PAYMENT_WAITING: "PAYMENT_WAITING";
14034
+ PAID: "PAID";
13967
14035
  CONFIRMED: "CONFIRMED";
13968
14036
  DISPATCHED: "DISPATCHED";
13969
14037
  DELIVERING: "DELIVERING";
13970
14038
  DELIVERED: "DELIVERED";
13971
14039
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
14040
+ CANCELED: "CANCELED";
13972
14041
  }>;
13973
14042
  fulfillmentSnapshot: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
13974
14043
  type: z.ZodLiteral<"SHIPPING">;
@@ -14000,24 +14069,24 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
14000
14069
  orderId: z.ZodString;
14001
14070
  orderItemId: z.ZodString;
14002
14071
  status: z.ZodEnum<{
14003
- PAID: "PAID";
14004
- CANCELED: "CANCELED";
14005
14072
  PAYMENT_WAITING: "PAYMENT_WAITING";
14073
+ PAID: "PAID";
14006
14074
  CONFIRMED: "CONFIRMED";
14007
14075
  DISPATCHED: "DISPATCHED";
14008
14076
  DELIVERING: "DELIVERING";
14009
14077
  DELIVERED: "DELIVERED";
14010
14078
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
14079
+ CANCELED: "CANCELED";
14011
14080
  }>;
14012
14081
  itemStatus: z.ZodEnum<{
14013
- PAID: "PAID";
14014
- CANCELED: "CANCELED";
14015
14082
  PAYMENT_WAITING: "PAYMENT_WAITING";
14083
+ PAID: "PAID";
14016
14084
  CONFIRMED: "CONFIRMED";
14017
14085
  DISPATCHED: "DISPATCHED";
14018
14086
  DELIVERING: "DELIVERING";
14019
14087
  DELIVERED: "DELIVERED";
14020
14088
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
14089
+ CANCELED: "CANCELED";
14021
14090
  }>;
14022
14091
  reason: z.ZodString;
14023
14092
  quantity: z.ZodNumber;
@@ -14045,12 +14114,12 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
14045
14114
  orderId: z.ZodString;
14046
14115
  orderItemId: z.ZodString;
14047
14116
  claimType: z.ZodEnum<{
14048
- CANCEL: "CANCEL";
14049
14117
  RETURN: "RETURN";
14050
14118
  EXCHANGE: "EXCHANGE";
14119
+ CANCEL: "CANCEL";
14051
14120
  }>;
14052
14121
  status: z.ZodEnum<{
14053
- COMPLETED: "COMPLETED";
14122
+ WITHDRAWN: "WITHDRAWN";
14054
14123
  REJECTED: "REJECTED";
14055
14124
  REQUESTED: "REQUESTED";
14056
14125
  HELD: "HELD";
@@ -14058,7 +14127,7 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
14058
14127
  COLLECTED: "COLLECTED";
14059
14128
  REDELIVERING: "REDELIVERING";
14060
14129
  APPROVED: "APPROVED";
14061
- WITHDRAWN: "WITHDRAWN";
14130
+ COMPLETED: "COMPLETED";
14062
14131
  }>;
14063
14132
  quantity: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
14064
14133
  refundAmount: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;