@sayren/store-sdk 0.30.12 → 0.30.14

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.
package/dist/index.d.mts CHANGED
@@ -33,8 +33,8 @@ export declare const auditLogSourceSchema: z.ZodEnum<{
33
33
  }>;
34
34
  export type AuditLogSource = z.infer<typeof auditLogSourceSchema>;
35
35
  export declare const auditLogOutcomeSchema: z.ZodEnum<{
36
- SUCCEEDED: "SUCCEEDED";
37
36
  FAILED: "FAILED";
37
+ SUCCEEDED: "SUCCEEDED";
38
38
  PENDING_APPROVAL: "PENDING_APPROVAL";
39
39
  DENIED: "DENIED";
40
40
  DRY_RUN: "DRY_RUN";
@@ -69,8 +69,8 @@ export declare const auditLogSchema: z.ZodObject<{
69
69
  path: z.ZodNullable<z.ZodString>;
70
70
  statusCode: z.ZodNullable<z.ZodNumber>;
71
71
  outcome: z.ZodNullable<z.ZodEnum<{
72
- SUCCEEDED: "SUCCEEDED";
73
72
  FAILED: "FAILED";
73
+ SUCCEEDED: "SUCCEEDED";
74
74
  PENDING_APPROVAL: "PENDING_APPROVAL";
75
75
  DENIED: "DENIED";
76
76
  DRY_RUN: "DRY_RUN";
@@ -102,8 +102,8 @@ export declare const auditLogListQuerySchema: z.ZodObject<{
102
102
  DOMAIN: "DOMAIN";
103
103
  }>>;
104
104
  outcome: z.ZodOptional<z.ZodEnum<{
105
- SUCCEEDED: "SUCCEEDED";
106
105
  FAILED: "FAILED";
106
+ SUCCEEDED: "SUCCEEDED";
107
107
  PENDING_APPROVAL: "PENDING_APPROVAL";
108
108
  DENIED: "DENIED";
109
109
  DRY_RUN: "DRY_RUN";
@@ -149,8 +149,8 @@ export declare const auditLogPageSchema: z.ZodObject<{
149
149
  path: z.ZodNullable<z.ZodString>;
150
150
  statusCode: z.ZodNullable<z.ZodNumber>;
151
151
  outcome: z.ZodNullable<z.ZodEnum<{
152
- SUCCEEDED: "SUCCEEDED";
153
152
  FAILED: "FAILED";
153
+ SUCCEEDED: "SUCCEEDED";
154
154
  PENDING_APPROVAL: "PENDING_APPROVAL";
155
155
  DENIED: "DENIED";
156
156
  DRY_RUN: "DRY_RUN";
@@ -215,11 +215,11 @@ export declare const writeDryRunResultSchema: z.ZodObject<{
215
215
  }, z.core.$strip>;
216
216
  export type WriteDryRunResult = z.infer<typeof writeDryRunResultSchema>;
217
217
  export declare const approvalStatusSchema: z.ZodEnum<{
218
- UNKNOWN: "UNKNOWN";
219
- SUCCEEDED: "SUCCEEDED";
220
- FAILED: "FAILED";
221
218
  PENDING: "PENDING";
219
+ FAILED: "FAILED";
220
+ SUCCEEDED: "SUCCEEDED";
222
221
  EXECUTING: "EXECUTING";
222
+ UNKNOWN: "UNKNOWN";
223
223
  REJECTED: "REJECTED";
224
224
  EXPIRED: "EXPIRED";
225
225
  }>;
@@ -227,11 +227,11 @@ export type ApprovalStatus = z.infer<typeof approvalStatusSchema>;
227
227
  export declare const approvalRequestSchema: z.ZodObject<{
228
228
  approvalId: z.ZodString;
229
229
  status: z.ZodEnum<{
230
- UNKNOWN: "UNKNOWN";
231
- SUCCEEDED: "SUCCEEDED";
232
- FAILED: "FAILED";
233
230
  PENDING: "PENDING";
231
+ FAILED: "FAILED";
232
+ SUCCEEDED: "SUCCEEDED";
234
233
  EXECUTING: "EXECUTING";
234
+ UNKNOWN: "UNKNOWN";
235
235
  REJECTED: "REJECTED";
236
236
  EXPIRED: "EXPIRED";
237
237
  }>;
@@ -291,11 +291,11 @@ export declare const approvalRequestSchema: z.ZodObject<{
291
291
  export type ApprovalRequest = z.infer<typeof approvalRequestSchema>;
292
292
  export declare const approvalListQuerySchema: z.ZodObject<{
293
293
  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<{
294
- UNKNOWN: "UNKNOWN";
295
- SUCCEEDED: "SUCCEEDED";
296
- FAILED: "FAILED";
297
294
  PENDING: "PENDING";
295
+ FAILED: "FAILED";
296
+ SUCCEEDED: "SUCCEEDED";
298
297
  EXECUTING: "EXECUTING";
298
+ UNKNOWN: "UNKNOWN";
299
299
  REJECTED: "REJECTED";
300
300
  EXPIRED: "EXPIRED";
301
301
  }>>>>;
@@ -310,11 +310,11 @@ export declare const approvalPageSchema: z.ZodObject<{
310
310
  items: z.ZodArray<z.ZodObject<{
311
311
  approvalId: z.ZodString;
312
312
  status: z.ZodEnum<{
313
- UNKNOWN: "UNKNOWN";
314
- SUCCEEDED: "SUCCEEDED";
315
- FAILED: "FAILED";
316
313
  PENDING: "PENDING";
314
+ FAILED: "FAILED";
315
+ SUCCEEDED: "SUCCEEDED";
317
316
  EXECUTING: "EXECUTING";
317
+ UNKNOWN: "UNKNOWN";
318
318
  REJECTED: "REJECTED";
319
319
  EXPIRED: "EXPIRED";
320
320
  }>;
@@ -425,6 +425,809 @@ type TokenSource = string | null | undefined | (() => string | null | undefined)
425
425
  type Query = Record<string, string | number | boolean | undefined>;
426
426
  export declare function buildQuery(query?: Query): string;
427
427
  //#endregion
428
+ //#region src/schemas/ai.d.ts
429
+ /**
430
+ * 상점 플랫폼 AI 채팅(이슈 #124) — 대화·메시지·실행과 실행 이벤트 스트림의 계약.
431
+ *
432
+ * 상점 플랫폼 전용이다(`@ConsoleOnly`, 공개 OpenAPI 문서 제외). 메시지를 보내면 api가 실행(run)을 만들어 202로 `streamId`를 돌려주고,
433
+ * 응답은 별도 중계(`streamUrl`, SSE)로 받는다. 실행은 브라우저와 무관하게 서버에서 끝까지 돈다 — 다시 열면 진행 중 실행의 스트림에
434
+ * 처음부터 다시 붙거나(보관 1시간) 확정된 메시지를 읽는다.
435
+ */
436
+ /** 첨부 하나 — 업로드(`POST /v1/uploads`, 목적 `ai-attachment`)가 돌려준 공개 주소 */
437
+ export declare const aiAttachmentSchema: z.ZodObject<{
438
+ url: z.ZodString;
439
+ name: z.ZodString;
440
+ mediaType: z.ZodString;
441
+ }, z.core.$strip>;
442
+ export type AiAttachment = z.infer<typeof aiAttachmentSchema>;
443
+ export declare const AI_MESSAGE_MAX_CHARS = 8000;
444
+ export declare const AI_MESSAGE_MAX_ATTACHMENTS = 5;
445
+ /**
446
+ * 편집 미리보기에서 고른 요소(#65) — 미리보기 안 선택 스크립트가 만든 값이라 사이트 코드가 꾸밀 수 있다. api는 모델에 넘길 때 데이터로
447
+ * 감싼다. `source`는 그 컴포넌트를 **사용한** 위치다(작업 트리 상대 경로). React 개발 정보가 없으면 null이다
448
+ */
449
+ export declare const aiPreviewSelectionSchema: z.ZodObject<{
450
+ component: z.ZodNullable<z.ZodString>;
451
+ source: z.ZodNullable<z.ZodObject<{
452
+ path: z.ZodString;
453
+ line: z.ZodNumber;
454
+ column: z.ZodOptional<z.ZodNumber>;
455
+ }, z.core.$strip>>;
456
+ tag: z.ZodString;
457
+ text: z.ZodString;
458
+ pagePath: z.ZodString;
459
+ }, z.core.$strip>;
460
+ export type AiPreviewSelection = z.infer<typeof aiPreviewSelectionSchema>;
461
+ /** 실행 상태 — 끝난 상태는 `DONE`·`FAILED`·`CANCELLED`다 */
462
+ export declare const aiRunStatusSchema: z.ZodEnum<{
463
+ FAILED: "FAILED";
464
+ CANCEL_REQUESTED: "CANCEL_REQUESTED";
465
+ QUEUED: "QUEUED";
466
+ RUNNING: "RUNNING";
467
+ DONE: "DONE";
468
+ CANCELLED: "CANCELLED";
469
+ }>;
470
+ export type AiRunStatus = z.infer<typeof aiRunStatusSchema>;
471
+ export declare const AI_RUN_ACTIVE_STATUSES: readonly AiRunStatus[];
472
+ /** 진행 중 실행의 스트림 접속 정보. `streamToken`은 이 스트림 하나만 읽는 단기 자격(Bearer)이다 */
473
+ export declare const aiStreamAccessSchema: z.ZodObject<{
474
+ streamId: z.ZodString;
475
+ streamUrl: z.ZodString;
476
+ streamToken: z.ZodString;
477
+ }, z.core.$strip>;
478
+ export type AiStreamAccess = z.infer<typeof aiStreamAccessSchema>;
479
+ export declare const aiRunSchema: z.ZodObject<{
480
+ id: z.ZodString;
481
+ status: z.ZodEnum<{
482
+ FAILED: "FAILED";
483
+ CANCEL_REQUESTED: "CANCEL_REQUESTED";
484
+ QUEUED: "QUEUED";
485
+ RUNNING: "RUNNING";
486
+ DONE: "DONE";
487
+ CANCELLED: "CANCELLED";
488
+ }>;
489
+ errorCode: z.ZodNullable<z.ZodString>;
490
+ createdAt: z.ZodString;
491
+ finishedAt: z.ZodNullable<z.ZodString>;
492
+ }, z.core.$strip>;
493
+ export type AiRun = z.infer<typeof aiRunSchema>;
494
+ /**
495
+ * 화면에 그리는 메시지 조각. 모델 원문(tool_use 블록 등)은 api가 보관하고 화면에는 이 형태만 준다.
496
+ * - `text`: 글
497
+ * - `tool`: 도구 호출 한 번(이름은 사람이 읽는 라벨, 결과 요약·링크)
498
+ * - `choices`: 선택지 버튼(가장 최근 것만 누를 수 있다)
499
+ * - `attachment`: 사용자가 올린 첨부
500
+ * - `approval`: 승인 대기로 남은 쓰기
501
+ */
502
+ export declare const aiMessagePartSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
503
+ type: z.ZodLiteral<"text">;
504
+ text: z.ZodString;
505
+ }, z.core.$strip>, z.ZodObject<{
506
+ type: z.ZodLiteral<"tool">;
507
+ toolCallId: z.ZodString;
508
+ name: z.ZodString;
509
+ label: z.ZodString;
510
+ status: z.ZodEnum<{
511
+ error: "error";
512
+ unknown: "unknown";
513
+ ok: "ok";
514
+ }>;
515
+ summary: z.ZodNullable<z.ZodString>;
516
+ }, z.core.$strip>, z.ZodObject<{
517
+ type: z.ZodLiteral<"choices">;
518
+ question: z.ZodString;
519
+ options: z.ZodArray<z.ZodObject<{
520
+ label: z.ZodString;
521
+ value: z.ZodString;
522
+ }, z.core.$strip>>;
523
+ }, z.core.$strip>, z.ZodObject<{
524
+ type: z.ZodLiteral<"attachment">;
525
+ attachment: z.ZodObject<{
526
+ url: z.ZodString;
527
+ name: z.ZodString;
528
+ mediaType: z.ZodString;
529
+ }, z.core.$strip>;
530
+ }, z.core.$strip>, z.ZodObject<{
531
+ type: z.ZodLiteral<"approval">;
532
+ approvalId: z.ZodString;
533
+ title: z.ZodString;
534
+ }, z.core.$strip>, z.ZodObject<{
535
+ type: z.ZodLiteral<"selection">;
536
+ selection: z.ZodObject<{
537
+ component: z.ZodNullable<z.ZodString>;
538
+ source: z.ZodNullable<z.ZodObject<{
539
+ path: z.ZodString;
540
+ line: z.ZodNumber;
541
+ column: z.ZodOptional<z.ZodNumber>;
542
+ }, z.core.$strip>>;
543
+ tag: z.ZodString;
544
+ text: z.ZodString;
545
+ pagePath: z.ZodString;
546
+ }, z.core.$strip>;
547
+ }, z.core.$strip>], "type">;
548
+ export type AiMessagePart = z.infer<typeof aiMessagePartSchema>;
549
+ export declare const aiMessageSchema: z.ZodObject<{
550
+ id: z.ZodString;
551
+ role: z.ZodEnum<{
552
+ user: "user";
553
+ assistant: "assistant";
554
+ }>;
555
+ parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
556
+ type: z.ZodLiteral<"text">;
557
+ text: z.ZodString;
558
+ }, z.core.$strip>, z.ZodObject<{
559
+ type: z.ZodLiteral<"tool">;
560
+ toolCallId: z.ZodString;
561
+ name: z.ZodString;
562
+ label: z.ZodString;
563
+ status: z.ZodEnum<{
564
+ error: "error";
565
+ unknown: "unknown";
566
+ ok: "ok";
567
+ }>;
568
+ summary: z.ZodNullable<z.ZodString>;
569
+ }, z.core.$strip>, z.ZodObject<{
570
+ type: z.ZodLiteral<"choices">;
571
+ question: z.ZodString;
572
+ options: z.ZodArray<z.ZodObject<{
573
+ label: z.ZodString;
574
+ value: z.ZodString;
575
+ }, z.core.$strip>>;
576
+ }, z.core.$strip>, z.ZodObject<{
577
+ type: z.ZodLiteral<"attachment">;
578
+ attachment: z.ZodObject<{
579
+ url: z.ZodString;
580
+ name: z.ZodString;
581
+ mediaType: z.ZodString;
582
+ }, z.core.$strip>;
583
+ }, z.core.$strip>, z.ZodObject<{
584
+ type: z.ZodLiteral<"approval">;
585
+ approvalId: z.ZodString;
586
+ title: z.ZodString;
587
+ }, z.core.$strip>, z.ZodObject<{
588
+ type: z.ZodLiteral<"selection">;
589
+ selection: z.ZodObject<{
590
+ component: z.ZodNullable<z.ZodString>;
591
+ source: z.ZodNullable<z.ZodObject<{
592
+ path: z.ZodString;
593
+ line: z.ZodNumber;
594
+ column: z.ZodOptional<z.ZodNumber>;
595
+ }, z.core.$strip>>;
596
+ tag: z.ZodString;
597
+ text: z.ZodString;
598
+ pagePath: z.ZodString;
599
+ }, z.core.$strip>;
600
+ }, z.core.$strip>], "type">>;
601
+ runId: z.ZodNullable<z.ZodString>;
602
+ createdAt: z.ZodString;
603
+ }, z.core.$strip>;
604
+ export type AiMessage = z.infer<typeof aiMessageSchema>;
605
+ export declare const aiConversationSummarySchema: z.ZodObject<{
606
+ id: z.ZodString;
607
+ title: z.ZodNullable<z.ZodString>;
608
+ createdAt: z.ZodString;
609
+ updatedAt: z.ZodString;
610
+ }, z.core.$strip>;
611
+ export type AiConversationSummary = z.infer<typeof aiConversationSummarySchema>;
612
+ export declare const aiConversationSchema: z.ZodObject<{
613
+ id: z.ZodString;
614
+ title: z.ZodNullable<z.ZodString>;
615
+ createdAt: z.ZodString;
616
+ updatedAt: z.ZodString;
617
+ messages: z.ZodArray<z.ZodObject<{
618
+ id: z.ZodString;
619
+ role: z.ZodEnum<{
620
+ user: "user";
621
+ assistant: "assistant";
622
+ }>;
623
+ parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
624
+ type: z.ZodLiteral<"text">;
625
+ text: z.ZodString;
626
+ }, z.core.$strip>, z.ZodObject<{
627
+ type: z.ZodLiteral<"tool">;
628
+ toolCallId: z.ZodString;
629
+ name: z.ZodString;
630
+ label: z.ZodString;
631
+ status: z.ZodEnum<{
632
+ error: "error";
633
+ unknown: "unknown";
634
+ ok: "ok";
635
+ }>;
636
+ summary: z.ZodNullable<z.ZodString>;
637
+ }, z.core.$strip>, z.ZodObject<{
638
+ type: z.ZodLiteral<"choices">;
639
+ question: z.ZodString;
640
+ options: z.ZodArray<z.ZodObject<{
641
+ label: z.ZodString;
642
+ value: z.ZodString;
643
+ }, z.core.$strip>>;
644
+ }, z.core.$strip>, z.ZodObject<{
645
+ type: z.ZodLiteral<"attachment">;
646
+ attachment: z.ZodObject<{
647
+ url: z.ZodString;
648
+ name: z.ZodString;
649
+ mediaType: z.ZodString;
650
+ }, z.core.$strip>;
651
+ }, z.core.$strip>, z.ZodObject<{
652
+ type: z.ZodLiteral<"approval">;
653
+ approvalId: z.ZodString;
654
+ title: z.ZodString;
655
+ }, z.core.$strip>, z.ZodObject<{
656
+ type: z.ZodLiteral<"selection">;
657
+ selection: z.ZodObject<{
658
+ component: z.ZodNullable<z.ZodString>;
659
+ source: z.ZodNullable<z.ZodObject<{
660
+ path: z.ZodString;
661
+ line: z.ZodNumber;
662
+ column: z.ZodOptional<z.ZodNumber>;
663
+ }, z.core.$strip>>;
664
+ tag: z.ZodString;
665
+ text: z.ZodString;
666
+ pagePath: z.ZodString;
667
+ }, z.core.$strip>;
668
+ }, z.core.$strip>], "type">>;
669
+ runId: z.ZodNullable<z.ZodString>;
670
+ createdAt: z.ZodString;
671
+ }, z.core.$strip>>;
672
+ activeRun: z.ZodNullable<z.ZodObject<{
673
+ id: z.ZodString;
674
+ status: z.ZodEnum<{
675
+ FAILED: "FAILED";
676
+ CANCEL_REQUESTED: "CANCEL_REQUESTED";
677
+ QUEUED: "QUEUED";
678
+ RUNNING: "RUNNING";
679
+ DONE: "DONE";
680
+ CANCELLED: "CANCELLED";
681
+ }>;
682
+ errorCode: z.ZodNullable<z.ZodString>;
683
+ createdAt: z.ZodString;
684
+ finishedAt: z.ZodNullable<z.ZodString>;
685
+ stream: z.ZodObject<{
686
+ streamId: z.ZodString;
687
+ streamUrl: z.ZodString;
688
+ streamToken: z.ZodString;
689
+ }, z.core.$strip>;
690
+ }, z.core.$strip>>;
691
+ lastRun: z.ZodNullable<z.ZodObject<{
692
+ id: z.ZodString;
693
+ status: z.ZodEnum<{
694
+ FAILED: "FAILED";
695
+ CANCEL_REQUESTED: "CANCEL_REQUESTED";
696
+ QUEUED: "QUEUED";
697
+ RUNNING: "RUNNING";
698
+ DONE: "DONE";
699
+ CANCELLED: "CANCELLED";
700
+ }>;
701
+ errorCode: z.ZodNullable<z.ZodString>;
702
+ createdAt: z.ZodString;
703
+ finishedAt: z.ZodNullable<z.ZodString>;
704
+ }, z.core.$strip>>;
705
+ }, z.core.$strip>;
706
+ export type AiConversation = z.infer<typeof aiConversationSchema>;
707
+ export declare const createAiConversationRequestSchema: z.ZodObject<{
708
+ draftId: z.ZodOptional<z.ZodString>;
709
+ }, z.core.$strip>;
710
+ export type CreateAiConversationRequest = z.infer<typeof createAiConversationRequestSchema>;
711
+ export declare const createAiConversationResponseSchema: z.ZodObject<{
712
+ conversation: z.ZodObject<{
713
+ id: z.ZodString;
714
+ title: z.ZodNullable<z.ZodString>;
715
+ createdAt: z.ZodString;
716
+ updatedAt: z.ZodString;
717
+ }, z.core.$strip>;
718
+ run: z.ZodNullable<z.ZodObject<{
719
+ streamId: z.ZodString;
720
+ streamUrl: z.ZodString;
721
+ streamToken: z.ZodString;
722
+ }, z.core.$strip>>;
723
+ }, z.core.$strip>;
724
+ export type CreateAiConversationResponse = z.infer<typeof createAiConversationResponseSchema>;
725
+ export declare const sendAiMessageRequestSchema: z.ZodObject<{
726
+ text: z.ZodString;
727
+ attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
728
+ url: z.ZodString;
729
+ name: z.ZodString;
730
+ mediaType: z.ZodString;
731
+ }, z.core.$strip>>>;
732
+ choice: z.ZodOptional<z.ZodString>;
733
+ selection: z.ZodOptional<z.ZodObject<{
734
+ component: z.ZodNullable<z.ZodString>;
735
+ source: z.ZodNullable<z.ZodObject<{
736
+ path: z.ZodString;
737
+ line: z.ZodNumber;
738
+ column: z.ZodOptional<z.ZodNumber>;
739
+ }, z.core.$strip>>;
740
+ tag: z.ZodString;
741
+ text: z.ZodString;
742
+ pagePath: z.ZodString;
743
+ }, z.core.$strip>>;
744
+ }, z.core.$strip>;
745
+ export type SendAiMessageRequest = z.input<typeof sendAiMessageRequestSchema>;
746
+ export declare const sendAiMessageResponseSchema: z.ZodObject<{
747
+ streamId: z.ZodString;
748
+ streamUrl: z.ZodString;
749
+ streamToken: z.ZodString;
750
+ messageId: z.ZodString;
751
+ }, z.core.$strip>;
752
+ export type SendAiMessageResponse = z.infer<typeof sendAiMessageResponseSchema>;
753
+ /**
754
+ * AI가 바꾸는 화면 영역 — 쓰기 도구가 시작되면 이벤트에 싣고, 패널이 그 화면으로 옮겨 반영된 데이터를 다시 읽는다(셀러가 AI가 하는 일을 같이 본다).
755
+ * 경로는 상점 플랫폼이 정한다(영역 → 라우트). `id`가 있으면 상세 화면이다
756
+ */
757
+ export declare const aiFocusAreaSchema: z.ZodEnum<{
758
+ shipping: "shipping";
759
+ products: "products";
760
+ addresses: "addresses";
761
+ webhooks: "webhooks";
762
+ categories: "categories";
763
+ collections: "collections";
764
+ option_sets: "option_sets";
765
+ coupons: "coupons";
766
+ points: "points";
767
+ orders: "orders";
768
+ claims: "claims";
769
+ customers: "customers";
770
+ inquiries: "inquiries";
771
+ customer_inquiries: "customer_inquiries";
772
+ store_settings: "store_settings";
773
+ payments: "payments";
774
+ login: "login";
775
+ members: "members";
776
+ order_flows: "order_flows";
777
+ storefront: "storefront";
778
+ }>;
779
+ export type AiFocusArea = z.infer<typeof aiFocusAreaSchema>;
780
+ export declare const aiFocusSchema: z.ZodObject<{
781
+ area: z.ZodEnum<{
782
+ shipping: "shipping";
783
+ products: "products";
784
+ addresses: "addresses";
785
+ webhooks: "webhooks";
786
+ categories: "categories";
787
+ collections: "collections";
788
+ option_sets: "option_sets";
789
+ coupons: "coupons";
790
+ points: "points";
791
+ orders: "orders";
792
+ claims: "claims";
793
+ customers: "customers";
794
+ inquiries: "inquiries";
795
+ customer_inquiries: "customer_inquiries";
796
+ store_settings: "store_settings";
797
+ payments: "payments";
798
+ login: "login";
799
+ members: "members";
800
+ order_flows: "order_flows";
801
+ storefront: "storefront";
802
+ }>;
803
+ id: z.ZodOptional<z.ZodString>;
804
+ }, z.core.$strip>;
805
+ export type AiFocus = z.infer<typeof aiFocusSchema>;
806
+ /** 변경 기록 보관 기간 — 지나면 내용을 비우고 되돌릴 수 없다(410 `AI_RUN_CHANGES_EXPIRED`) */
807
+ export declare const AI_RUN_FILE_CHANGES_RETENTION_DAYS = 7;
808
+ /**
809
+ * 실행 하나의 변경 상태
810
+ * - `APPLIED`: 되돌릴 수 있다(진행 중 실행이 없을 때)
811
+ * - `INCOMPLETE`: 결과를 모르는 쓰기·이전 내용이 너무 큰 경로가 있다(되돌릴 수 없다)
812
+ * - `REVERTING`·`REVERTED`·`REVERT_UNKNOWN`(되돌리기 결과를 모름 — 다시 하지 않는다)·`EXPIRED`
813
+ */
814
+ export declare const aiRunChangesStatusSchema: z.ZodEnum<{
815
+ EXPIRED: "EXPIRED";
816
+ APPLIED: "APPLIED";
817
+ INCOMPLETE: "INCOMPLETE";
818
+ REVERTING: "REVERTING";
819
+ REVERTED: "REVERTED";
820
+ REVERT_UNKNOWN: "REVERT_UNKNOWN";
821
+ }>;
822
+ export type AiRunChangesStatus = z.infer<typeof aiRunChangesStatusSchema>;
823
+ export declare const aiFileChangeKindSchema: z.ZodEnum<{
824
+ created: "created";
825
+ modified: "modified";
826
+ deleted: "deleted";
827
+ }>;
828
+ export type AiFileChangeKind = z.infer<typeof aiFileChangeKindSchema>;
829
+ export declare const aiRunChangesSchema: z.ZodObject<{
830
+ runId: z.ZodString;
831
+ status: z.ZodEnum<{
832
+ EXPIRED: "EXPIRED";
833
+ APPLIED: "APPLIED";
834
+ INCOMPLETE: "INCOMPLETE";
835
+ REVERTING: "REVERTING";
836
+ REVERTED: "REVERTED";
837
+ REVERT_UNKNOWN: "REVERT_UNKNOWN";
838
+ }>;
839
+ files: z.ZodArray<z.ZodObject<{
840
+ path: z.ZodString;
841
+ change: z.ZodEnum<{
842
+ created: "created";
843
+ modified: "modified";
844
+ deleted: "deleted";
845
+ }>;
846
+ }, z.core.$strip>>;
847
+ }, z.core.$strip>;
848
+ export type AiRunChanges = z.infer<typeof aiRunChangesSchema>;
849
+ /** `GET /v1/ai/conversations/{id}/file-changes` — 대화의 실행별 변경(실행 만든 순) */
850
+ export declare const aiConversationFileChangesSchema: z.ZodObject<{
851
+ runs: z.ZodArray<z.ZodObject<{
852
+ runId: z.ZodString;
853
+ status: z.ZodEnum<{
854
+ EXPIRED: "EXPIRED";
855
+ APPLIED: "APPLIED";
856
+ INCOMPLETE: "INCOMPLETE";
857
+ REVERTING: "REVERTING";
858
+ REVERTED: "REVERTED";
859
+ REVERT_UNKNOWN: "REVERT_UNKNOWN";
860
+ }>;
861
+ files: z.ZodArray<z.ZodObject<{
862
+ path: z.ZodString;
863
+ change: z.ZodEnum<{
864
+ created: "created";
865
+ modified: "modified";
866
+ deleted: "deleted";
867
+ }>;
868
+ }, z.core.$strip>>;
869
+ }, z.core.$strip>>;
870
+ }, z.core.$strip>;
871
+ export type AiConversationFileChanges = z.infer<typeof aiConversationFileChangesSchema>;
872
+ /** `GET /v1/ai/runs/{runId}/file-changes` — 변경 보기. 텍스트가 아닌 파일·보관이 끝난 내용은 null이다(diff는 화면이 계산한다) */
873
+ export declare const aiRunFileDiffSchema: z.ZodObject<{
874
+ runId: z.ZodString;
875
+ status: z.ZodEnum<{
876
+ EXPIRED: "EXPIRED";
877
+ APPLIED: "APPLIED";
878
+ INCOMPLETE: "INCOMPLETE";
879
+ REVERTING: "REVERTING";
880
+ REVERTED: "REVERTED";
881
+ REVERT_UNKNOWN: "REVERT_UNKNOWN";
882
+ }>;
883
+ files: z.ZodArray<z.ZodObject<{
884
+ path: z.ZodString;
885
+ change: z.ZodEnum<{
886
+ created: "created";
887
+ modified: "modified";
888
+ deleted: "deleted";
889
+ }>;
890
+ before: z.ZodNullable<z.ZodString>;
891
+ after: z.ZodNullable<z.ZodString>;
892
+ binary: z.ZodBoolean;
893
+ }, z.core.$strip>>;
894
+ }, z.core.$strip>;
895
+ export type AiRunFileDiff = z.infer<typeof aiRunFileDiffSchema>;
896
+ /**
897
+ * `POST /v1/ai/runs/{runId}/revert` — 실행이 바꾼 경로를 그 전 내용으로 한 번에 돌린다. 오류: 409 `AI_RUN_IN_PROGRESS`(대화에 진행 중 실행),
898
+ * 409 `AI_RUN_REVERT_CONFLICT`(`details.conflicts` — 그 뒤 바뀐 경로·결과를 모르는 쓰기), 409 `AI_RUN_ALREADY_REVERTED`,
899
+ * 410 `AI_RUN_CHANGES_EXPIRED`, 404 `AI_RUN_CHANGES_NOT_FOUND`, 502 `AI_RUN_REVERT_UNKNOWN`(결과를 모름 — 다시 하지 않는다)
900
+ */
901
+ export declare const aiRunRevertResultSchema: z.ZodObject<{
902
+ runId: z.ZodString;
903
+ status: z.ZodLiteral<"REVERTED">;
904
+ paths: z.ZodArray<z.ZodString>;
905
+ }, z.core.$strip>;
906
+ export type AiRunRevertResult = z.infer<typeof aiRunRevertResultSchema>;
907
+ /** 409 `AI_RUN_REVERT_CONFLICT`의 `error.details` */
908
+ export declare const aiRunRevertConflictDetailsSchema: z.ZodObject<{
909
+ conflicts: z.ZodArray<z.ZodObject<{
910
+ path: z.ZodString;
911
+ reason: z.ZodEnum<{
912
+ UNKNOWN: "UNKNOWN";
913
+ CHANGED: "CHANGED";
914
+ }>;
915
+ }, z.core.$strip>>;
916
+ }, z.core.$strip>;
917
+ export type AiRunRevertConflictDetails = z.infer<typeof aiRunRevertConflictDetailsSchema>;
918
+ export declare const aiStreamEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
919
+ type: z.ZodLiteral<"delta">;
920
+ messageId: z.ZodString;
921
+ text: z.ZodString;
922
+ }, z.core.$strip>, z.ZodObject<{
923
+ type: z.ZodLiteral<"tool_start">;
924
+ messageId: z.ZodString;
925
+ toolCallId: z.ZodString;
926
+ name: z.ZodString;
927
+ label: z.ZodString;
928
+ focus: z.ZodOptional<z.ZodObject<{
929
+ area: z.ZodEnum<{
930
+ shipping: "shipping";
931
+ products: "products";
932
+ addresses: "addresses";
933
+ webhooks: "webhooks";
934
+ categories: "categories";
935
+ collections: "collections";
936
+ option_sets: "option_sets";
937
+ coupons: "coupons";
938
+ points: "points";
939
+ orders: "orders";
940
+ claims: "claims";
941
+ customers: "customers";
942
+ inquiries: "inquiries";
943
+ customer_inquiries: "customer_inquiries";
944
+ store_settings: "store_settings";
945
+ payments: "payments";
946
+ login: "login";
947
+ members: "members";
948
+ order_flows: "order_flows";
949
+ storefront: "storefront";
950
+ }>;
951
+ id: z.ZodOptional<z.ZodString>;
952
+ }, z.core.$strip>>;
953
+ }, z.core.$strip>, z.ZodObject<{
954
+ type: z.ZodLiteral<"tool_result">;
955
+ messageId: z.ZodString;
956
+ toolCallId: z.ZodString;
957
+ status: z.ZodEnum<{
958
+ error: "error";
959
+ unknown: "unknown";
960
+ ok: "ok";
961
+ }>;
962
+ summary: z.ZodNullable<z.ZodString>;
963
+ }, z.core.$strip>, z.ZodObject<{
964
+ type: z.ZodLiteral<"choices">;
965
+ messageId: z.ZodString;
966
+ question: z.ZodString;
967
+ options: z.ZodArray<z.ZodObject<{
968
+ label: z.ZodString;
969
+ value: z.ZodString;
970
+ }, z.core.$strip>>;
971
+ }, z.core.$strip>, z.ZodObject<{
972
+ type: z.ZodLiteral<"approval">;
973
+ messageId: z.ZodString;
974
+ approvalId: z.ZodString;
975
+ title: z.ZodString;
976
+ }, z.core.$strip>, z.ZodObject<{
977
+ type: z.ZodLiteral<"message">;
978
+ message: z.ZodObject<{
979
+ id: z.ZodString;
980
+ role: z.ZodEnum<{
981
+ user: "user";
982
+ assistant: "assistant";
983
+ }>;
984
+ parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
985
+ type: z.ZodLiteral<"text">;
986
+ text: z.ZodString;
987
+ }, z.core.$strip>, z.ZodObject<{
988
+ type: z.ZodLiteral<"tool">;
989
+ toolCallId: z.ZodString;
990
+ name: z.ZodString;
991
+ label: z.ZodString;
992
+ status: z.ZodEnum<{
993
+ error: "error";
994
+ unknown: "unknown";
995
+ ok: "ok";
996
+ }>;
997
+ summary: z.ZodNullable<z.ZodString>;
998
+ }, z.core.$strip>, z.ZodObject<{
999
+ type: z.ZodLiteral<"choices">;
1000
+ question: z.ZodString;
1001
+ options: z.ZodArray<z.ZodObject<{
1002
+ label: z.ZodString;
1003
+ value: z.ZodString;
1004
+ }, z.core.$strip>>;
1005
+ }, z.core.$strip>, z.ZodObject<{
1006
+ type: z.ZodLiteral<"attachment">;
1007
+ attachment: z.ZodObject<{
1008
+ url: z.ZodString;
1009
+ name: z.ZodString;
1010
+ mediaType: z.ZodString;
1011
+ }, z.core.$strip>;
1012
+ }, z.core.$strip>, z.ZodObject<{
1013
+ type: z.ZodLiteral<"approval">;
1014
+ approvalId: z.ZodString;
1015
+ title: z.ZodString;
1016
+ }, z.core.$strip>, z.ZodObject<{
1017
+ type: z.ZodLiteral<"selection">;
1018
+ selection: z.ZodObject<{
1019
+ component: z.ZodNullable<z.ZodString>;
1020
+ source: z.ZodNullable<z.ZodObject<{
1021
+ path: z.ZodString;
1022
+ line: z.ZodNumber;
1023
+ column: z.ZodOptional<z.ZodNumber>;
1024
+ }, z.core.$strip>>;
1025
+ tag: z.ZodString;
1026
+ text: z.ZodString;
1027
+ pagePath: z.ZodString;
1028
+ }, z.core.$strip>;
1029
+ }, z.core.$strip>], "type">>;
1030
+ runId: z.ZodNullable<z.ZodString>;
1031
+ createdAt: z.ZodString;
1032
+ }, z.core.$strip>;
1033
+ }, z.core.$strip>, z.ZodObject<{
1034
+ type: z.ZodLiteral<"error">;
1035
+ code: z.ZodString;
1036
+ message: z.ZodString;
1037
+ }, z.core.$strip>, z.ZodObject<{
1038
+ type: z.ZodLiteral<"done">;
1039
+ status: z.ZodEnum<{
1040
+ FAILED: "FAILED";
1041
+ CANCEL_REQUESTED: "CANCEL_REQUESTED";
1042
+ QUEUED: "QUEUED";
1043
+ RUNNING: "RUNNING";
1044
+ DONE: "DONE";
1045
+ CANCELLED: "CANCELLED";
1046
+ }>;
1047
+ }, z.core.$strip>], "type">;
1048
+ export type AiStreamEvent = z.infer<typeof aiStreamEventSchema>;
1049
+ /** 중계에 쌓이는 이벤트 한 건 — 실행기 → 중계 `POST /internal/streams/{id}/events` */
1050
+ export declare const aiStreamRecordSchema: z.ZodObject<{
1051
+ seq: z.ZodNumber;
1052
+ event: z.ZodDiscriminatedUnion<[z.ZodObject<{
1053
+ type: z.ZodLiteral<"delta">;
1054
+ messageId: z.ZodString;
1055
+ text: z.ZodString;
1056
+ }, z.core.$strip>, z.ZodObject<{
1057
+ type: z.ZodLiteral<"tool_start">;
1058
+ messageId: z.ZodString;
1059
+ toolCallId: z.ZodString;
1060
+ name: z.ZodString;
1061
+ label: z.ZodString;
1062
+ focus: z.ZodOptional<z.ZodObject<{
1063
+ area: z.ZodEnum<{
1064
+ shipping: "shipping";
1065
+ products: "products";
1066
+ addresses: "addresses";
1067
+ webhooks: "webhooks";
1068
+ categories: "categories";
1069
+ collections: "collections";
1070
+ option_sets: "option_sets";
1071
+ coupons: "coupons";
1072
+ points: "points";
1073
+ orders: "orders";
1074
+ claims: "claims";
1075
+ customers: "customers";
1076
+ inquiries: "inquiries";
1077
+ customer_inquiries: "customer_inquiries";
1078
+ store_settings: "store_settings";
1079
+ payments: "payments";
1080
+ login: "login";
1081
+ members: "members";
1082
+ order_flows: "order_flows";
1083
+ storefront: "storefront";
1084
+ }>;
1085
+ id: z.ZodOptional<z.ZodString>;
1086
+ }, z.core.$strip>>;
1087
+ }, z.core.$strip>, z.ZodObject<{
1088
+ type: z.ZodLiteral<"tool_result">;
1089
+ messageId: z.ZodString;
1090
+ toolCallId: z.ZodString;
1091
+ status: z.ZodEnum<{
1092
+ error: "error";
1093
+ unknown: "unknown";
1094
+ ok: "ok";
1095
+ }>;
1096
+ summary: z.ZodNullable<z.ZodString>;
1097
+ }, z.core.$strip>, z.ZodObject<{
1098
+ type: z.ZodLiteral<"choices">;
1099
+ messageId: z.ZodString;
1100
+ question: z.ZodString;
1101
+ options: z.ZodArray<z.ZodObject<{
1102
+ label: z.ZodString;
1103
+ value: z.ZodString;
1104
+ }, z.core.$strip>>;
1105
+ }, z.core.$strip>, z.ZodObject<{
1106
+ type: z.ZodLiteral<"approval">;
1107
+ messageId: z.ZodString;
1108
+ approvalId: z.ZodString;
1109
+ title: z.ZodString;
1110
+ }, z.core.$strip>, z.ZodObject<{
1111
+ type: z.ZodLiteral<"message">;
1112
+ message: z.ZodObject<{
1113
+ id: z.ZodString;
1114
+ role: z.ZodEnum<{
1115
+ user: "user";
1116
+ assistant: "assistant";
1117
+ }>;
1118
+ parts: z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
1119
+ type: z.ZodLiteral<"text">;
1120
+ text: z.ZodString;
1121
+ }, z.core.$strip>, z.ZodObject<{
1122
+ type: z.ZodLiteral<"tool">;
1123
+ toolCallId: z.ZodString;
1124
+ name: z.ZodString;
1125
+ label: z.ZodString;
1126
+ status: z.ZodEnum<{
1127
+ error: "error";
1128
+ unknown: "unknown";
1129
+ ok: "ok";
1130
+ }>;
1131
+ summary: z.ZodNullable<z.ZodString>;
1132
+ }, z.core.$strip>, z.ZodObject<{
1133
+ type: z.ZodLiteral<"choices">;
1134
+ question: z.ZodString;
1135
+ options: z.ZodArray<z.ZodObject<{
1136
+ label: z.ZodString;
1137
+ value: z.ZodString;
1138
+ }, z.core.$strip>>;
1139
+ }, z.core.$strip>, z.ZodObject<{
1140
+ type: z.ZodLiteral<"attachment">;
1141
+ attachment: z.ZodObject<{
1142
+ url: z.ZodString;
1143
+ name: z.ZodString;
1144
+ mediaType: z.ZodString;
1145
+ }, z.core.$strip>;
1146
+ }, z.core.$strip>, z.ZodObject<{
1147
+ type: z.ZodLiteral<"approval">;
1148
+ approvalId: z.ZodString;
1149
+ title: z.ZodString;
1150
+ }, z.core.$strip>, z.ZodObject<{
1151
+ type: z.ZodLiteral<"selection">;
1152
+ selection: z.ZodObject<{
1153
+ component: z.ZodNullable<z.ZodString>;
1154
+ source: z.ZodNullable<z.ZodObject<{
1155
+ path: z.ZodString;
1156
+ line: z.ZodNumber;
1157
+ column: z.ZodOptional<z.ZodNumber>;
1158
+ }, z.core.$strip>>;
1159
+ tag: z.ZodString;
1160
+ text: z.ZodString;
1161
+ pagePath: z.ZodString;
1162
+ }, z.core.$strip>;
1163
+ }, z.core.$strip>], "type">>;
1164
+ runId: z.ZodNullable<z.ZodString>;
1165
+ createdAt: z.ZodString;
1166
+ }, z.core.$strip>;
1167
+ }, z.core.$strip>, z.ZodObject<{
1168
+ type: z.ZodLiteral<"error">;
1169
+ code: z.ZodString;
1170
+ message: z.ZodString;
1171
+ }, z.core.$strip>, z.ZodObject<{
1172
+ type: z.ZodLiteral<"done">;
1173
+ status: z.ZodEnum<{
1174
+ FAILED: "FAILED";
1175
+ CANCEL_REQUESTED: "CANCEL_REQUESTED";
1176
+ QUEUED: "QUEUED";
1177
+ RUNNING: "RUNNING";
1178
+ DONE: "DONE";
1179
+ CANCELLED: "CANCELLED";
1180
+ }>;
1181
+ }, z.core.$strip>], "type">;
1182
+ }, z.core.$strip>;
1183
+ export type AiStreamRecord = z.infer<typeof aiStreamRecordSchema>;
1184
+ export declare const STORE_DRAFT_MAX_ATTACHMENTS = 5;
1185
+ /** 초안 첨부 하나의 최대 크기(바이트) */
1186
+ export declare const STORE_DRAFT_ATTACHMENT_MAX_BYTES: number;
1187
+ /** 연결하지 않은 초안을 지우기까지 */
1188
+ export declare const STORE_DRAFT_RETENTION_DAYS = 7;
1189
+ export declare const createStoreDraftRequestSchema: z.ZodObject<{
1190
+ text: z.ZodString;
1191
+ attachments: z.ZodDefault<z.ZodArray<z.ZodObject<{
1192
+ filename: z.ZodString;
1193
+ size: z.ZodNumber;
1194
+ }, z.core.$strip>>>;
1195
+ }, z.core.$strip>;
1196
+ export type CreateStoreDraftRequest = z.input<typeof createStoreDraftRequestSchema>;
1197
+ export declare const createStoreDraftResponseSchema: z.ZodObject<{
1198
+ draftId: z.ZodString;
1199
+ uploads: z.ZodArray<z.ZodObject<{
1200
+ uploadUrl: z.ZodString;
1201
+ url: z.ZodString;
1202
+ }, z.core.$strip>>;
1203
+ continueUrl: z.ZodString;
1204
+ }, z.core.$strip>;
1205
+ export type CreateStoreDraftResponse = z.infer<typeof createStoreDraftResponseSchema>;
1206
+ export declare const storeDraftSchema: z.ZodObject<{
1207
+ id: z.ZodString;
1208
+ text: z.ZodString;
1209
+ attachments: z.ZodArray<z.ZodObject<{
1210
+ url: z.ZodString;
1211
+ name: z.ZodString;
1212
+ mediaType: z.ZodString;
1213
+ }, z.core.$strip>>;
1214
+ createdAt: z.ZodString;
1215
+ storeId: z.ZodNullable<z.ZodString>;
1216
+ }, z.core.$strip>;
1217
+ export type StoreDraft = z.infer<typeof storeDraftSchema>;
1218
+ /** 로그인 전 초안 미리보기(`GET /v1/public/store-drafts/{id}`) — 로그인 화면이 「저장한 설명」을 보인다. 첨부는 이름만 */
1219
+ export declare const storeDraftPreviewSchema: z.ZodObject<{
1220
+ id: z.ZodString;
1221
+ text: z.ZodString;
1222
+ attachments: z.ZodArray<z.ZodObject<{
1223
+ name: z.ZodString;
1224
+ mediaType: z.ZodString;
1225
+ }, z.core.$strip>>;
1226
+ expiresAt: z.ZodString;
1227
+ used: z.ZodBoolean;
1228
+ }, z.core.$strip>;
1229
+ export type StoreDraftPreview = z.infer<typeof storeDraftPreviewSchema>;
1230
+ //#endregion
428
1231
  //#region src/schemas/analytics.d.ts
429
1232
  export declare const analyticsRangeQuerySchema: z.ZodObject<{
430
1233
  from: z.ZodString;
@@ -454,11 +1257,11 @@ export declare const analyticsTotalsSchema: z.ZodObject<{
454
1257
  export type AnalyticsTotals = z.infer<typeof analyticsTotalsSchema>;
455
1258
  export declare const analyticsFunnelStepSchema: z.ZodObject<{
456
1259
  step: z.ZodEnum<{
1260
+ PURCHASE: "PURCHASE";
457
1261
  SESSION: "SESSION";
458
1262
  PRODUCT_VIEW: "PRODUCT_VIEW";
459
1263
  ADD_TO_CART: "ADD_TO_CART";
460
1264
  BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
461
- PURCHASE: "PURCHASE";
462
1265
  }>;
463
1266
  sessions: z.ZodNumber;
464
1267
  rateFromPrevious: z.ZodNullable<z.ZodNumber>;
@@ -483,11 +1286,11 @@ export declare const analyticsOverviewSchema: z.ZodObject<{
483
1286
  }, z.core.$strip>;
484
1287
  funnel: z.ZodArray<z.ZodObject<{
485
1288
  step: z.ZodEnum<{
1289
+ PURCHASE: "PURCHASE";
486
1290
  SESSION: "SESSION";
487
1291
  PRODUCT_VIEW: "PRODUCT_VIEW";
488
1292
  ADD_TO_CART: "ADD_TO_CART";
489
1293
  BEGIN_CHECKOUT: "BEGIN_CHECKOUT";
490
- PURCHASE: "PURCHASE";
491
1294
  }>;
492
1295
  sessions: z.ZodNumber;
493
1296
  rateFromPrevious: z.ZodNullable<z.ZodNumber>;
@@ -587,20 +1390,20 @@ export declare const analyticsProductsSchema: z.ZodObject<{
587
1390
  }, z.core.$strip>;
588
1391
  export type AnalyticsProducts = z.infer<typeof analyticsProductsSchema>;
589
1392
  export declare const analyticsChannelSchema: z.ZodEnum<{
1393
+ PAID: "PAID";
590
1394
  DIRECT: "DIRECT";
1395
+ CAMPAIGN: "CAMPAIGN";
1396
+ UNKNOWN: "UNKNOWN";
591
1397
  ORGANIC_SEARCH: "ORGANIC_SEARCH";
592
1398
  SOCIAL: "SOCIAL";
593
- PAID: "PAID";
594
1399
  EMAIL: "EMAIL";
595
- CAMPAIGN: "CAMPAIGN";
596
1400
  REFERRAL: "REFERRAL";
597
- UNKNOWN: "UNKNOWN";
598
1401
  }>;
599
1402
  export type AnalyticsChannel = z.infer<typeof analyticsChannelSchema>;
600
1403
  export declare const analyticsSourceGroupBySchema: z.ZodEnum<{
601
- CAMPAIGN: "CAMPAIGN";
602
1404
  CHANNEL: "CHANNEL";
603
1405
  SOURCE: "SOURCE";
1406
+ CAMPAIGN: "CAMPAIGN";
604
1407
  DEVICE: "DEVICE";
605
1408
  }>;
606
1409
  export type AnalyticsSourceGroupBy = z.infer<typeof analyticsSourceGroupBySchema>;
@@ -612,23 +1415,23 @@ export declare const analyticsSourcesQuerySchema: z.ZodObject<{
612
1415
  false: "false";
613
1416
  }>>;
614
1417
  groupBy: z.ZodOptional<z.ZodEnum<{
615
- CAMPAIGN: "CAMPAIGN";
616
1418
  CHANNEL: "CHANNEL";
617
1419
  SOURCE: "SOURCE";
1420
+ CAMPAIGN: "CAMPAIGN";
618
1421
  DEVICE: "DEVICE";
619
1422
  }>>;
620
1423
  }, z.core.$strip>;
621
1424
  export type AnalyticsSourcesParams = z.infer<typeof analyticsSourcesQuerySchema>;
622
1425
  export declare const analyticsSourceRowSchema: z.ZodObject<{
623
1426
  channel: z.ZodNullable<z.ZodEnum<{
1427
+ PAID: "PAID";
624
1428
  DIRECT: "DIRECT";
1429
+ CAMPAIGN: "CAMPAIGN";
1430
+ UNKNOWN: "UNKNOWN";
625
1431
  ORGANIC_SEARCH: "ORGANIC_SEARCH";
626
1432
  SOCIAL: "SOCIAL";
627
- PAID: "PAID";
628
1433
  EMAIL: "EMAIL";
629
- CAMPAIGN: "CAMPAIGN";
630
1434
  REFERRAL: "REFERRAL";
631
- UNKNOWN: "UNKNOWN";
632
1435
  }>>;
633
1436
  source: z.ZodNullable<z.ZodString>;
634
1437
  medium: z.ZodNullable<z.ZodString>;
@@ -650,21 +1453,21 @@ export declare const analyticsSourceRowSchema: z.ZodObject<{
650
1453
  export type AnalyticsSourceRow = z.infer<typeof analyticsSourceRowSchema>;
651
1454
  export declare const analyticsSourcesSchema: z.ZodObject<{
652
1455
  groupBy: z.ZodEnum<{
653
- CAMPAIGN: "CAMPAIGN";
654
1456
  CHANNEL: "CHANNEL";
655
1457
  SOURCE: "SOURCE";
1458
+ CAMPAIGN: "CAMPAIGN";
656
1459
  DEVICE: "DEVICE";
657
1460
  }>;
658
1461
  rows: z.ZodArray<z.ZodObject<{
659
1462
  channel: z.ZodNullable<z.ZodEnum<{
1463
+ PAID: "PAID";
660
1464
  DIRECT: "DIRECT";
1465
+ CAMPAIGN: "CAMPAIGN";
1466
+ UNKNOWN: "UNKNOWN";
661
1467
  ORGANIC_SEARCH: "ORGANIC_SEARCH";
662
1468
  SOCIAL: "SOCIAL";
663
- PAID: "PAID";
664
1469
  EMAIL: "EMAIL";
665
- CAMPAIGN: "CAMPAIGN";
666
1470
  REFERRAL: "REFERRAL";
667
- UNKNOWN: "UNKNOWN";
668
1471
  }>>;
669
1472
  source: z.ZodNullable<z.ZodString>;
670
1473
  medium: z.ZodNullable<z.ZodString>;
@@ -813,12 +1616,12 @@ export declare const analyticsSearchSchema: z.ZodObject<{
813
1616
  }, z.core.$strip>;
814
1617
  export type AnalyticsSearch = z.infer<typeof analyticsSearchSchema>;
815
1618
  export declare const analyticsCheckoutOutcomeSchema: z.ZodEnum<{
1619
+ OTHER: "OTHER";
816
1620
  COMPLETED: "COMPLETED";
817
1621
  NOT_OPENED: "NOT_OPENED";
818
1622
  USER_CANCELED: "USER_CANCELED";
819
1623
  DECLINED: "DECLINED";
820
1624
  PREPARE_FAILURE: "PREPARE_FAILURE";
821
- OTHER: "OTHER";
822
1625
  IN_PROGRESS: "IN_PROGRESS";
823
1626
  }>;
824
1627
  export type AnalyticsCheckoutOutcome = z.infer<typeof analyticsCheckoutOutcomeSchema>;
@@ -826,12 +1629,12 @@ export declare const analyticsCheckoutSchema: z.ZodObject<{
826
1629
  sessions: z.ZodNumber;
827
1630
  outcomes: z.ZodArray<z.ZodObject<{
828
1631
  outcome: z.ZodEnum<{
1632
+ OTHER: "OTHER";
829
1633
  COMPLETED: "COMPLETED";
830
1634
  NOT_OPENED: "NOT_OPENED";
831
1635
  USER_CANCELED: "USER_CANCELED";
832
1636
  DECLINED: "DECLINED";
833
1637
  PREPARE_FAILURE: "PREPARE_FAILURE";
834
- OTHER: "OTHER";
835
1638
  IN_PROGRESS: "IN_PROGRESS";
836
1639
  }>;
837
1640
  sessions: z.ZodNumber;
@@ -1024,8 +1827,8 @@ export declare function fulfillmentRuleOf(type: string | null | undefined): Fulf
1024
1827
  */
1025
1828
  export declare const FULFILLMENT_METHODS: readonly ["CARRIER", "DIRECT", "PICKUP", "PROVIDED"];
1026
1829
  export declare const fulfillmentMethodSchema: z.ZodEnum<{
1027
- DIRECT: "DIRECT";
1028
1830
  CARRIER: "CARRIER";
1831
+ DIRECT: "DIRECT";
1029
1832
  PICKUP: "PICKUP";
1030
1833
  PROVIDED: "PROVIDED";
1031
1834
  }>;
@@ -1069,8 +1872,8 @@ export declare function requiresCollection(type: string | null | undefined): boo
1069
1872
  export declare const NO_SHIPPING_BUNDLE_KEY = "none";
1070
1873
  /** 배송비 유형 — 무료·유료·조건부 무료 */
1071
1874
  export declare const deliveryTypeSchema: z.ZodEnum<{
1072
- PAID: "PAID";
1073
1875
  FREE: "FREE";
1876
+ PAID: "PAID";
1074
1877
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
1075
1878
  }>;
1076
1879
  export type DeliveryType = z.infer<typeof deliveryTypeSchema>;
@@ -1081,8 +1884,8 @@ export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.
1081
1884
  type: z.ZodLiteral<"SHIPPING">;
1082
1885
  shipping: z.ZodOptional<z.ZodObject<{
1083
1886
  deliveryType: z.ZodDefault<z.ZodEnum<{
1084
- PAID: "PAID";
1085
1887
  FREE: "FREE";
1888
+ PAID: "PAID";
1086
1889
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
1087
1890
  }>>;
1088
1891
  deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -1091,16 +1894,16 @@ export declare const productFulfillmentCreateSchema: z.ZodDiscriminatedUnion<[z.
1091
1894
  returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
1092
1895
  }, z.core.$strict>>;
1093
1896
  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
1094
- DIRECT: "DIRECT";
1095
1897
  CARRIER: "CARRIER";
1898
+ DIRECT: "DIRECT";
1096
1899
  PICKUP: "PICKUP";
1097
1900
  PROVIDED: "PROVIDED";
1098
1901
  }>>>;
1099
1902
  }, z.core.$strict>, z.ZodObject<{
1100
1903
  type: z.ZodLiteral<"MANUAL">;
1101
1904
  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
1102
- DIRECT: "DIRECT";
1103
1905
  CARRIER: "CARRIER";
1906
+ DIRECT: "DIRECT";
1104
1907
  PICKUP: "PICKUP";
1105
1908
  PROVIDED: "PROVIDED";
1106
1909
  }>>>;
@@ -1116,8 +1919,8 @@ export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.
1116
1919
  type: z.ZodLiteral<"SHIPPING">;
1117
1920
  shipping: z.ZodObject<{
1118
1921
  deliveryType: z.ZodEnum<{
1119
- PAID: "PAID";
1120
1922
  FREE: "FREE";
1923
+ PAID: "PAID";
1121
1924
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
1122
1925
  }>;
1123
1926
  deliveryFee: z.ZodNumber;
@@ -1126,16 +1929,16 @@ export declare const productFulfillmentUpdateSchema: z.ZodDiscriminatedUnion<[z.
1126
1929
  returnAddressId: z.ZodNullable<z.ZodString>;
1127
1930
  }, z.core.$strict>;
1128
1931
  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
1129
- DIRECT: "DIRECT";
1130
1932
  CARRIER: "CARRIER";
1933
+ DIRECT: "DIRECT";
1131
1934
  PICKUP: "PICKUP";
1132
1935
  PROVIDED: "PROVIDED";
1133
1936
  }>>>;
1134
1937
  }, z.core.$strict>, z.ZodObject<{
1135
1938
  type: z.ZodLiteral<"MANUAL">;
1136
1939
  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
1137
- DIRECT: "DIRECT";
1138
1940
  CARRIER: "CARRIER";
1941
+ DIRECT: "DIRECT";
1139
1942
  PICKUP: "PICKUP";
1140
1943
  PROVIDED: "PROVIDED";
1141
1944
  }>>>;
@@ -1149,8 +1952,8 @@ export declare const productFulfillmentSchema: z.ZodDiscriminatedUnion<[z.ZodObj
1149
1952
  type: z.ZodLiteral<"SHIPPING">;
1150
1953
  shipping: z.ZodObject<{
1151
1954
  deliveryType: z.ZodEnum<{
1152
- PAID: "PAID";
1153
1955
  FREE: "FREE";
1956
+ PAID: "PAID";
1154
1957
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
1155
1958
  }>;
1156
1959
  deliveryFee: z.ZodNumber;
@@ -1190,8 +1993,8 @@ export declare const productFulfillmentResponseSchema: z.ZodUnion<readonly [z.Zo
1190
1993
  type: z.ZodLiteral<"SHIPPING">;
1191
1994
  shipping: z.ZodObject<{
1192
1995
  deliveryType: z.ZodEnum<{
1193
- PAID: "PAID";
1194
1996
  FREE: "FREE";
1997
+ PAID: "PAID";
1195
1998
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
1196
1999
  }>;
1197
2000
  deliveryFee: z.ZodNumber;
@@ -1476,8 +2279,8 @@ export declare const claimWebhookEventDataSchema: z.ZodObject<{
1476
2279
  CANCEL: "CANCEL";
1477
2280
  }>;
1478
2281
  status: z.ZodEnum<{
1479
- COMPLETED: "COMPLETED";
1480
2282
  REJECTED: "REJECTED";
2283
+ COMPLETED: "COMPLETED";
1481
2284
  REQUESTED: "REQUESTED";
1482
2285
  HELD: "HELD";
1483
2286
  COLLECTING: "COLLECTING";
@@ -1707,8 +2510,8 @@ export declare const claimWebhookEventSchema: z.ZodObject<{
1707
2510
  CANCEL: "CANCEL";
1708
2511
  }>;
1709
2512
  status: z.ZodEnum<{
1710
- COMPLETED: "COMPLETED";
1711
2513
  REJECTED: "REJECTED";
2514
+ COMPLETED: "COMPLETED";
1712
2515
  REQUESTED: "REQUESTED";
1713
2516
  HELD: "HELD";
1714
2517
  COLLECTING: "COLLECTING";
@@ -2018,8 +2821,8 @@ export declare const webhookEventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
2018
2821
  CANCEL: "CANCEL";
2019
2822
  }>;
2020
2823
  status: z.ZodEnum<{
2021
- COMPLETED: "COMPLETED";
2022
2824
  REJECTED: "REJECTED";
2825
+ COMPLETED: "COMPLETED";
2023
2826
  REQUESTED: "REQUESTED";
2024
2827
  HELD: "HELD";
2025
2828
  COLLECTING: "COLLECTING";
@@ -2144,7 +2947,7 @@ export declare function parseWebhookEvent(body: unknown): ParsedWebhookEvent;
2144
2947
  //#endregion
2145
2948
  //#region src/schemas/app-manifest.d.ts
2146
2949
  /**
2147
- * 서드파티 앱 매니페스트 `sayren.app.json` (이슈 #22) — CLI(`sayren app`)·api(빌드 `VERIFY`·버전 판정·동의 화면 자료)·런타임이
2950
+ * 서드파티 앱 매니페스트 `manifest.json` (이슈 #22) — CLI(`sayren app`)·api(빌드 `VERIFY`·버전 판정·동의 화면 자료)·런타임이
2148
2951
  * 같은 원천을 쓴다. 매니페스트는 정적 JSON이고 빌드 없이 읽는다.
2149
2952
  *
2150
2953
  * 기능 하나는 **capability** 하나다(`APP_CAPABILITIES`). capability는 매니페스트 조각·동의 문단·넓어짐 판정(재동의 조건)을 한 곳에 둔다.
@@ -2289,6 +3092,66 @@ export declare const APP_SCHEDULE_INTERVALS: {
2289
3092
  readonly "1d": 1440;
2290
3093
  };
2291
3094
  export type AppScheduleInterval = keyof typeof APP_SCHEDULE_INTERVALS;
3095
+ /** 흐름 알림 이름 — 흐름 알림 채널 `app.<handle>.<이름>`의 마지막 마디(소문자·숫자·하이픈) */
3096
+ export declare const APP_FLOW_NOTIFICATION_PATTERN: RegExp;
3097
+ /** 흐름 사건 이름 — 사건 키 `app.<handle>.<이름>`의 마지막 마디 */
3098
+ export declare const APP_FLOW_EVENT_PATTERN: RegExp;
3099
+ export declare const APP_FLOW_ITEMS_MAX = 20;
3100
+ /** 흐름 알림 매개변수 — 셀러가 편집기에서 식으로 값을 연결한다 */
3101
+ export declare const appFlowParamSchema: z.ZodObject<{
3102
+ type: z.ZodEnum<{
3103
+ string: "string";
3104
+ number: "number";
3105
+ boolean: "boolean";
3106
+ }>;
3107
+ label: z.ZodString;
3108
+ required: z.ZodOptional<z.ZodBoolean>;
3109
+ }, z.core.$strict>;
3110
+ export type AppFlowParam = z.infer<typeof appFlowParamSchema>;
3111
+ export declare const appFlowNotificationSchema: z.ZodObject<{
3112
+ label: z.ZodString;
3113
+ description: z.ZodOptional<z.ZodString>;
3114
+ params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
3115
+ type: z.ZodEnum<{
3116
+ string: "string";
3117
+ number: "number";
3118
+ boolean: "boolean";
3119
+ }>;
3120
+ label: z.ZodString;
3121
+ required: z.ZodOptional<z.ZodBoolean>;
3122
+ }, z.core.$strict>>>;
3123
+ }, z.core.$strict>;
3124
+ export type AppFlowNotification = z.infer<typeof appFlowNotificationSchema>;
3125
+ export declare const appFlowEventSchema: z.ZodObject<{
3126
+ label: z.ZodString;
3127
+ description: z.ZodOptional<z.ZodString>;
3128
+ }, z.core.$strict>;
3129
+ export type AppFlowEvent = z.infer<typeof appFlowEventSchema>;
3130
+ /** 에이전트 도구 이름 — 소문자·숫자·하이픈 */
3131
+ export declare const APP_TOOL_NAME_PATTERN: RegExp;
3132
+ export declare const appToolInputSchema: z.ZodObject<{
3133
+ type: z.ZodEnum<{
3134
+ string: "string";
3135
+ number: "number";
3136
+ boolean: "boolean";
3137
+ }>;
3138
+ description: z.ZodOptional<z.ZodString>;
3139
+ required: z.ZodOptional<z.ZodBoolean>;
3140
+ }, z.core.$strict>;
3141
+ export type AppToolInput = z.infer<typeof appToolInputSchema>;
3142
+ export declare const appToolSchema: z.ZodObject<{
3143
+ description: z.ZodString;
3144
+ input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
3145
+ type: z.ZodEnum<{
3146
+ string: "string";
3147
+ number: "number";
3148
+ boolean: "boolean";
3149
+ }>;
3150
+ description: z.ZodOptional<z.ZodString>;
3151
+ required: z.ZodOptional<z.ZodBoolean>;
3152
+ }, z.core.$strict>>>;
3153
+ }, z.core.$strict>;
3154
+ export type AppTool = z.infer<typeof appToolSchema>;
2292
3155
  /** 앱 목록에 보이는 아이콘·README(#22 앱 목록 시안) — 앱 폴더의 파일을 `sayren app deploy`가 버전과 함께 올린다 */
2293
3156
  export declare const APP_ICON_MAX_BYTES: number;
2294
3157
  export declare const APP_ICON_MIN_PX = 512;
@@ -2305,7 +3168,27 @@ export declare const appManifestSchema: z.ZodObject<{
2305
3168
  supportEmail: z.ZodOptional<z.ZodEmail>;
2306
3169
  icon: z.ZodOptional<z.ZodString>;
2307
3170
  readme: z.ZodOptional<z.ZodString>;
2308
- runtime: z.ZodDefault<z.ZodLiteral<"code">>;
3171
+ runtime: z.ZodDefault<z.ZodEnum<{
3172
+ code: "code";
3173
+ external: "external";
3174
+ }>>;
3175
+ external: z.ZodOptional<z.ZodObject<{
3176
+ url: z.ZodURL;
3177
+ }, z.core.$strict>>;
3178
+ mcp: z.ZodOptional<z.ZodObject<{
3179
+ tools: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
3180
+ description: z.ZodString;
3181
+ input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
3182
+ type: z.ZodEnum<{
3183
+ string: "string";
3184
+ number: "number";
3185
+ boolean: "boolean";
3186
+ }>;
3187
+ description: z.ZodOptional<z.ZodString>;
3188
+ required: z.ZodOptional<z.ZodBoolean>;
3189
+ }, z.core.$strict>>>;
3190
+ }, z.core.$strict>>>;
3191
+ }, z.core.$strict>>;
2309
3192
  scopes: z.ZodDefault<z.ZodArray<z.ZodString>>;
2310
3193
  network: z.ZodDefault<z.ZodObject<{
2311
3194
  hosts: z.ZodArray<z.ZodString>;
@@ -2354,6 +3237,25 @@ export declare const appManifestSchema: z.ZodObject<{
2354
3237
  "1d": "1d";
2355
3238
  }>;
2356
3239
  }, z.core.$strict>>>;
3240
+ flow: z.ZodOptional<z.ZodObject<{
3241
+ notifications: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
3242
+ label: z.ZodString;
3243
+ description: z.ZodOptional<z.ZodString>;
3244
+ params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
3245
+ type: z.ZodEnum<{
3246
+ string: "string";
3247
+ number: "number";
3248
+ boolean: "boolean";
3249
+ }>;
3250
+ label: z.ZodString;
3251
+ required: z.ZodOptional<z.ZodBoolean>;
3252
+ }, z.core.$strict>>>;
3253
+ }, z.core.$strict>>>;
3254
+ events: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
3255
+ label: z.ZodString;
3256
+ description: z.ZodOptional<z.ZodString>;
3257
+ }, z.core.$strict>>>;
3258
+ }, z.core.$strict>>;
2357
3259
  settings: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
2358
3260
  type: z.ZodEnum<{
2359
3261
  string: "string";
@@ -2383,7 +3285,7 @@ export declare const APP_UI_MAX_BYTES: number;
2383
3285
  export declare const APP_UI_MAX_FILES = 2000;
2384
3286
  export interface AppManifestProblem {
2385
3287
  path: string;
2386
- code: "EVENT_SCOPE_MISSING" | "SELECT_OPTIONS_REQUIRED" | "SECRET_FIELD_TYPE" | "DEFAULT_TYPE_MISMATCH" | "DUPLICATE";
3288
+ code: "EVENT_SCOPE_MISSING" | "SELECT_OPTIONS_REQUIRED" | "SECRET_FIELD_TYPE" | "DEFAULT_TYPE_MISMATCH" | "DUPLICATE" | "EXTERNAL_URL_REQUIRED" | "EXTERNAL_NETWORK_HOSTS" | "EXTERNAL_URL_INVALID";
2387
3289
  message: string;
2388
3290
  }
2389
3291
  /** 스키마가 보지 못하는 필드 사이 규칙 — 빌드 `VERIFY`·CLI `app verify`가 같은 결과를 낸다. 비어 있으면 통과 */
@@ -2400,6 +3302,13 @@ export interface AppCapabilities {
2400
3302
  publicHttp?: string[];
2401
3303
  /** 예약 작업 이름 → 간격. 옛 버전 행에는 없다 — 읽을 때 `?? {}` */
2402
3304
  schedules?: Record<string, AppScheduleInterval>;
3305
+ /** 흐름 알림(이름 → 표시 이름·매개변수)·흐름 사건(이름 → 표시 이름). 옛 버전 행에는 없다 — 읽을 때 `?? {}` */
3306
+ flowNotifications?: Record<string, AppFlowNotification>;
3307
+ flowEvents?: Record<string, AppFlowEvent>;
3308
+ /** 외부 런타임의 호출 호스트(동의 화면). 코드 앱·옛 버전 행은 없다 */
3309
+ externalHost?: string | null;
3310
+ /** 에이전트 도구. 옛 버전 행에는 없다 — 읽을 때 `?? {}` */
3311
+ tools?: Record<string, AppTool>;
2403
3312
  /** 필수 설정 키 — 하나라도 비어 있으면 이벤트 함수를 부르지 않는다 */
2404
3313
  requiredSettings: string[];
2405
3314
  secretSettings: string[];
@@ -2410,7 +3319,7 @@ export declare function appCapabilitiesOf(manifest: AppManifest): AppCapabilitie
2410
3319
  * 동의 문단은 accounts 설치 화면·상점 플랫폼 앱 상세·유저 문서가 같은 문장을 쓴다.
2411
3320
  */
2412
3321
  export interface AppCapabilityDefinition {
2413
- key: "scopes" | "network" | "events" | "ui" | "publicHttp" | "schedules";
3322
+ key: "scopes" | "network" | "events" | "ui" | "publicHttp" | "schedules" | "runtime" | "tools";
2414
3323
  /** 동의 화면의 문단 제목 */
2415
3324
  title: string;
2416
3325
  /** 동의 화면에 보일 줄 — 없으면 문단을 그리지 않는다 */
@@ -2426,6 +3335,28 @@ export declare function appScheduleListOf(capabilities: Pick<AppCapabilities, "s
2426
3335
  name: string;
2427
3336
  every: AppScheduleInterval;
2428
3337
  }>;
3338
+ /** 응답용 흐름 알림·사건 목록(이름순) — 옛 버전 행은 빈 목록 */
3339
+ export declare function appFlowSummaryOf(capabilities: Pick<AppCapabilities, "flowNotifications" | "flowEvents">): {
3340
+ flowNotifications: Array<{
3341
+ name: string;
3342
+ label: string;
3343
+ params: Array<{
3344
+ name: string;
3345
+ type: AppFlowParam["type"];
3346
+ label: string;
3347
+ required: boolean;
3348
+ }>;
3349
+ }>;
3350
+ flowEvents: Array<{
3351
+ name: string;
3352
+ label: string;
3353
+ }>;
3354
+ };
3355
+ /** 응답용 도구 목록(이름순) — 옛 버전 행은 빈 목록 */
3356
+ export declare function appToolListOf(capabilities: Pick<AppCapabilities, "tools">): Array<{
3357
+ name: string;
3358
+ description: string;
3359
+ }>;
2429
3360
  /** 예약 간격의 표시 이름 — 동의 화면·상점 플랫폼이 같이 쓴다 */
2430
3361
  export declare function appScheduleIntervalLabel(every: AppScheduleInterval): string;
2431
3362
  /** 재동의가 필요한 capability 키 — 비어 있으면 release가 모든 설치에 곧바로 반영된다 */
@@ -2536,6 +3467,27 @@ export declare const appScheduleSummarySchema: z.ZodObject<{
2536
3467
  }>;
2537
3468
  }, z.core.$strip>;
2538
3469
  export type AppScheduleSummary = z.infer<typeof appScheduleSummarySchema>;
3470
+ /** 흐름 알림·사건(매뉴얼 「주문 흐름에서 앱 쓰기」) — 흐름 편집기가 알림 채널·매개변수와 사건 이름을 고른다 */
3471
+ export declare const appFlowNotificationSummarySchema: z.ZodObject<{
3472
+ name: z.ZodString;
3473
+ label: z.ZodString;
3474
+ params: z.ZodArray<z.ZodObject<{
3475
+ name: z.ZodString;
3476
+ type: z.ZodEnum<{
3477
+ string: "string";
3478
+ number: "number";
3479
+ boolean: "boolean";
3480
+ }>;
3481
+ label: z.ZodString;
3482
+ required: z.ZodBoolean;
3483
+ }, z.core.$strip>>;
3484
+ }, z.core.$strip>;
3485
+ export type AppFlowNotificationSummary = z.infer<typeof appFlowNotificationSummarySchema>;
3486
+ export declare const appFlowEventSummarySchema: z.ZodObject<{
3487
+ name: z.ZodString;
3488
+ label: z.ZodString;
3489
+ }, z.core.$strip>;
3490
+ export type AppFlowEventSummary = z.infer<typeof appFlowEventSummarySchema>;
2539
3491
  export declare const appInstallationSchema: z.ZodObject<{
2540
3492
  installationId: z.ZodString;
2541
3493
  storeId: z.ZodString;
@@ -2611,6 +3563,11 @@ export declare const appInstallationSchema: z.ZodObject<{
2611
3563
  "1d": "1d";
2612
3564
  }>;
2613
3565
  }, z.core.$strip>>>;
3566
+ tools: z.ZodDefault<z.ZodArray<z.ZodObject<{
3567
+ name: z.ZodString;
3568
+ description: z.ZodString;
3569
+ }, z.core.$strip>>>;
3570
+ externalHost: z.ZodDefault<z.ZodNullable<z.ZodString>>;
2614
3571
  }, z.core.$strip>>>;
2615
3572
  grantedScopes: z.ZodArray<z.ZodString>;
2616
3573
  grantedNetworkHosts: z.ZodArray<z.ZodString>;
@@ -2653,6 +3610,29 @@ export declare const appInstallationSchema: z.ZodObject<{
2653
3610
  "1d": "1d";
2654
3611
  }>;
2655
3612
  }, z.core.$strip>>>;
3613
+ tools: z.ZodDefault<z.ZodArray<z.ZodObject<{
3614
+ name: z.ZodString;
3615
+ description: z.ZodString;
3616
+ }, z.core.$strip>>>;
3617
+ externalHost: z.ZodDefault<z.ZodNullable<z.ZodString>>;
3618
+ flowNotifications: z.ZodDefault<z.ZodArray<z.ZodObject<{
3619
+ name: z.ZodString;
3620
+ label: z.ZodString;
3621
+ params: z.ZodArray<z.ZodObject<{
3622
+ name: z.ZodString;
3623
+ type: z.ZodEnum<{
3624
+ string: "string";
3625
+ number: "number";
3626
+ boolean: "boolean";
3627
+ }>;
3628
+ label: z.ZodString;
3629
+ required: z.ZodBoolean;
3630
+ }, z.core.$strip>>;
3631
+ }, z.core.$strip>>>;
3632
+ flowEvents: z.ZodDefault<z.ZodArray<z.ZodObject<{
3633
+ name: z.ZodString;
3634
+ label: z.ZodString;
3635
+ }, z.core.$strip>>>;
2656
3636
  settings: z.ZodObject<{
2657
3637
  fields: z.ZodRecord<z.ZodString, z.ZodObject<{
2658
3638
  type: z.ZodEnum<{
@@ -2689,10 +3669,10 @@ export declare const appInstallationRunSchema: z.ZodObject<{
2689
3669
  deliveryId: z.ZodString;
2690
3670
  eventType: z.ZodString;
2691
3671
  status: z.ZodEnum<{
2692
- FAILED: "FAILED";
2693
3672
  PENDING: "PENDING";
2694
3673
  PENDING_RETRY: "PENDING_RETRY";
2695
3674
  SUCCESS: "SUCCESS";
3675
+ FAILED: "FAILED";
2696
3676
  }>;
2697
3677
  errorCode: z.ZodNullable<z.ZodEnum<{
2698
3678
  TIMEOUT: "TIMEOUT";
@@ -2719,10 +3699,10 @@ export declare const appInstallationActivitySchema: z.ZodObject<{
2719
3699
  deliveryId: z.ZodString;
2720
3700
  eventType: z.ZodString;
2721
3701
  status: z.ZodEnum<{
2722
- FAILED: "FAILED";
2723
3702
  PENDING: "PENDING";
2724
3703
  PENDING_RETRY: "PENDING_RETRY";
2725
3704
  SUCCESS: "SUCCESS";
3705
+ FAILED: "FAILED";
2726
3706
  }>;
2727
3707
  errorCode: z.ZodNullable<z.ZodEnum<{
2728
3708
  TIMEOUT: "TIMEOUT";
@@ -2838,6 +3818,11 @@ export declare const storeAppDetailSchema: z.ZodObject<{
2838
3818
  "1d": "1d";
2839
3819
  }>;
2840
3820
  }, z.core.$strip>>>;
3821
+ tools: z.ZodDefault<z.ZodArray<z.ZodObject<{
3822
+ name: z.ZodString;
3823
+ description: z.ZodString;
3824
+ }, z.core.$strip>>>;
3825
+ externalHost: z.ZodDefault<z.ZodNullable<z.ZodString>>;
2841
3826
  settings: z.ZodRecord<z.ZodString, z.ZodObject<{
2842
3827
  type: z.ZodEnum<{
2843
3828
  string: "string";
@@ -2876,6 +3861,36 @@ export declare const appInstallationSelfSchema: z.ZodObject<{
2876
3861
  installedAt: z.ZodString;
2877
3862
  }, z.core.$strip>;
2878
3863
  export type AppInstallationSelf = z.infer<typeof appInstallationSelfSchema>;
3864
+ /** 에이전트 도구(매뉴얼 「에이전트 도구」) — `GET /v1/apps/tools` 한 줄 */
3865
+ export declare const appToolSummarySchema: z.ZodObject<{
3866
+ installationId: z.ZodString;
3867
+ app: z.ZodObject<{
3868
+ appId: z.ZodString;
3869
+ handle: z.ZodString;
3870
+ name: z.ZodString;
3871
+ }, z.core.$strip>;
3872
+ name: z.ZodString;
3873
+ description: z.ZodString;
3874
+ input: z.ZodArray<z.ZodObject<{
3875
+ name: z.ZodString;
3876
+ type: z.ZodEnum<{
3877
+ string: "string";
3878
+ number: "number";
3879
+ boolean: "boolean";
3880
+ }>;
3881
+ description: z.ZodNullable<z.ZodString>;
3882
+ required: z.ZodBoolean;
3883
+ }, z.core.$strip>>;
3884
+ }, z.core.$strip>;
3885
+ export type AppToolSummary = z.infer<typeof appToolSummarySchema>;
3886
+ export declare const appToolCallSchema: z.ZodObject<{
3887
+ input: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
3888
+ }, z.core.$strip>;
3889
+ export type AppToolCall = z.input<typeof appToolCallSchema>;
3890
+ export declare const appToolResultSchema: z.ZodObject<{
3891
+ result: z.ZodUnknown;
3892
+ }, z.core.$strip>;
3893
+ export type AppToolResult = z.infer<typeof appToolResultSchema>;
2879
3894
  /** 설치 저장소(`ctx.storage`, 매뉴얼 「앱 코드 › 저장소」) — 설치 토큰 전용 */
2880
3895
  export declare const APP_STORAGE_KEY_PATTERN: RegExp;
2881
3896
  export declare const APP_STORAGE_MAX_KEYS = 1000;
@@ -2928,10 +3943,10 @@ export type AppBuildStage = z.infer<typeof appBuildStageSchema>;
2928
3943
  export declare const appBuildSchema: z.ZodObject<{
2929
3944
  buildId: z.ZodString;
2930
3945
  status: z.ZodEnum<{
2931
- SUCCEEDED: "SUCCEEDED";
2932
3946
  FAILED: "FAILED";
2933
- RUNNING: "RUNNING";
3947
+ SUCCEEDED: "SUCCEEDED";
2934
3948
  QUEUED: "QUEUED";
3949
+ RUNNING: "RUNNING";
2935
3950
  TIMED_OUT: "TIMED_OUT";
2936
3951
  }>;
2937
3952
  stages: z.ZodArray<z.ZodObject<{
@@ -2974,10 +3989,10 @@ export declare const appVersionSchema: z.ZodObject<{
2974
3989
  build: z.ZodNullable<z.ZodObject<{
2975
3990
  buildId: z.ZodString;
2976
3991
  status: z.ZodEnum<{
2977
- SUCCEEDED: "SUCCEEDED";
2978
3992
  FAILED: "FAILED";
2979
- RUNNING: "RUNNING";
3993
+ SUCCEEDED: "SUCCEEDED";
2980
3994
  QUEUED: "QUEUED";
3995
+ RUNNING: "RUNNING";
2981
3996
  TIMED_OUT: "TIMED_OUT";
2982
3997
  }>;
2983
3998
  stages: z.ZodArray<z.ZodObject<{
@@ -3125,10 +4140,10 @@ export declare const appReleaseResultSchema: z.ZodObject<{
3125
4140
  build: z.ZodNullable<z.ZodObject<{
3126
4141
  buildId: z.ZodString;
3127
4142
  status: z.ZodEnum<{
3128
- SUCCEEDED: "SUCCEEDED";
3129
4143
  FAILED: "FAILED";
3130
- RUNNING: "RUNNING";
4144
+ SUCCEEDED: "SUCCEEDED";
3131
4145
  QUEUED: "QUEUED";
4146
+ RUNNING: "RUNNING";
3132
4147
  TIMED_OUT: "TIMED_OUT";
3133
4148
  }>;
3134
4149
  stages: z.ZodArray<z.ZodObject<{
@@ -3219,6 +4234,8 @@ export declare const appInvocationSchema: z.ZodObject<{
3219
4234
  versionNumber: z.ZodNullable<z.ZodNumber>;
3220
4235
  kind: z.ZodEnum<{
3221
4236
  event: "event";
4237
+ flow: "flow";
4238
+ tool: "tool";
3222
4239
  http: "http";
3223
4240
  schedule: "schedule";
3224
4241
  }>;
@@ -3570,8 +4587,8 @@ export declare const claimTypeSchema: z.ZodEnum<{
3570
4587
  }>;
3571
4588
  export type ClaimType = z.infer<typeof claimTypeSchema>;
3572
4589
  export declare const claimStatusSchema: z.ZodEnum<{
3573
- COMPLETED: "COMPLETED";
3574
4590
  REJECTED: "REJECTED";
4591
+ COMPLETED: "COMPLETED";
3575
4592
  REQUESTED: "REQUESTED";
3576
4593
  HELD: "HELD";
3577
4594
  COLLECTING: "COLLECTING";
@@ -3615,8 +4632,8 @@ export declare const claimSchema: z.ZodObject<{
3615
4632
  CANCEL: "CANCEL";
3616
4633
  }>;
3617
4634
  status: z.ZodEnum<{
3618
- COMPLETED: "COMPLETED";
3619
4635
  REJECTED: "REJECTED";
4636
+ COMPLETED: "COMPLETED";
3620
4637
  REQUESTED: "REQUESTED";
3621
4638
  HELD: "HELD";
3622
4639
  COLLECTING: "COLLECTING";
@@ -3705,8 +4722,8 @@ export declare const claimDetailSchema: z.ZodObject<{
3705
4722
  CANCEL: "CANCEL";
3706
4723
  }>;
3707
4724
  status: z.ZodEnum<{
3708
- COMPLETED: "COMPLETED";
3709
4725
  REJECTED: "REJECTED";
4726
+ COMPLETED: "COMPLETED";
3710
4727
  REQUESTED: "REQUESTED";
3711
4728
  HELD: "HELD";
3712
4729
  COLLECTING: "COLLECTING";
@@ -3763,8 +4780,8 @@ export declare const claimDetailSchema: z.ZodObject<{
3763
4780
  }, z.core.$strip>>;
3764
4781
  histories: z.ZodOptional<z.ZodArray<z.ZodObject<{
3765
4782
  status: z.ZodEnum<{
3766
- COMPLETED: "COMPLETED";
3767
4783
  REJECTED: "REJECTED";
4784
+ COMPLETED: "COMPLETED";
3768
4785
  REQUESTED: "REQUESTED";
3769
4786
  HELD: "HELD";
3770
4787
  COLLECTING: "COLLECTING";
@@ -4394,8 +5411,8 @@ export declare const flowStateSchema: z.ZodObject<{
4394
5411
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
4395
5412
  }>>;
4396
5413
  claimStatus: z.ZodOptional<z.ZodEnum<{
4397
- COMPLETED: "COMPLETED";
4398
5414
  REJECTED: "REJECTED";
5415
+ COMPLETED: "COMPLETED";
4399
5416
  REQUESTED: "REQUESTED";
4400
5417
  HELD: "HELD";
4401
5418
  COLLECTING: "COLLECTING";
@@ -4443,8 +5460,8 @@ export declare const orderItemFlowSchema: z.ZodObject<{
4443
5460
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
4444
5461
  }>>;
4445
5462
  claimStatus: z.ZodOptional<z.ZodEnum<{
4446
- COMPLETED: "COMPLETED";
4447
5463
  REJECTED: "REJECTED";
5464
+ COMPLETED: "COMPLETED";
4448
5465
  REQUESTED: "REQUESTED";
4449
5466
  HELD: "HELD";
4450
5467
  COLLECTING: "COLLECTING";
@@ -4543,8 +5560,8 @@ export declare const orderItemFlowSchema: z.ZodObject<{
4543
5560
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
4544
5561
  }>>;
4545
5562
  claimStatus: z.ZodOptional<z.ZodEnum<{
4546
- COMPLETED: "COMPLETED";
4547
5563
  REJECTED: "REJECTED";
5564
+ COMPLETED: "COMPLETED";
4548
5565
  REQUESTED: "REQUESTED";
4549
5566
  HELD: "HELD";
4550
5567
  COLLECTING: "COLLECTING";
@@ -4635,8 +5652,8 @@ export declare const flowActionResultSchema: z.ZodObject<{
4635
5652
  PURCHASE_DECIDED: "PURCHASE_DECIDED";
4636
5653
  }>>;
4637
5654
  claimStatus: z.ZodOptional<z.ZodEnum<{
4638
- COMPLETED: "COMPLETED";
4639
5655
  REJECTED: "REJECTED";
5656
+ COMPLETED: "COMPLETED";
4640
5657
  REQUESTED: "REQUESTED";
4641
5658
  HELD: "HELD";
4642
5659
  COLLECTING: "COLLECTING";
@@ -4910,8 +5927,8 @@ export declare const orderFlowActionResultSchema: z.ZodObject<{
4910
5927
  results: z.ZodArray<z.ZodObject<{
4911
5928
  orderItemId: z.ZodString;
4912
5929
  status: z.ZodEnum<{
4913
- COMPLETED: "COMPLETED";
4914
5930
  FAILED: "FAILED";
5931
+ COMPLETED: "COMPLETED";
4915
5932
  SKIPPED: "SKIPPED";
4916
5933
  }>;
4917
5934
  reason: z.ZodOptional<z.ZodString>;
@@ -5650,10 +6667,10 @@ export type CustomerOrder = z.infer<typeof customerOrderSchema>;
5650
6667
  /** `POST /v1/customers/{id}/withdraw` 본문 */
5651
6668
  export declare const withdrawCustomerRequestSchema: z.ZodObject<{
5652
6669
  reason: z.ZodEnum<{
5653
- OTHER: "OTHER";
5654
6670
  BUYER_REQUEST: "BUYER_REQUEST";
5655
6671
  DORMANT: "DORMANT";
5656
6672
  ABUSE: "ABUSE";
6673
+ OTHER: "OTHER";
5657
6674
  }>;
5658
6675
  memo: z.ZodOptional<z.ZodString>;
5659
6676
  }, z.core.$strip>;
@@ -6017,10 +7034,10 @@ export declare const webhookSecretRotatedSchema: z.ZodObject<{
6017
7034
  }, z.core.$strip>;
6018
7035
  export type WebhookSecretRotated = z.infer<typeof webhookSecretRotatedSchema>;
6019
7036
  export declare const webhookDeliveryStatusSchema: z.ZodEnum<{
6020
- FAILED: "FAILED";
6021
7037
  PENDING: "PENDING";
6022
7038
  PENDING_RETRY: "PENDING_RETRY";
6023
7039
  SUCCESS: "SUCCESS";
7040
+ FAILED: "FAILED";
6024
7041
  }>;
6025
7042
  export type WebhookDeliveryStatus = z.infer<typeof webhookDeliveryStatusSchema>;
6026
7043
  export declare const webhookDeliveryErrorCodeSchema: z.ZodEnum<{
@@ -6090,10 +7107,10 @@ export declare const webhookDeliverySchema: z.ZodObject<{
6090
7107
  }>;
6091
7108
  url: z.ZodString;
6092
7109
  status: z.ZodEnum<{
6093
- FAILED: "FAILED";
6094
7110
  PENDING: "PENDING";
6095
7111
  PENDING_RETRY: "PENDING_RETRY";
6096
7112
  SUCCESS: "SUCCESS";
7113
+ FAILED: "FAILED";
6097
7114
  }>;
6098
7115
  responseStatusCode: z.ZodNullable<z.ZodNumber>;
6099
7116
  responseTimeMs: z.ZodNullable<z.ZodNumber>;
@@ -6151,10 +7168,10 @@ export declare const webhookDeliveryDetailSchema: z.ZodObject<{
6151
7168
  }>;
6152
7169
  url: z.ZodString;
6153
7170
  status: z.ZodEnum<{
6154
- FAILED: "FAILED";
6155
7171
  PENDING: "PENDING";
6156
7172
  PENDING_RETRY: "PENDING_RETRY";
6157
7173
  SUCCESS: "SUCCESS";
7174
+ FAILED: "FAILED";
6158
7175
  }>;
6159
7176
  responseStatusCode: z.ZodNullable<z.ZodNumber>;
6160
7177
  responseTimeMs: z.ZodNullable<z.ZodNumber>;
@@ -6195,10 +7212,10 @@ export type WebhookDeliveryDetail = z.infer<typeof webhookDeliveryDetailSchema>;
6195
7212
  /** 전송 기록 조회 쿼리 — `GET /webhooks/{id}/deliveries` */
6196
7213
  export declare const webhookDeliveryListQuerySchema: z.ZodObject<{
6197
7214
  status: z.ZodOptional<z.ZodEnum<{
6198
- FAILED: "FAILED";
6199
7215
  PENDING: "PENDING";
6200
7216
  PENDING_RETRY: "PENDING_RETRY";
6201
7217
  SUCCESS: "SUCCESS";
7218
+ FAILED: "FAILED";
6202
7219
  }>>;
6203
7220
  eventType: z.ZodOptional<z.ZodEnum<{
6204
7221
  "ORDER.PAID": "ORDER.PAID";
@@ -7183,8 +8200,8 @@ export declare const pgEnvironmentSchema: z.ZodEnum<{
7183
8200
  }>;
7184
8201
  export type PgEnvironment = z.infer<typeof pgEnvironmentSchema>;
7185
8202
  export declare const pgVerificationResultSchema: z.ZodEnum<{
7186
- FAILED: "FAILED";
7187
8203
  SUCCESS: "SUCCESS";
8204
+ FAILED: "FAILED";
7188
8205
  }>;
7189
8206
  export type PgVerificationResult = z.infer<typeof pgVerificationResultSchema>;
7190
8207
  /**
@@ -7333,8 +8350,8 @@ export declare const paymentCredentialSetSchema: z.ZodObject<{
7333
8350
  }, z.core.$strip>>;
7334
8351
  lastVerification: z.ZodNullable<z.ZodObject<{
7335
8352
  result: z.ZodEnum<{
7336
- FAILED: "FAILED";
7337
8353
  SUCCESS: "SUCCESS";
8354
+ FAILED: "FAILED";
7338
8355
  }>;
7339
8356
  message: z.ZodNullable<z.ZodString>;
7340
8357
  checkedAt: z.ZodString;
@@ -7443,8 +8460,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
7443
8460
  }, z.core.$strip>>;
7444
8461
  lastVerification: z.ZodNullable<z.ZodObject<{
7445
8462
  result: z.ZodEnum<{
7446
- FAILED: "FAILED";
7447
8463
  SUCCESS: "SUCCESS";
8464
+ FAILED: "FAILED";
7448
8465
  }>;
7449
8466
  message: z.ZodNullable<z.ZodString>;
7450
8467
  checkedAt: z.ZodString;
@@ -7480,8 +8497,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
7480
8497
  }, z.core.$strip>>;
7481
8498
  lastVerification: z.ZodNullable<z.ZodObject<{
7482
8499
  result: z.ZodEnum<{
7483
- FAILED: "FAILED";
7484
8500
  SUCCESS: "SUCCESS";
8501
+ FAILED: "FAILED";
7485
8502
  }>;
7486
8503
  message: z.ZodNullable<z.ZodString>;
7487
8504
  checkedAt: z.ZodString;
@@ -7516,8 +8533,8 @@ export declare const paymentProviderSchema: z.ZodObject<{
7516
8533
  }, z.core.$strip>>;
7517
8534
  lastVerification: z.ZodNullable<z.ZodObject<{
7518
8535
  result: z.ZodEnum<{
7519
- FAILED: "FAILED";
7520
8536
  SUCCESS: "SUCCESS";
8537
+ FAILED: "FAILED";
7521
8538
  }>;
7522
8539
  message: z.ZodNullable<z.ZodString>;
7523
8540
  checkedAt: z.ZodString;
@@ -7609,8 +8626,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
7609
8626
  }, z.core.$strip>>;
7610
8627
  lastVerification: z.ZodNullable<z.ZodObject<{
7611
8628
  result: z.ZodEnum<{
7612
- FAILED: "FAILED";
7613
8629
  SUCCESS: "SUCCESS";
8630
+ FAILED: "FAILED";
7614
8631
  }>;
7615
8632
  message: z.ZodNullable<z.ZodString>;
7616
8633
  checkedAt: z.ZodString;
@@ -7646,8 +8663,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
7646
8663
  }, z.core.$strip>>;
7647
8664
  lastVerification: z.ZodNullable<z.ZodObject<{
7648
8665
  result: z.ZodEnum<{
7649
- FAILED: "FAILED";
7650
8666
  SUCCESS: "SUCCESS";
8667
+ FAILED: "FAILED";
7651
8668
  }>;
7652
8669
  message: z.ZodNullable<z.ZodString>;
7653
8670
  checkedAt: z.ZodString;
@@ -7682,8 +8699,8 @@ export declare const paymentSettingsSchema: z.ZodObject<{
7682
8699
  }, z.core.$strip>>;
7683
8700
  lastVerification: z.ZodNullable<z.ZodObject<{
7684
8701
  result: z.ZodEnum<{
7685
- FAILED: "FAILED";
7686
8702
  SUCCESS: "SUCCESS";
8703
+ FAILED: "FAILED";
7687
8704
  }>;
7688
8705
  message: z.ZodNullable<z.ZodString>;
7689
8706
  checkedAt: z.ZodString;
@@ -7741,8 +8758,8 @@ export declare const paymentProviderVerificationSchema: z.ZodObject<{
7741
8758
  LIVE: "LIVE";
7742
8759
  }>;
7743
8760
  result: z.ZodEnum<{
7744
- FAILED: "FAILED";
7745
8761
  SUCCESS: "SUCCESS";
8762
+ FAILED: "FAILED";
7746
8763
  }>;
7747
8764
  message: z.ZodNullable<z.ZodString>;
7748
8765
  checkedAt: z.ZodString;
@@ -7872,8 +8889,8 @@ export type SalesReport = z.infer<typeof salesReportSchema>;
7872
8889
  * - `FAILED`: 승인되지 않고 끝났다(거절·준비 장애·구매자 취소·만료)
7873
8890
  */
7874
8891
  export declare const paymentRecordStatusSchema: z.ZodEnum<{
7875
- FAILED: "FAILED";
7876
8892
  PENDING: "PENDING";
8893
+ FAILED: "FAILED";
7877
8894
  APPROVED: "APPROVED";
7878
8895
  PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
7879
8896
  REFUNDED: "REFUNDED";
@@ -7920,8 +8937,8 @@ export declare const paymentRecordSchema: z.ZodObject<{
7920
8937
  orderName: z.ZodString;
7921
8938
  customerName: z.ZodString;
7922
8939
  status: z.ZodEnum<{
7923
- FAILED: "FAILED";
7924
8940
  PENDING: "PENDING";
8941
+ FAILED: "FAILED";
7925
8942
  APPROVED: "APPROVED";
7926
8943
  PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
7927
8944
  REFUNDED: "REFUNDED";
@@ -7968,8 +8985,8 @@ export declare const paymentRecordPageSchema: z.ZodObject<{
7968
8985
  orderName: z.ZodString;
7969
8986
  customerName: z.ZodString;
7970
8987
  status: z.ZodEnum<{
7971
- FAILED: "FAILED";
7972
8988
  PENDING: "PENDING";
8989
+ FAILED: "FAILED";
7973
8990
  APPROVED: "APPROVED";
7974
8991
  PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
7975
8992
  REFUNDED: "REFUNDED";
@@ -8061,8 +9078,8 @@ export declare const paymentRecordDetailSchema: z.ZodObject<{
8061
9078
  orderName: z.ZodString;
8062
9079
  customerName: z.ZodString;
8063
9080
  status: z.ZodEnum<{
8064
- FAILED: "FAILED";
8065
9081
  PENDING: "PENDING";
9082
+ FAILED: "FAILED";
8066
9083
  APPROVED: "APPROVED";
8067
9084
  PARTIALLY_REFUNDED: "PARTIALLY_REFUNDED";
8068
9085
  REFUNDED: "REFUNDED";
@@ -8391,11 +9408,11 @@ export type PointEntry = z.infer<typeof pointEntrySchema>;
8391
9408
  export declare const pointLotSchema: z.ZodObject<{
8392
9409
  lotId: z.ZodString;
8393
9410
  source: z.ZodUnion<readonly [z.ZodEnum<{
8394
- PURCHASE: "PURCHASE";
8395
9411
  REFUND_RESTORE: "REFUND_RESTORE";
8396
9412
  ADJUST: "ADJUST";
8397
9413
  OPENING: "OPENING";
8398
9414
  REVIEW: "REVIEW";
9415
+ PURCHASE: "PURCHASE";
8399
9416
  }>, z.ZodString]>;
8400
9417
  amount: z.ZodNumber;
8401
9418
  remaining: z.ZodNumber;
@@ -8410,11 +9427,11 @@ export declare const customerPointsSchema: z.ZodObject<{
8410
9427
  lots: z.ZodArray<z.ZodObject<{
8411
9428
  lotId: z.ZodString;
8412
9429
  source: z.ZodUnion<readonly [z.ZodEnum<{
8413
- PURCHASE: "PURCHASE";
8414
9430
  REFUND_RESTORE: "REFUND_RESTORE";
8415
9431
  ADJUST: "ADJUST";
8416
9432
  OPENING: "OPENING";
8417
9433
  REVIEW: "REVIEW";
9434
+ PURCHASE: "PURCHASE";
8418
9435
  }>, z.ZodString]>;
8419
9436
  amount: z.ZodNumber;
8420
9437
  remaining: z.ZodNumber;
@@ -8804,8 +9821,8 @@ export declare const productSchema: z.ZodObject<{
8804
9821
  type: z.ZodLiteral<"SHIPPING">;
8805
9822
  shipping: z.ZodObject<{
8806
9823
  deliveryType: z.ZodEnum<{
8807
- PAID: "PAID";
8808
9824
  FREE: "FREE";
9825
+ PAID: "PAID";
8809
9826
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
8810
9827
  }>;
8811
9828
  deliveryFee: z.ZodNumber;
@@ -9048,8 +10065,8 @@ export declare const productCreateRequestSchema: z.ZodObject<{
9048
10065
  type: z.ZodLiteral<"SHIPPING">;
9049
10066
  shipping: z.ZodOptional<z.ZodObject<{
9050
10067
  deliveryType: z.ZodDefault<z.ZodEnum<{
9051
- PAID: "PAID";
9052
10068
  FREE: "FREE";
10069
+ PAID: "PAID";
9053
10070
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
9054
10071
  }>>;
9055
10072
  deliveryFee: z.ZodOptional<z.ZodNumber>;
@@ -9058,16 +10075,16 @@ export declare const productCreateRequestSchema: z.ZodObject<{
9058
10075
  returnAddressId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
9059
10076
  }, z.core.$strict>>;
9060
10077
  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
9061
- DIRECT: "DIRECT";
9062
10078
  CARRIER: "CARRIER";
10079
+ DIRECT: "DIRECT";
9063
10080
  PICKUP: "PICKUP";
9064
10081
  PROVIDED: "PROVIDED";
9065
10082
  }>>>;
9066
10083
  }, z.core.$strict>, z.ZodObject<{
9067
10084
  type: z.ZodLiteral<"MANUAL">;
9068
10085
  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
9069
- DIRECT: "DIRECT";
9070
10086
  CARRIER: "CARRIER";
10087
+ DIRECT: "DIRECT";
9071
10088
  PICKUP: "PICKUP";
9072
10089
  PROVIDED: "PROVIDED";
9073
10090
  }>>>;
@@ -9162,8 +10179,8 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
9162
10179
  type: z.ZodLiteral<"SHIPPING">;
9163
10180
  shipping: z.ZodObject<{
9164
10181
  deliveryType: z.ZodEnum<{
9165
- PAID: "PAID";
9166
10182
  FREE: "FREE";
10183
+ PAID: "PAID";
9167
10184
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
9168
10185
  }>;
9169
10186
  deliveryFee: z.ZodNumber;
@@ -9172,16 +10189,16 @@ export declare const productReplaceRequestSchema: z.ZodObject<{
9172
10189
  returnAddressId: z.ZodNullable<z.ZodString>;
9173
10190
  }, z.core.$strict>;
9174
10191
  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
9175
- DIRECT: "DIRECT";
9176
10192
  CARRIER: "CARRIER";
10193
+ DIRECT: "DIRECT";
9177
10194
  PICKUP: "PICKUP";
9178
10195
  PROVIDED: "PROVIDED";
9179
10196
  }>>>;
9180
10197
  }, z.core.$strict>, z.ZodObject<{
9181
10198
  type: z.ZodLiteral<"MANUAL">;
9182
10199
  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
9183
- DIRECT: "DIRECT";
9184
10200
  CARRIER: "CARRIER";
10201
+ DIRECT: "DIRECT";
9185
10202
  PICKUP: "PICKUP";
9186
10203
  PROVIDED: "PROVIDED";
9187
10204
  }>>>;
@@ -9285,8 +10302,8 @@ export declare const productPatchRequestSchema: z.ZodObject<{
9285
10302
  type: z.ZodLiteral<"SHIPPING">;
9286
10303
  shipping: z.ZodObject<{
9287
10304
  deliveryType: z.ZodEnum<{
9288
- PAID: "PAID";
9289
10305
  FREE: "FREE";
10306
+ PAID: "PAID";
9290
10307
  CONDITIONAL_FREE: "CONDITIONAL_FREE";
9291
10308
  }>;
9292
10309
  deliveryFee: z.ZodNumber;
@@ -9295,16 +10312,16 @@ export declare const productPatchRequestSchema: z.ZodObject<{
9295
10312
  returnAddressId: z.ZodNullable<z.ZodString>;
9296
10313
  }, z.core.$strict>;
9297
10314
  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
9298
- DIRECT: "DIRECT";
9299
10315
  CARRIER: "CARRIER";
10316
+ DIRECT: "DIRECT";
9300
10317
  PICKUP: "PICKUP";
9301
10318
  PROVIDED: "PROVIDED";
9302
10319
  }>>>;
9303
10320
  }, z.core.$strict>, z.ZodObject<{
9304
10321
  type: z.ZodLiteral<"MANUAL">;
9305
10322
  methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
9306
- DIRECT: "DIRECT";
9307
10323
  CARRIER: "CARRIER";
10324
+ DIRECT: "DIRECT";
9308
10325
  PICKUP: "PICKUP";
9309
10326
  PROVIDED: "PROVIDED";
9310
10327
  }>>>;
@@ -10161,8 +11178,8 @@ export type StorefrontDomain = z.infer<typeof storefrontDomainSchema>;
10161
11178
  */
10162
11179
  export declare const storefrontProvisioningSchema: z.ZodObject<{
10163
11180
  status: z.ZodEnum<{
10164
- FAILED: "FAILED";
10165
11181
  PENDING: "PENDING";
11182
+ FAILED: "FAILED";
10166
11183
  SYNCED: "SYNCED";
10167
11184
  }>;
10168
11185
  lastErrorCode: z.ZodNullable<z.ZodString>;
@@ -10249,8 +11266,8 @@ export declare const storefrontSiteSchema: z.ZodObject<{
10249
11266
  }, z.core.$strip>>;
10250
11267
  provisioning: z.ZodObject<{
10251
11268
  status: z.ZodEnum<{
10252
- FAILED: "FAILED";
10253
11269
  PENDING: "PENDING";
11270
+ FAILED: "FAILED";
10254
11271
  SYNCED: "SYNCED";
10255
11272
  }>;
10256
11273
  lastErrorCode: z.ZodNullable<z.ZodString>;
@@ -10334,8 +11351,8 @@ export declare const storefrontHostingSchema: z.ZodObject<{
10334
11351
  }, z.core.$strip>>;
10335
11352
  provisioning: z.ZodObject<{
10336
11353
  status: z.ZodEnum<{
10337
- FAILED: "FAILED";
10338
11354
  PENDING: "PENDING";
11355
+ FAILED: "FAILED";
10339
11356
  SYNCED: "SYNCED";
10340
11357
  }>;
10341
11358
  lastErrorCode: z.ZodNullable<z.ZodString>;
@@ -10382,8 +11399,8 @@ export declare const storefrontDeploymentStepSchema: z.ZodObject<{
10382
11399
  PUBLISH: "PUBLISH";
10383
11400
  }>;
10384
11401
  status: z.ZodEnum<{
10385
- FAILED: "FAILED";
10386
11402
  PENDING: "PENDING";
11403
+ FAILED: "FAILED";
10387
11404
  RUNNING: "RUNNING";
10388
11405
  DONE: "DONE";
10389
11406
  }>;
@@ -10404,9 +11421,9 @@ export type StorefrontDeploymentLog = z.infer<typeof storefrontDeploymentLogSche
10404
11421
  export declare const storefrontDeploymentSchema: z.ZodObject<{
10405
11422
  siteId: z.ZodString;
10406
11423
  status: z.ZodEnum<{
10407
- IN_PROGRESS: "IN_PROGRESS";
10408
- SUCCEEDED: "SUCCEEDED";
10409
11424
  FAILED: "FAILED";
11425
+ SUCCEEDED: "SUCCEEDED";
11426
+ IN_PROGRESS: "IN_PROGRESS";
10410
11427
  }>;
10411
11428
  url: z.ZodString;
10412
11429
  startedAt: z.ZodString;
@@ -10418,8 +11435,8 @@ export declare const storefrontDeploymentSchema: z.ZodObject<{
10418
11435
  PUBLISH: "PUBLISH";
10419
11436
  }>;
10420
11437
  status: z.ZodEnum<{
10421
- FAILED: "FAILED";
10422
11438
  PENDING: "PENDING";
11439
+ FAILED: "FAILED";
10423
11440
  RUNNING: "RUNNING";
10424
11441
  DONE: "DONE";
10425
11442
  }>;
@@ -10540,8 +11557,8 @@ export declare function storefrontCustomHostnameProblem(hostname: string, hostin
10540
11557
  /** 소유 확인 TXT 레코드의 전체 이름 */
10541
11558
  export declare function storefrontDomainTxtNameOf(hostname: string): string;
10542
11559
  export declare const storefrontCustomDomainStatusSchema: z.ZodEnum<{
10543
- FAILED: "FAILED";
10544
11560
  ACTIVE: "ACTIVE";
11561
+ FAILED: "FAILED";
10545
11562
  PENDING_DNS: "PENDING_DNS";
10546
11563
  PENDING_VALIDATION: "PENDING_VALIDATION";
10547
11564
  }>;
@@ -10567,8 +11584,8 @@ export declare const storefrontSiteDomainSchema: z.ZodObject<{
10567
11584
  CUSTOM: "CUSTOM";
10568
11585
  }>;
10569
11586
  status: z.ZodEnum<{
10570
- FAILED: "FAILED";
10571
11587
  ACTIVE: "ACTIVE";
11588
+ FAILED: "FAILED";
10572
11589
  PENDING_DNS: "PENDING_DNS";
10573
11590
  PENDING_VALIDATION: "PENDING_VALIDATION";
10574
11591
  }>;
@@ -10586,9 +11603,9 @@ export declare const storefrontSiteDomainSchema: z.ZodObject<{
10586
11603
  }>;
10587
11604
  }, z.core.$strip>>;
10588
11605
  certificateStatus: z.ZodNullable<z.ZodEnum<{
10589
- FAILED: "FAILED";
10590
- PENDING: "PENDING";
10591
11606
  ACTIVE: "ACTIVE";
11607
+ PENDING: "PENDING";
11608
+ FAILED: "FAILED";
10592
11609
  }>>;
10593
11610
  failureCode: z.ZodNullable<z.ZodString>;
10594
11611
  verifiedAt: z.ZodNullable<z.ZodString>;
@@ -10610,8 +11627,8 @@ export declare const storefrontSiteDomainsSchema: z.ZodObject<{
10610
11627
  CUSTOM: "CUSTOM";
10611
11628
  }>;
10612
11629
  status: z.ZodEnum<{
10613
- FAILED: "FAILED";
10614
11630
  ACTIVE: "ACTIVE";
11631
+ FAILED: "FAILED";
10615
11632
  PENDING_DNS: "PENDING_DNS";
10616
11633
  PENDING_VALIDATION: "PENDING_VALIDATION";
10617
11634
  }>;
@@ -10629,9 +11646,9 @@ export declare const storefrontSiteDomainsSchema: z.ZodObject<{
10629
11646
  }>;
10630
11647
  }, z.core.$strip>>;
10631
11648
  certificateStatus: z.ZodNullable<z.ZodEnum<{
10632
- FAILED: "FAILED";
10633
- PENDING: "PENDING";
10634
11649
  ACTIVE: "ACTIVE";
11650
+ PENDING: "PENDING";
11651
+ FAILED: "FAILED";
10635
11652
  }>>;
10636
11653
  failureCode: z.ZodNullable<z.ZodString>;
10637
11654
  verifiedAt: z.ZodNullable<z.ZodString>;
@@ -10865,10 +11882,10 @@ export declare const runStorefrontCheckRequestSchema: z.ZodObject<{
10865
11882
  }, z.core.$strip>;
10866
11883
  export type RunStorefrontCheckRequest = z.infer<typeof runStorefrontCheckRequestSchema>;
10867
11884
  export declare const storefrontCheckStatusSchema: z.ZodEnum<{
10868
- UNKNOWN: "UNKNOWN";
10869
11885
  FAILED: "FAILED";
10870
- RUNNING: "RUNNING";
11886
+ UNKNOWN: "UNKNOWN";
10871
11887
  QUEUED: "QUEUED";
11888
+ RUNNING: "RUNNING";
10872
11889
  PASSED: "PASSED";
10873
11890
  TIMED_OUT: "TIMED_OUT";
10874
11891
  }>;
@@ -10879,10 +11896,10 @@ export declare const storefrontCheckSchema: z.ZodObject<{
10879
11896
  checkId: z.ZodString;
10880
11897
  check: z.ZodString;
10881
11898
  status: z.ZodEnum<{
10882
- UNKNOWN: "UNKNOWN";
10883
11899
  FAILED: "FAILED";
10884
- RUNNING: "RUNNING";
11900
+ UNKNOWN: "UNKNOWN";
10885
11901
  QUEUED: "QUEUED";
11902
+ RUNNING: "RUNNING";
10886
11903
  PASSED: "PASSED";
10887
11904
  TIMED_OUT: "TIMED_OUT";
10888
11905
  }>;
@@ -10964,10 +11981,10 @@ export declare const storefrontVerifyReportSchema: z.ZodObject<{
10964
11981
  }, z.core.$strip>;
10965
11982
  export type StorefrontVerifyReport = z.infer<typeof storefrontVerifyReportSchema>;
10966
11983
  export declare const storefrontBuildStatusSchema: z.ZodEnum<{
10967
- SUCCEEDED: "SUCCEEDED";
10968
11984
  FAILED: "FAILED";
10969
- RUNNING: "RUNNING";
11985
+ SUCCEEDED: "SUCCEEDED";
10970
11986
  QUEUED: "QUEUED";
11987
+ RUNNING: "RUNNING";
10971
11988
  TIMED_OUT: "TIMED_OUT";
10972
11989
  }>;
10973
11990
  export type StorefrontBuildStatus = z.infer<typeof storefrontBuildStatusSchema>;
@@ -11032,10 +12049,10 @@ export declare const storefrontBuildSchema: z.ZodObject<{
11032
12049
  versionId: z.ZodString;
11033
12050
  versionNumber: z.ZodNumber;
11034
12051
  status: z.ZodEnum<{
11035
- SUCCEEDED: "SUCCEEDED";
11036
12052
  FAILED: "FAILED";
11037
- RUNNING: "RUNNING";
12053
+ SUCCEEDED: "SUCCEEDED";
11038
12054
  QUEUED: "QUEUED";
12055
+ RUNNING: "RUNNING";
11039
12056
  TIMED_OUT: "TIMED_OUT";
11040
12057
  }>;
11041
12058
  failureStage: z.ZodNullable<z.ZodString>;
@@ -11161,10 +12178,10 @@ export declare const storefrontVersionCreatedSchema: z.ZodObject<{
11161
12178
  versionId: z.ZodString;
11162
12179
  versionNumber: z.ZodNumber;
11163
12180
  status: z.ZodEnum<{
11164
- SUCCEEDED: "SUCCEEDED";
11165
12181
  FAILED: "FAILED";
11166
- RUNNING: "RUNNING";
12182
+ SUCCEEDED: "SUCCEEDED";
11167
12183
  QUEUED: "QUEUED";
12184
+ RUNNING: "RUNNING";
11168
12185
  TIMED_OUT: "TIMED_OUT";
11169
12186
  }>;
11170
12187
  failureStage: z.ZodNullable<z.ZodString>;
@@ -11360,11 +12377,13 @@ export type StorefrontSourceReplaced = z.infer<typeof storefrontSourceReplacedSc
11360
12377
  * - `product-image`: 상품 목록·상세의 상품 이미지. 목록 썸네일로 쓰이므로 정지 이미지만 받는다.
11361
12378
  * - `description`: 상세설명 본문에 삽입하는 미디어. 동영상과 svg도 받는다.
11362
12379
  * - `flow-attachment`: 주문 흐름 행동의 첨부(시안 등, 이슈 #115). 구매자에게 보이므로 정지 이미지와 PDF만 받는다.
12380
+ * - `ai-attachment`: 상점 플랫폼 AI 채팅에 붙이는 자료(이슈 #124). 모델이 읽는 정지 이미지와 PDF만 받는다.
11363
12381
  */
11364
12382
  export declare const uploadPurposeSchema: z.ZodEnum<{
11365
12383
  "product-image": "product-image";
11366
12384
  description: "description";
11367
12385
  "flow-attachment": "flow-attachment";
12386
+ "ai-attachment": "ai-attachment";
11368
12387
  }>;
11369
12388
  export type UploadPurpose = z.infer<typeof uploadPurposeSchema>;
11370
12389
  export interface UploadPurposeLimit {
@@ -11405,6 +12424,7 @@ export declare const uploadRequestSchema: z.ZodObject<{
11405
12424
  "product-image": "product-image";
11406
12425
  description: "description";
11407
12426
  "flow-attachment": "flow-attachment";
12427
+ "ai-attachment": "ai-attachment";
11408
12428
  }>>;
11409
12429
  size: z.ZodOptional<z.ZodNumber>;
11410
12430
  }, z.core.$strip>;
@@ -11711,7 +12731,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11711
12731
  fulfillment: UnknownFulfillment | {
11712
12732
  type: "SHIPPING";
11713
12733
  shipping: {
11714
- deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
12734
+ deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
11715
12735
  deliveryFee: number;
11716
12736
  conditionalFreeAmount: number | null;
11717
12737
  shippingAddressId: string | null;
@@ -11819,7 +12839,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11819
12839
  fulfillment: UnknownFulfillment | {
11820
12840
  type: "SHIPPING";
11821
12841
  shipping: {
11822
- deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
12842
+ deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
11823
12843
  deliveryFee: number;
11824
12844
  conditionalFreeAmount: number | null;
11825
12845
  shippingAddressId: string | null;
@@ -11927,7 +12947,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
11927
12947
  fulfillment: UnknownFulfillment | {
11928
12948
  type: "SHIPPING";
11929
12949
  shipping: {
11930
- deliveryType: "PAID" | "FREE" | "CONDITIONAL_FREE";
12950
+ deliveryType: "FREE" | "PAID" | "CONDITIONAL_FREE";
11931
12951
  deliveryFee: number;
11932
12952
  conditionalFreeAmount: number | null;
11933
12953
  shippingAddressId: string | null;
@@ -12309,7 +13329,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12309
13329
  value: true;
12310
13330
  } | {
12311
13331
  field: "bestSelling";
12312
- days: 7 | 30 | 90;
13332
+ days: 30 | 7 | 90;
12313
13333
  top: number;
12314
13334
  } | {
12315
13335
  [x: string]: unknown;
@@ -12359,7 +13379,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12359
13379
  value: true;
12360
13380
  } | {
12361
13381
  field: "bestSelling";
12362
- days: 7 | 30 | 90;
13382
+ days: 30 | 7 | 90;
12363
13383
  top: number;
12364
13384
  } | {
12365
13385
  [x: string]: unknown;
@@ -12402,7 +13422,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12402
13422
  value: true;
12403
13423
  } | {
12404
13424
  field: "bestSelling";
12405
- days: 7 | 30 | 90;
13425
+ days: 30 | 7 | 90;
12406
13426
  top: number;
12407
13427
  } | {
12408
13428
  [x: string]: unknown;
@@ -12444,7 +13464,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12444
13464
  value: true;
12445
13465
  } | {
12446
13466
  field: "bestSelling";
12447
- days: 7 | 30 | 90;
13467
+ days: 30 | 7 | 90;
12448
13468
  top: number;
12449
13469
  } | {
12450
13470
  [x: string]: unknown;
@@ -12507,7 +13527,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12507
13527
  value: true;
12508
13528
  } | {
12509
13529
  field: "bestSelling";
12510
- days: 7 | 30 | 90;
13530
+ days: 30 | 7 | 90;
12511
13531
  top: number;
12512
13532
  } | {
12513
13533
  [x: string]: unknown;
@@ -12550,7 +13570,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12550
13570
  value: true;
12551
13571
  } | {
12552
13572
  field: "bestSelling";
12553
- days: 7 | 30 | 90;
13573
+ days: 30 | 7 | 90;
12554
13574
  top: number;
12555
13575
  } | {
12556
13576
  [x: string]: unknown;
@@ -12941,7 +13961,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
12941
13961
  key: string;
12942
13962
  results: {
12943
13963
  orderItemId: string;
12944
- status: "COMPLETED" | "FAILED" | "SKIPPED";
13964
+ status: "FAILED" | "COMPLETED" | "SKIPPED";
12945
13965
  reason?: string | undefined;
12946
13966
  message?: string | undefined;
12947
13967
  }[];
@@ -13330,7 +14350,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
13330
14350
  enteredAt: string;
13331
14351
  fields: Record<string, string | number | boolean | string[] | null>;
13332
14352
  coreStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
13333
- claimStatus?: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
14353
+ claimStatus?: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
13334
14354
  message?: string | undefined;
13335
14355
  deadlineAt?: string | undefined;
13336
14356
  attachments?: string[] | undefined;
@@ -13395,7 +14415,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
13395
14415
  enteredAt: string;
13396
14416
  fields: Record<string, string | number | boolean | string[] | null>;
13397
14417
  coreStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
13398
- claimStatus?: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
14418
+ claimStatus?: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
13399
14419
  message?: string | undefined;
13400
14420
  deadlineAt?: string | undefined;
13401
14421
  attachments?: string[] | undefined;
@@ -13425,7 +14445,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
13425
14445
  enteredAt: string;
13426
14446
  fields: Record<string, string | number | boolean | string[] | null>;
13427
14447
  coreStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
13428
- claimStatus?: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
14448
+ claimStatus?: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
13429
14449
  message?: string | undefined;
13430
14450
  deadlineAt?: string | undefined;
13431
14451
  attachments?: string[] | undefined;
@@ -13477,9 +14497,10 @@ export declare function createStoreClient(options: StoreClientOptions): {
13477
14497
  }>;
13478
14498
  /**
13479
14499
  * `POST /order-items/{id}/events/{key}` — 현장 단말·연동의 상점 사건(`custom.<이름>`)을 플로우에 넣는다(#115).
13480
- * 에러: 400 `FLOW_EVENT_KEY_INVALID`, 409 `FLOW_EVENT_NOT_ACCEPTED`
14500
+ * 앱 사건(`app.<handle>.<이름>`, #22)은 그 앱의 설치 토큰으로만 보낸다(`ctx.api`).
14501
+ * 에러: 400 `FLOW_EVENT_KEY_INVALID`, 403 `FLOW_EVENT_APP_FORBIDDEN`, 409 `FLOW_EVENT_NOT_ACCEPTED`
13481
14502
  */
13482
- emitEvent: (orderItemId: string, key: `custom.${string}`, input?: Record<string, unknown>, idempotencyKey?: string) => Promise<{
14503
+ emitEvent: (orderItemId: string, key: `custom.${string}` | `app.${string}`, input?: Record<string, unknown>, idempotencyKey?: string) => Promise<{
13483
14504
  status: "COMPLETED";
13484
14505
  flowState: {
13485
14506
  key: string;
@@ -13487,7 +14508,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
13487
14508
  enteredAt: string;
13488
14509
  fields: Record<string, string | number | boolean | string[] | null>;
13489
14510
  coreStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
13490
- claimStatus?: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
14511
+ claimStatus?: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
13491
14512
  message?: string | undefined;
13492
14513
  deadlineAt?: string | undefined;
13493
14514
  attachments?: string[] | undefined;
@@ -13549,7 +14570,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
13549
14570
  enteredAt: string;
13550
14571
  fields: Record<string, string | number | boolean | string[] | null>;
13551
14572
  coreStatus?: "PAID" | "CANCELED" | "PAYMENT_WAITING" | "CONFIRMED" | "DISPATCHED" | "DELIVERING" | "DELIVERED" | "PURCHASE_DECIDED" | undefined;
13552
- claimStatus?: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
14573
+ claimStatus?: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN" | undefined;
13553
14574
  message?: string | undefined;
13554
14575
  deadlineAt?: string | undefined;
13555
14576
  attachments?: string[] | undefined;
@@ -14001,7 +15022,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
14001
15022
  claimId: string;
14002
15023
  claimNo: string | null;
14003
15024
  type: "RETURN" | "EXCHANGE" | "CANCEL";
14004
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
15025
+ status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
14005
15026
  orderId: string;
14006
15027
  orderItemId: string;
14007
15028
  productName: string;
@@ -14041,7 +15062,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
14041
15062
  claimId: string;
14042
15063
  claimNo: string | null;
14043
15064
  type: "RETURN" | "EXCHANGE" | "CANCEL";
14044
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
15065
+ status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
14045
15066
  orderId: string;
14046
15067
  orderItemId: string;
14047
15068
  productName: string;
@@ -14076,7 +15097,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
14076
15097
  address2: string | null;
14077
15098
  } | null;
14078
15099
  histories?: {
14079
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
15100
+ status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
14080
15101
  actor: "SYSTEM" | "BUYER" | "SELLER";
14081
15102
  occurredAt: string;
14082
15103
  }[] | undefined;
@@ -14114,7 +15135,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
14114
15135
  claimId: string;
14115
15136
  claimNo: string | null;
14116
15137
  type: "RETURN" | "EXCHANGE" | "CANCEL";
14117
- status: "COMPLETED" | "REJECTED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
15138
+ status: "REJECTED" | "COMPLETED" | "REQUESTED" | "HELD" | "COLLECTING" | "COLLECTED" | "REDELIVERING" | "APPROVED" | "WITHDRAWN";
14118
15139
  orderId: string;
14119
15140
  orderItemId: string;
14120
15141
  productName: string;
@@ -15038,7 +16059,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15038
16059
  conversionRate: number | null;
15039
16060
  };
15040
16061
  funnel: {
15041
- step: "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT" | "PURCHASE";
16062
+ step: "PURCHASE" | "SESSION" | "PRODUCT_VIEW" | "ADD_TO_CART" | "BEGIN_CHECKOUT";
15042
16063
  sessions: number;
15043
16064
  rateFromPrevious: number | null;
15044
16065
  }[];
@@ -15092,9 +16113,9 @@ export declare function createStoreClient(options: StoreClientOptions): {
15092
16113
  }>;
15093
16114
  /** `GET /v1/analytics/sources` — 채널·소스·캠페인·기기별 세션과 구매 */
15094
16115
  sources: (params: AnalyticsSourcesParams) => Promise<{
15095
- groupBy: "CAMPAIGN" | "CHANNEL" | "SOURCE" | "DEVICE";
16116
+ groupBy: "CHANNEL" | "SOURCE" | "CAMPAIGN" | "DEVICE";
15096
16117
  rows: {
15097
- channel: "DIRECT" | "ORGANIC_SEARCH" | "SOCIAL" | "PAID" | "EMAIL" | "CAMPAIGN" | "REFERRAL" | "UNKNOWN" | null;
16118
+ channel: "PAID" | "DIRECT" | "CAMPAIGN" | "UNKNOWN" | "ORGANIC_SEARCH" | "SOCIAL" | "EMAIL" | "REFERRAL" | null;
15098
16119
  source: string | null;
15099
16120
  medium: string | null;
15100
16121
  campaign: string | null;
@@ -15199,7 +16220,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15199
16220
  checkout: (params: AnalyticsRangeParams) => Promise<{
15200
16221
  sessions: number;
15201
16222
  outcomes: {
15202
- outcome: "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "OTHER" | "IN_PROGRESS";
16223
+ outcome: "OTHER" | "COMPLETED" | "NOT_OPENED" | "USER_CANCELED" | "DECLINED" | "PREPARE_FAILURE" | "IN_PROGRESS";
15203
16224
  sessions: number;
15204
16225
  }[];
15205
16226
  from: string;
@@ -15229,7 +16250,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15229
16250
  orderId: string | null;
15230
16251
  orderName: string;
15231
16252
  customerName: string;
15232
- status: "FAILED" | "PENDING" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
16253
+ status: "PENDING" | "FAILED" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
15233
16254
  amount: number;
15234
16255
  refundedAmount: number;
15235
16256
  heldRefundAmount: number;
@@ -15255,7 +16276,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15255
16276
  orderId: string | null;
15256
16277
  orderName: string;
15257
16278
  customerName: string;
15258
- status: "FAILED" | "PENDING" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
16279
+ status: "PENDING" | "FAILED" | "APPROVED" | "PARTIALLY_REFUNDED" | "REFUNDED";
15259
16280
  amount: number;
15260
16281
  refundedAmount: number;
15261
16282
  heldRefundAmount: number;
@@ -15370,7 +16391,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15370
16391
  masked: string | null;
15371
16392
  }[];
15372
16393
  lastVerification: {
15373
- result: "FAILED" | "SUCCESS";
16394
+ result: "SUCCESS" | "FAILED";
15374
16395
  message: string | null;
15375
16396
  checkedAt: string;
15376
16397
  } | null;
@@ -15395,7 +16416,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15395
16416
  masked: string | null;
15396
16417
  }[];
15397
16418
  lastVerification: {
15398
- result: "FAILED" | "SUCCESS";
16419
+ result: "SUCCESS" | "FAILED";
15399
16420
  message: string | null;
15400
16421
  checkedAt: string;
15401
16422
  } | null;
@@ -15419,7 +16440,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15419
16440
  masked: string | null;
15420
16441
  }[];
15421
16442
  lastVerification: {
15422
- result: "FAILED" | "SUCCESS";
16443
+ result: "SUCCESS" | "FAILED";
15423
16444
  message: string | null;
15424
16445
  checkedAt: string;
15425
16446
  } | null;
@@ -15480,7 +16501,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15480
16501
  masked: string | null;
15481
16502
  }[];
15482
16503
  lastVerification: {
15483
- result: "FAILED" | "SUCCESS";
16504
+ result: "SUCCESS" | "FAILED";
15484
16505
  message: string | null;
15485
16506
  checkedAt: string;
15486
16507
  } | null;
@@ -15505,7 +16526,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15505
16526
  masked: string | null;
15506
16527
  }[];
15507
16528
  lastVerification: {
15508
- result: "FAILED" | "SUCCESS";
16529
+ result: "SUCCESS" | "FAILED";
15509
16530
  message: string | null;
15510
16531
  checkedAt: string;
15511
16532
  } | null;
@@ -15529,7 +16550,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15529
16550
  masked: string | null;
15530
16551
  }[];
15531
16552
  lastVerification: {
15532
- result: "FAILED" | "SUCCESS";
16553
+ result: "SUCCESS" | "FAILED";
15533
16554
  message: string | null;
15534
16555
  checkedAt: string;
15535
16556
  } | null;
@@ -15595,7 +16616,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15595
16616
  masked: string | null;
15596
16617
  }[];
15597
16618
  lastVerification: {
15598
- result: "FAILED" | "SUCCESS";
16619
+ result: "SUCCESS" | "FAILED";
15599
16620
  message: string | null;
15600
16621
  checkedAt: string;
15601
16622
  } | null;
@@ -15620,7 +16641,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15620
16641
  masked: string | null;
15621
16642
  }[];
15622
16643
  lastVerification: {
15623
- result: "FAILED" | "SUCCESS";
16644
+ result: "SUCCESS" | "FAILED";
15624
16645
  message: string | null;
15625
16646
  checkedAt: string;
15626
16647
  } | null;
@@ -15644,7 +16665,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15644
16665
  masked: string | null;
15645
16666
  }[];
15646
16667
  lastVerification: {
15647
- result: "FAILED" | "SUCCESS";
16668
+ result: "SUCCESS" | "FAILED";
15648
16669
  message: string | null;
15649
16670
  checkedAt: string;
15650
16671
  } | null;
@@ -15691,7 +16712,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15691
16712
  masked: string | null;
15692
16713
  }[];
15693
16714
  lastVerification: {
15694
- result: "FAILED" | "SUCCESS";
16715
+ result: "SUCCESS" | "FAILED";
15695
16716
  message: string | null;
15696
16717
  checkedAt: string;
15697
16718
  } | null;
@@ -15716,7 +16737,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15716
16737
  masked: string | null;
15717
16738
  }[];
15718
16739
  lastVerification: {
15719
- result: "FAILED" | "SUCCESS";
16740
+ result: "SUCCESS" | "FAILED";
15720
16741
  message: string | null;
15721
16742
  checkedAt: string;
15722
16743
  } | null;
@@ -15740,7 +16761,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15740
16761
  masked: string | null;
15741
16762
  }[];
15742
16763
  lastVerification: {
15743
- result: "FAILED" | "SUCCESS";
16764
+ result: "SUCCESS" | "FAILED";
15744
16765
  message: string | null;
15745
16766
  checkedAt: string;
15746
16767
  } | null;
@@ -15797,7 +16818,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15797
16818
  masked: string | null;
15798
16819
  }[];
15799
16820
  lastVerification: {
15800
- result: "FAILED" | "SUCCESS";
16821
+ result: "SUCCESS" | "FAILED";
15801
16822
  message: string | null;
15802
16823
  checkedAt: string;
15803
16824
  } | null;
@@ -15822,7 +16843,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15822
16843
  masked: string | null;
15823
16844
  }[];
15824
16845
  lastVerification: {
15825
- result: "FAILED" | "SUCCESS";
16846
+ result: "SUCCESS" | "FAILED";
15826
16847
  message: string | null;
15827
16848
  checkedAt: string;
15828
16849
  } | null;
@@ -15846,7 +16867,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15846
16867
  masked: string | null;
15847
16868
  }[];
15848
16869
  lastVerification: {
15849
- result: "FAILED" | "SUCCESS";
16870
+ result: "SUCCESS" | "FAILED";
15850
16871
  message: string | null;
15851
16872
  checkedAt: string;
15852
16873
  } | null;
@@ -15893,7 +16914,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15893
16914
  masked: string | null;
15894
16915
  }[];
15895
16916
  lastVerification: {
15896
- result: "FAILED" | "SUCCESS";
16917
+ result: "SUCCESS" | "FAILED";
15897
16918
  message: string | null;
15898
16919
  checkedAt: string;
15899
16920
  } | null;
@@ -15918,7 +16939,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15918
16939
  masked: string | null;
15919
16940
  }[];
15920
16941
  lastVerification: {
15921
- result: "FAILED" | "SUCCESS";
16942
+ result: "SUCCESS" | "FAILED";
15922
16943
  message: string | null;
15923
16944
  checkedAt: string;
15924
16945
  } | null;
@@ -15942,7 +16963,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15942
16963
  masked: string | null;
15943
16964
  }[];
15944
16965
  lastVerification: {
15945
- result: "FAILED" | "SUCCESS";
16966
+ result: "SUCCESS" | "FAILED";
15946
16967
  message: string | null;
15947
16968
  checkedAt: string;
15948
16969
  } | null;
@@ -15998,7 +17019,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
15998
17019
  masked: string | null;
15999
17020
  }[];
16000
17021
  lastVerification: {
16001
- result: "FAILED" | "SUCCESS";
17022
+ result: "SUCCESS" | "FAILED";
16002
17023
  message: string | null;
16003
17024
  checkedAt: string;
16004
17025
  } | null;
@@ -16023,7 +17044,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
16023
17044
  masked: string | null;
16024
17045
  }[];
16025
17046
  lastVerification: {
16026
- result: "FAILED" | "SUCCESS";
17047
+ result: "SUCCESS" | "FAILED";
16027
17048
  message: string | null;
16028
17049
  checkedAt: string;
16029
17050
  } | null;
@@ -16047,7 +17068,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
16047
17068
  masked: string | null;
16048
17069
  }[];
16049
17070
  lastVerification: {
16050
- result: "FAILED" | "SUCCESS";
17071
+ result: "SUCCESS" | "FAILED";
16051
17072
  message: string | null;
16052
17073
  checkedAt: string;
16053
17074
  } | null;
@@ -16075,12 +17096,34 @@ export declare function createStoreClient(options: StoreClientOptions): {
16075
17096
  verify: (provider: PgProvider, body?: VerifyPaymentProviderRequest) => Promise<{
16076
17097
  provider: "tosspayments" | "portone";
16077
17098
  environment: "TEST" | "LIVE";
16078
- result: "FAILED" | "SUCCESS";
17099
+ result: "SUCCESS" | "FAILED";
16079
17100
  message: string | null;
16080
17101
  checkedAt: string;
16081
17102
  }>;
16082
17103
  };
16083
17104
  /** 설치 앱(#22, 매뉴얼 「앱 설치와 관리 › 관리 API」) — 설치·설정·제거·세션은 상점 플랫폼 OWNER·ADMIN만 */
17105
+ /** 에이전트 도구(#22 「에이전트 도구」) — 설치된 앱이 제공하는 도구 목록·실행. 실행은 OWNER·ADMIN */
17106
+ appTools: {
17107
+ list: () => Promise<{
17108
+ installationId: string;
17109
+ app: {
17110
+ appId: string;
17111
+ handle: string;
17112
+ name: string;
17113
+ };
17114
+ name: string;
17115
+ description: string;
17116
+ input: {
17117
+ name: string;
17118
+ type: "string" | "number" | "boolean";
17119
+ description: string | null;
17120
+ required: boolean;
17121
+ }[];
17122
+ }[]>;
17123
+ call: (installationId: string, name: string, input?: Record<string, unknown>) => Promise<{
17124
+ result: unknown;
17125
+ }>;
17126
+ };
16084
17127
  apps: {
16085
17128
  /** 이 상점에 설치할 수 있는 앱 — 앱 목록·상세(아이콘·README·Scope·Hook·설정 필드) */
16086
17129
  catalog: {
@@ -16115,6 +17158,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
16115
17158
  name: string;
16116
17159
  every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
16117
17160
  }[];
17161
+ tools: {
17162
+ name: string;
17163
+ description: string;
17164
+ }[];
17165
+ externalHost: string | null;
16118
17166
  settings: Record<string, {
16119
17167
  type: "string" | "number" | "boolean" | "select";
16120
17168
  label: string;
@@ -16164,6 +17212,25 @@ export declare function createStoreClient(options: StoreClientOptions): {
16164
17212
  name: string;
16165
17213
  every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
16166
17214
  }[];
17215
+ tools: {
17216
+ name: string;
17217
+ description: string;
17218
+ }[];
17219
+ externalHost: string | null;
17220
+ flowNotifications: {
17221
+ name: string;
17222
+ label: string;
17223
+ params: {
17224
+ name: string;
17225
+ type: "string" | "number" | "boolean";
17226
+ label: string;
17227
+ required: boolean;
17228
+ }[];
17229
+ }[];
17230
+ flowEvents: {
17231
+ name: string;
17232
+ label: string;
17233
+ }[];
16167
17234
  settings: {
16168
17235
  fields: Record<string, {
16169
17236
  type: "string" | "number" | "boolean" | "select";
@@ -16198,6 +17265,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
16198
17265
  name: string;
16199
17266
  every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
16200
17267
  }[];
17268
+ tools: {
17269
+ name: string;
17270
+ description: string;
17271
+ }[];
17272
+ externalHost: string | null;
16201
17273
  } | null | undefined;
16202
17274
  }>;
16203
17275
  list: () => Promise<{
@@ -16227,6 +17299,25 @@ export declare function createStoreClient(options: StoreClientOptions): {
16227
17299
  name: string;
16228
17300
  every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
16229
17301
  }[];
17302
+ tools: {
17303
+ name: string;
17304
+ description: string;
17305
+ }[];
17306
+ externalHost: string | null;
17307
+ flowNotifications: {
17308
+ name: string;
17309
+ label: string;
17310
+ params: {
17311
+ name: string;
17312
+ type: "string" | "number" | "boolean";
17313
+ label: string;
17314
+ required: boolean;
17315
+ }[];
17316
+ }[];
17317
+ flowEvents: {
17318
+ name: string;
17319
+ label: string;
17320
+ }[];
16230
17321
  settings: {
16231
17322
  fields: Record<string, {
16232
17323
  type: "string" | "number" | "boolean" | "select";
@@ -16261,6 +17352,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
16261
17352
  name: string;
16262
17353
  every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
16263
17354
  }[];
17355
+ tools: {
17356
+ name: string;
17357
+ description: string;
17358
+ }[];
17359
+ externalHost: string | null;
16264
17360
  } | null | undefined;
16265
17361
  }[]>;
16266
17362
  get: (installationId: string) => Promise<{
@@ -16290,6 +17386,25 @@ export declare function createStoreClient(options: StoreClientOptions): {
16290
17386
  name: string;
16291
17387
  every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
16292
17388
  }[];
17389
+ tools: {
17390
+ name: string;
17391
+ description: string;
17392
+ }[];
17393
+ externalHost: string | null;
17394
+ flowNotifications: {
17395
+ name: string;
17396
+ label: string;
17397
+ params: {
17398
+ name: string;
17399
+ type: "string" | "number" | "boolean";
17400
+ label: string;
17401
+ required: boolean;
17402
+ }[];
17403
+ }[];
17404
+ flowEvents: {
17405
+ name: string;
17406
+ label: string;
17407
+ }[];
16293
17408
  settings: {
16294
17409
  fields: Record<string, {
16295
17410
  type: "string" | "number" | "boolean" | "select";
@@ -16324,6 +17439,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
16324
17439
  name: string;
16325
17440
  every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
16326
17441
  }[];
17442
+ tools: {
17443
+ name: string;
17444
+ description: string;
17445
+ }[];
17446
+ externalHost: string | null;
16327
17447
  } | null | undefined;
16328
17448
  }>;
16329
17449
  /** 비밀 필드를 생략하면 현재 값을 유지한다. null은 비운다 */
@@ -16354,6 +17474,25 @@ export declare function createStoreClient(options: StoreClientOptions): {
16354
17474
  name: string;
16355
17475
  every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
16356
17476
  }[];
17477
+ tools: {
17478
+ name: string;
17479
+ description: string;
17480
+ }[];
17481
+ externalHost: string | null;
17482
+ flowNotifications: {
17483
+ name: string;
17484
+ label: string;
17485
+ params: {
17486
+ name: string;
17487
+ type: "string" | "number" | "boolean";
17488
+ label: string;
17489
+ required: boolean;
17490
+ }[];
17491
+ }[];
17492
+ flowEvents: {
17493
+ name: string;
17494
+ label: string;
17495
+ }[];
16357
17496
  settings: {
16358
17497
  fields: Record<string, {
16359
17498
  type: "string" | "number" | "boolean" | "select";
@@ -16388,6 +17527,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
16388
17527
  name: string;
16389
17528
  every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
16390
17529
  }[];
17530
+ tools: {
17531
+ name: string;
17532
+ description: string;
17533
+ }[];
17534
+ externalHost: string | null;
16391
17535
  } | null | undefined;
16392
17536
  }>;
16393
17537
  remove: (installationId: string) => Promise<void>;
@@ -16396,7 +17540,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
16396
17540
  runs: {
16397
17541
  deliveryId: string;
16398
17542
  eventType: string;
16399
- status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
17543
+ status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
16400
17544
  errorCode: "TIMEOUT" | "CONNECTION_FAILED" | "BLOCKED_ADDRESS" | "NON_2XX" | "WEBHOOK_SUSPENDED" | "APP_ERROR" | "APP_LIMIT_EXCEEDED" | "APP_REJECTED" | "APP_UNCONFIGURED" | "APP_INACTIVE" | "APP_RUNNER_UNAVAILABLE" | null;
16401
17545
  attemptCount: number;
16402
17546
  createdAt: string;
@@ -16433,6 +17577,25 @@ export declare function createStoreClient(options: StoreClientOptions): {
16433
17577
  name: string;
16434
17578
  every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
16435
17579
  }[];
17580
+ tools: {
17581
+ name: string;
17582
+ description: string;
17583
+ }[];
17584
+ externalHost: string | null;
17585
+ flowNotifications: {
17586
+ name: string;
17587
+ label: string;
17588
+ params: {
17589
+ name: string;
17590
+ type: "string" | "number" | "boolean";
17591
+ label: string;
17592
+ required: boolean;
17593
+ }[];
17594
+ }[];
17595
+ flowEvents: {
17596
+ name: string;
17597
+ label: string;
17598
+ }[];
16436
17599
  settings: {
16437
17600
  fields: Record<string, {
16438
17601
  type: "string" | "number" | "boolean" | "select";
@@ -16467,6 +17630,11 @@ export declare function createStoreClient(options: StoreClientOptions): {
16467
17630
  name: string;
16468
17631
  every: "15m" | "30m" | "1h" | "3h" | "6h" | "12h" | "1d";
16469
17632
  }[];
17633
+ tools: {
17634
+ name: string;
17635
+ description: string;
17636
+ }[];
17637
+ externalHost: string | null;
16470
17638
  } | null | undefined;
16471
17639
  }>;
16472
17640
  /** 앱 화면 iframe에 넘길 세션 토큰(5분) */
@@ -16569,7 +17737,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
16569
17737
  eventId: string;
16570
17738
  eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
16571
17739
  url: string;
16572
- status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
17740
+ status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
16573
17741
  responseStatusCode: number | null;
16574
17742
  responseTimeMs: number | null;
16575
17743
  responseBodyExcerpt: string | null;
@@ -16596,7 +17764,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
16596
17764
  eventId: string;
16597
17765
  eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
16598
17766
  url: string;
16599
- status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
17767
+ status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
16600
17768
  responseStatusCode: number | null;
16601
17769
  responseTimeMs: number | null;
16602
17770
  responseBodyExcerpt: string | null;
@@ -16631,7 +17799,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
16631
17799
  eventId: string;
16632
17800
  eventType: "ORDER.PAID" | "ORDER.CONFIRMED" | "ORDER.DISPATCHED" | "ORDER.DELIVERED" | "ORDER.PURCHASE_DECIDED" | "ORDER.ADDRESS_CHANGE_REQUESTED" | "ORDER.CANCELED" | "ORDER.FULFILLED" | "CLAIM.CANCEL_REQUESTED" | "CLAIM.RETURN_REQUESTED" | "CLAIM.EXCHANGE_REQUESTED" | "CLAIM.COMPLETED" | "INQUIRY.CREATED" | "REVIEW.CREATED" | "PRODUCT.OUT_OF_STOCK" | "ORDER.FLOW_NOTIFICATION" | "ORDER.FLOW_STATE_CHANGED";
16633
17801
  url: string;
16634
- status: "FAILED" | "PENDING" | "PENDING_RETRY" | "SUCCESS";
17802
+ status: "PENDING" | "PENDING_RETRY" | "SUCCESS" | "FAILED";
16635
17803
  responseStatusCode: number | null;
16636
17804
  responseTimeMs: number | null;
16637
17805
  responseBodyExcerpt: string | null;
@@ -16727,7 +17895,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
16727
17895
  method: string | null;
16728
17896
  path: string | null;
16729
17897
  statusCode: number | null;
16730
- outcome: "SUCCEEDED" | "FAILED" | "PENDING_APPROVAL" | "DENIED" | "DRY_RUN" | null;
17898
+ outcome: "FAILED" | "SUCCEEDED" | "PENDING_APPROVAL" | "DENIED" | "DRY_RUN" | null;
16731
17899
  errorCode: string | null;
16732
17900
  traceId: string | null;
16733
17901
  idempotencyKey: string | null;
@@ -16745,7 +17913,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
16745
17913
  list: (params?: ApprovalListOptions) => Promise<{
16746
17914
  items: {
16747
17915
  approvalId: string;
16748
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
17916
+ status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
16749
17917
  operationId: string;
16750
17918
  method: string;
16751
17919
  path: string;
@@ -16797,7 +17965,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
16797
17965
  }>;
16798
17966
  get: (approvalId: string) => Promise<{
16799
17967
  approvalId: string;
16800
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
17968
+ status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
16801
17969
  operationId: string;
16802
17970
  method: string;
16803
17971
  path: string;
@@ -16851,7 +18019,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
16851
18019
  */
16852
18020
  approve: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
16853
18021
  approvalId: string;
16854
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
18022
+ status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
16855
18023
  operationId: string;
16856
18024
  method: string;
16857
18025
  path: string;
@@ -16901,7 +18069,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
16901
18069
  }>;
16902
18070
  reject: (approvalId: string, body?: ApprovalDecisionRequest) => Promise<{
16903
18071
  approvalId: string;
16904
- status: "UNKNOWN" | "SUCCEEDED" | "FAILED" | "PENDING" | "EXECUTING" | "REJECTED" | "EXPIRED";
18072
+ status: "PENDING" | "FAILED" | "SUCCEEDED" | "EXECUTING" | "UNKNOWN" | "REJECTED" | "EXPIRED";
16905
18073
  operationId: string;
16906
18074
  method: string;
16907
18075
  path: string;
@@ -17049,6 +18217,151 @@ export declare function createStoreClient(options: StoreClientOptions): {
17049
18217
  }>;
17050
18218
  remove: (locationId: string) => Promise<void>;
17051
18219
  };
18220
+ /**
18221
+ * 상점 플랫폼 AI 채팅 (이슈 #124) — 상점 플랫폼 전용(공개 문서 제외). 메시지는 202로 `streamId`를 돌려주고
18222
+ * 응답은 `streamUrl`(SSE, Bearer `streamToken`)로 받는다. 실행은 브라우저와 무관하게 서버에서 끝까지 돈다.
18223
+ */
18224
+ ai: {
18225
+ /** `GET /v1/ai/conversations` — 내 대화 목록(최근 순) */
18226
+ listConversations: () => Promise<{
18227
+ id: string;
18228
+ title: string | null;
18229
+ createdAt: string;
18230
+ updatedAt: string;
18231
+ }[]>;
18232
+ /** `POST /v1/ai/conversations` — 새 대화. `draftId`를 주면 그 초안을 첫 메시지로 실행을 시작한다 */
18233
+ createConversation: (body?: CreateAiConversationRequest) => Promise<{
18234
+ conversation: {
18235
+ id: string;
18236
+ title: string | null;
18237
+ createdAt: string;
18238
+ updatedAt: string;
18239
+ };
18240
+ run: {
18241
+ streamId: string;
18242
+ streamUrl: string;
18243
+ streamToken: string;
18244
+ } | null;
18245
+ }>;
18246
+ /** `GET /v1/ai/conversations/{id}` — 메시지와 진행 중 실행 */
18247
+ getConversation: (conversationId: string) => Promise<{
18248
+ id: string;
18249
+ title: string | null;
18250
+ createdAt: string;
18251
+ updatedAt: string;
18252
+ messages: {
18253
+ id: string;
18254
+ role: "user" | "assistant";
18255
+ parts: ({
18256
+ type: "text";
18257
+ text: string;
18258
+ } | {
18259
+ type: "tool";
18260
+ toolCallId: string;
18261
+ name: string;
18262
+ label: string;
18263
+ status: "error" | "unknown" | "ok";
18264
+ summary: string | null;
18265
+ } | {
18266
+ type: "choices";
18267
+ question: string;
18268
+ options: {
18269
+ label: string;
18270
+ value: string;
18271
+ }[];
18272
+ } | {
18273
+ type: "attachment";
18274
+ attachment: {
18275
+ url: string;
18276
+ name: string;
18277
+ mediaType: string;
18278
+ };
18279
+ } | {
18280
+ type: "approval";
18281
+ approvalId: string;
18282
+ title: string;
18283
+ } | {
18284
+ type: "selection";
18285
+ selection: {
18286
+ component: string | null;
18287
+ source: {
18288
+ path: string;
18289
+ line: number;
18290
+ column?: number | undefined;
18291
+ } | null;
18292
+ tag: string;
18293
+ text: string;
18294
+ pagePath: string;
18295
+ };
18296
+ })[];
18297
+ runId: string | null;
18298
+ createdAt: string;
18299
+ }[];
18300
+ activeRun: {
18301
+ id: string;
18302
+ status: "FAILED" | "CANCEL_REQUESTED" | "QUEUED" | "RUNNING" | "DONE" | "CANCELLED";
18303
+ errorCode: string | null;
18304
+ createdAt: string;
18305
+ finishedAt: string | null;
18306
+ stream: {
18307
+ streamId: string;
18308
+ streamUrl: string;
18309
+ streamToken: string;
18310
+ };
18311
+ } | null;
18312
+ lastRun: {
18313
+ id: string;
18314
+ status: "FAILED" | "CANCEL_REQUESTED" | "QUEUED" | "RUNNING" | "DONE" | "CANCELLED";
18315
+ errorCode: string | null;
18316
+ createdAt: string;
18317
+ finishedAt: string | null;
18318
+ } | null;
18319
+ }>;
18320
+ /** `POST /v1/ai/conversations/{id}/messages` (202) — 진행 중 실행이 있으면 409 `AI_RUN_IN_PROGRESS` */
18321
+ sendMessage: (conversationId: string, body: SendAiMessageRequest) => Promise<{
18322
+ streamId: string;
18323
+ streamUrl: string;
18324
+ streamToken: string;
18325
+ messageId: string;
18326
+ }>;
18327
+ /** `POST /v1/ai/runs/{id}/cancel` (202) — 실행기가 다음 단계 전에 멈춘다 */
18328
+ cancelRun: (runId: string) => Promise<{
18329
+ id: string;
18330
+ status: "FAILED" | "CANCEL_REQUESTED" | "QUEUED" | "RUNNING" | "DONE" | "CANCELLED";
18331
+ errorCode: string | null;
18332
+ createdAt: string;
18333
+ finishedAt: string | null;
18334
+ }>;
18335
+ /** `GET /v1/ai/conversations/{id}/file-changes` — 실행별 스토어프론트 작업 트리 변경(#65) */
18336
+ listFileChanges: (conversationId: string) => Promise<{
18337
+ runs: {
18338
+ runId: string;
18339
+ status: "EXPIRED" | "APPLIED" | "INCOMPLETE" | "REVERTING" | "REVERTED" | "REVERT_UNKNOWN";
18340
+ files: {
18341
+ path: string;
18342
+ change: "created" | "modified" | "deleted";
18343
+ }[];
18344
+ }[];
18345
+ }>;
18346
+ /** `GET /v1/ai/runs/{id}/file-changes` — 실행 하나의 변경 내용(이전·이후) */
18347
+ getRunFileDiff: (runId: string) => Promise<{
18348
+ runId: string;
18349
+ status: "EXPIRED" | "APPLIED" | "INCOMPLETE" | "REVERTING" | "REVERTED" | "REVERT_UNKNOWN";
18350
+ files: {
18351
+ path: string;
18352
+ change: "created" | "modified" | "deleted";
18353
+ before: string | null;
18354
+ after: string | null;
18355
+ binary: boolean;
18356
+ }[];
18357
+ }>;
18358
+ /** `POST /v1/ai/runs/{id}/revert` — 실행이 바꾼 파일을 한 번에 되돌린다(전부 아니면 전무) */
18359
+ revertRun: (runId: string) => Promise<{
18360
+ runId: string;
18361
+ status: "REVERTED";
18362
+ paths: string[];
18363
+ }>;
18364
+ };
17052
18365
  /**
17053
18366
  * 스토어프론트 호스팅 (이슈 #53) — 조회 `storefront:r`, 쓰기 `storefront:rw`(OWNER·ADMIN).
17054
18367
  * 쓰기 응답은 바뀐 사이트다. Cloudflare 반영은 커밋 뒤라 `provisioning.status`가 잠시 `PENDING`일 수 있다.
@@ -17124,7 +18437,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17124
18437
  createdVia?: string | null | undefined;
17125
18438
  } | null;
17126
18439
  provisioning: {
17127
- status: "FAILED" | "PENDING" | "SYNCED";
18440
+ status: "PENDING" | "FAILED" | "SYNCED";
17128
18441
  lastErrorCode: string | null;
17129
18442
  syncedAt: string | null;
17130
18443
  };
@@ -17187,7 +18500,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17187
18500
  createdVia?: string | null | undefined;
17188
18501
  } | null;
17189
18502
  provisioning: {
17190
- status: "FAILED" | "PENDING" | "SYNCED";
18503
+ status: "PENDING" | "FAILED" | "SYNCED";
17191
18504
  lastErrorCode: string | null;
17192
18505
  syncedAt: string | null;
17193
18506
  };
@@ -17210,13 +18523,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
17210
18523
  /** `GET /v1/storefront/site/deployment` — 배포 진행(단계·기록). 만든 뒤 반영이 끝날 때까지 폴링한다 */
17211
18524
  getDeployment: () => Promise<{
17212
18525
  siteId: string;
17213
- status: "IN_PROGRESS" | "SUCCEEDED" | "FAILED";
18526
+ status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
17214
18527
  url: string;
17215
18528
  startedAt: string;
17216
18529
  finishedAt: string | null;
17217
18530
  steps: {
17218
18531
  key: "SITE" | "UPLOAD" | "PUBLISH";
17219
- status: "FAILED" | "PENDING" | "RUNNING" | "DONE";
18532
+ status: "PENDING" | "FAILED" | "RUNNING" | "DONE";
17220
18533
  finishedAt: string | null;
17221
18534
  }[];
17222
18535
  log: {
@@ -17232,13 +18545,13 @@ export declare function createStoreClient(options: StoreClientOptions): {
17232
18545
  /** `POST /v1/storefront/site/deployment/retry` (202) — 밀린 반영을 곧바로 다시 시도한다. 이미 반영됐으면 그대로다 */
17233
18546
  retryDeployment: () => Promise<{
17234
18547
  siteId: string;
17235
- status: "IN_PROGRESS" | "SUCCEEDED" | "FAILED";
18548
+ status: "FAILED" | "SUCCEEDED" | "IN_PROGRESS";
17236
18549
  url: string;
17237
18550
  startedAt: string;
17238
18551
  finishedAt: string | null;
17239
18552
  steps: {
17240
18553
  key: "SITE" | "UPLOAD" | "PUBLISH";
17241
- status: "FAILED" | "PENDING" | "RUNNING" | "DONE";
18554
+ status: "PENDING" | "FAILED" | "RUNNING" | "DONE";
17242
18555
  finishedAt: string | null;
17243
18556
  }[];
17244
18557
  log: {
@@ -17288,7 +18601,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17288
18601
  createdVia?: string | null | undefined;
17289
18602
  } | null;
17290
18603
  provisioning: {
17291
- status: "FAILED" | "PENDING" | "SYNCED";
18604
+ status: "PENDING" | "FAILED" | "SYNCED";
17292
18605
  lastErrorCode: string | null;
17293
18606
  syncedAt: string | null;
17294
18607
  };
@@ -17357,7 +18670,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17357
18670
  createdVia?: string | null | undefined;
17358
18671
  } | null;
17359
18672
  provisioning: {
17360
- status: "FAILED" | "PENDING" | "SYNCED";
18673
+ status: "PENDING" | "FAILED" | "SYNCED";
17361
18674
  lastErrorCode: string | null;
17362
18675
  syncedAt: string | null;
17363
18676
  };
@@ -17410,7 +18723,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17410
18723
  createdVia?: string | null | undefined;
17411
18724
  } | null;
17412
18725
  provisioning: {
17413
- status: "FAILED" | "PENDING" | "SYNCED";
18726
+ status: "PENDING" | "FAILED" | "SYNCED";
17414
18727
  lastErrorCode: string | null;
17415
18728
  syncedAt: string | null;
17416
18729
  };
@@ -17463,7 +18776,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17463
18776
  createdVia?: string | null | undefined;
17464
18777
  } | null;
17465
18778
  provisioning: {
17466
- status: "FAILED" | "PENDING" | "SYNCED";
18779
+ status: "PENDING" | "FAILED" | "SYNCED";
17467
18780
  lastErrorCode: string | null;
17468
18781
  syncedAt: string | null;
17469
18782
  };
@@ -17516,7 +18829,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17516
18829
  createdVia?: string | null | undefined;
17517
18830
  } | null;
17518
18831
  provisioning: {
17519
- status: "FAILED" | "PENDING" | "SYNCED";
18832
+ status: "PENDING" | "FAILED" | "SYNCED";
17520
18833
  lastErrorCode: string | null;
17521
18834
  syncedAt: string | null;
17522
18835
  };
@@ -17553,7 +18866,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17553
18866
  domainId: string;
17554
18867
  hostname: string;
17555
18868
  kind: "PLATFORM" | "CUSTOM";
17556
- status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
18869
+ status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
17557
18870
  isPrimary: boolean;
17558
18871
  dnsRecords: {
17559
18872
  type: "CNAME" | "TXT";
@@ -17561,7 +18874,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17561
18874
  value: string;
17562
18875
  purpose: "ROUTING" | "OWNERSHIP";
17563
18876
  }[];
17564
- certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
18877
+ certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
17565
18878
  failureCode: string | null;
17566
18879
  verifiedAt: string | null;
17567
18880
  activatedAt: string | null;
@@ -17577,7 +18890,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17577
18890
  domainId: string;
17578
18891
  hostname: string;
17579
18892
  kind: "PLATFORM" | "CUSTOM";
17580
- status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
18893
+ status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
17581
18894
  isPrimary: boolean;
17582
18895
  dnsRecords: {
17583
18896
  type: "CNAME" | "TXT";
@@ -17585,7 +18898,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17585
18898
  value: string;
17586
18899
  purpose: "ROUTING" | "OWNERSHIP";
17587
18900
  }[];
17588
- certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
18901
+ certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
17589
18902
  failureCode: string | null;
17590
18903
  verifiedAt: string | null;
17591
18904
  activatedAt: string | null;
@@ -17597,7 +18910,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17597
18910
  domainId: string;
17598
18911
  hostname: string;
17599
18912
  kind: "PLATFORM" | "CUSTOM";
17600
- status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
18913
+ status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
17601
18914
  isPrimary: boolean;
17602
18915
  dnsRecords: {
17603
18916
  type: "CNAME" | "TXT";
@@ -17605,7 +18918,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17605
18918
  value: string;
17606
18919
  purpose: "ROUTING" | "OWNERSHIP";
17607
18920
  }[];
17608
- certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
18921
+ certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
17609
18922
  failureCode: string | null;
17610
18923
  verifiedAt: string | null;
17611
18924
  activatedAt: string | null;
@@ -17621,7 +18934,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17621
18934
  domainId: string;
17622
18935
  hostname: string;
17623
18936
  kind: "PLATFORM" | "CUSTOM";
17624
- status: "FAILED" | "ACTIVE" | "PENDING_DNS" | "PENDING_VALIDATION";
18937
+ status: "ACTIVE" | "FAILED" | "PENDING_DNS" | "PENDING_VALIDATION";
17625
18938
  isPrimary: boolean;
17626
18939
  dnsRecords: {
17627
18940
  type: "CNAME" | "TXT";
@@ -17629,7 +18942,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17629
18942
  value: string;
17630
18943
  purpose: "ROUTING" | "OWNERSHIP";
17631
18944
  }[];
17632
- certificateStatus: "FAILED" | "PENDING" | "ACTIVE" | null;
18945
+ certificateStatus: "ACTIVE" | "PENDING" | "FAILED" | null;
17633
18946
  failureCode: string | null;
17634
18947
  verifiedAt: string | null;
17635
18948
  activatedAt: string | null;
@@ -17672,7 +18985,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17672
18985
  createdVia?: string | null | undefined;
17673
18986
  } | null;
17674
18987
  provisioning: {
17675
- status: "FAILED" | "PENDING" | "SYNCED";
18988
+ status: "PENDING" | "FAILED" | "SYNCED";
17676
18989
  lastErrorCode: string | null;
17677
18990
  syncedAt: string | null;
17678
18991
  };
@@ -17837,7 +19150,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17837
19150
  runCheck: (body: RunStorefrontCheckRequest) => Promise<{
17838
19151
  checkId: string;
17839
19152
  check: string;
17840
- status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
19153
+ status: "FAILED" | "UNKNOWN" | "QUEUED" | "RUNNING" | "PASSED" | "TIMED_OUT";
17841
19154
  exitCode: number | null;
17842
19155
  durationMs: number | null;
17843
19156
  outputTail: string | null;
@@ -17851,7 +19164,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17851
19164
  getCheck: (checkId: string) => Promise<{
17852
19165
  checkId: string;
17853
19166
  check: string;
17854
- status: "UNKNOWN" | "FAILED" | "RUNNING" | "QUEUED" | "PASSED" | "TIMED_OUT";
19167
+ status: "FAILED" | "UNKNOWN" | "QUEUED" | "RUNNING" | "PASSED" | "TIMED_OUT";
17855
19168
  exitCode: number | null;
17856
19169
  durationMs: number | null;
17857
19170
  outputTail: string | null;
@@ -17918,7 +19231,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17918
19231
  buildId: string;
17919
19232
  versionId: string;
17920
19233
  versionNumber: number;
17921
- status: "SUCCEEDED" | "FAILED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
19234
+ status: "FAILED" | "SUCCEEDED" | "QUEUED" | "RUNNING" | "TIMED_OUT";
17922
19235
  failureStage: string | null;
17923
19236
  errorCode: string | null;
17924
19237
  logTail: string | null;
@@ -17999,7 +19312,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
17999
19312
  buildId: string;
18000
19313
  versionId: string;
18001
19314
  versionNumber: number;
18002
- status: "SUCCEEDED" | "FAILED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
19315
+ status: "FAILED" | "SUCCEEDED" | "QUEUED" | "RUNNING" | "TIMED_OUT";
18003
19316
  failureStage: string | null;
18004
19317
  errorCode: string | null;
18005
19318
  logTail: string | null;
@@ -18077,7 +19390,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
18077
19390
  buildId: string;
18078
19391
  versionId: string;
18079
19392
  versionNumber: number;
18080
- status: "SUCCEEDED" | "FAILED" | "RUNNING" | "QUEUED" | "TIMED_OUT";
19393
+ status: "FAILED" | "SUCCEEDED" | "QUEUED" | "RUNNING" | "TIMED_OUT";
18081
19394
  failureStage: string | null;
18082
19395
  errorCode: string | null;
18083
19396
  logTail: string | null;
@@ -18222,7 +19535,7 @@ export declare function createStoreClient(options: StoreClientOptions): {
18222
19535
  code: string;
18223
19536
  name: string;
18224
19537
  };
18225
- status: "ACTIVE" | "CANCELED" | "PAST_DUE" | "INCOMPLETE";
19538
+ status: "ACTIVE" | "CANCELED" | "INCOMPLETE" | "PAST_DUE";
18226
19539
  interval: "MONTH" | null;
18227
19540
  cancelAtPeriodEnd: boolean;
18228
19541
  period: {
@@ -19139,6 +20452,7 @@ export declare const storeScopeResourceSchema: z.ZodEnum<{
19139
20452
  category: "category";
19140
20453
  flow: "flow";
19141
20454
  analytics: "analytics";
20455
+ storefront: "storefront";
19142
20456
  product: "product";
19143
20457
  order: "order";
19144
20458
  claim: "claim";
@@ -19151,7 +20465,6 @@ export declare const storeScopeResourceSchema: z.ZodEnum<{
19151
20465
  customer: "customer";
19152
20466
  audit: "audit";
19153
20467
  promotion: "promotion";
19154
- storefront: "storefront";
19155
20468
  }>;
19156
20469
  /** 카탈로그상 존재하는 스코프 문자열인가 (예: `settlement:rw`는 false) */
19157
20470
  export declare function isStoreScope(scope: string): boolean;
@@ -19400,10 +20713,10 @@ export declare const storeIndustrySchema: z.ZodEnum<{
19400
20713
  export type StoreIndustry = z.infer<typeof storeIndustrySchema>;
19401
20714
  /** 상품 자료 — 인터뷰의 「상품 자료」 답. 상품 등록 단계의 방법을 고른다 */
19402
20715
  export declare const brandBriefProductSourceSchema: z.ZodEnum<{
20716
+ NONE: "NONE";
19403
20717
  SPREADSHEET: "SPREADSHEET";
19404
20718
  EXISTING_STORE: "EXISTING_STORE";
19405
20719
  PHOTOS: "PHOTOS";
19406
- NONE: "NONE";
19407
20720
  }>;
19408
20721
  export type BrandBriefProductSource = z.infer<typeof brandBriefProductSourceSchema>;
19409
20722
  export declare const BRAND_BRIEF_MAX_REFERENCES = 5;
@@ -19428,10 +20741,10 @@ export declare const brandBriefSchema: z.ZodObject<{
19428
20741
  summary: z.ZodString;
19429
20742
  }, z.core.$strip>>;
19430
20743
  productSource: z.ZodNullable<z.ZodEnum<{
20744
+ NONE: "NONE";
19431
20745
  SPREADSHEET: "SPREADSHEET";
19432
20746
  EXISTING_STORE: "EXISTING_STORE";
19433
20747
  PHOTOS: "PHOTOS";
19434
- NONE: "NONE";
19435
20748
  }>>;
19436
20749
  notes: z.ZodNullable<z.ZodString>;
19437
20750
  }, z.core.$strip>;
@@ -19451,10 +20764,10 @@ export declare const putBrandBriefRequestSchema: z.ZodObject<{
19451
20764
  summary: z.ZodString;
19452
20765
  }, z.core.$strip>>>;
19453
20766
  productSource: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
20767
+ NONE: "NONE";
19454
20768
  SPREADSHEET: "SPREADSHEET";
19455
20769
  EXISTING_STORE: "EXISTING_STORE";
19456
20770
  PHOTOS: "PHOTOS";
19457
- NONE: "NONE";
19458
20771
  }>>>;
19459
20772
  notes: z.ZodDefault<z.ZodNullable<z.ZodString>>;
19460
20773
  }, z.core.$strip>;
@@ -19475,10 +20788,10 @@ export declare const brandBriefViewSchema: z.ZodObject<{
19475
20788
  summary: z.ZodString;
19476
20789
  }, z.core.$strip>>;
19477
20790
  productSource: z.ZodNullable<z.ZodEnum<{
20791
+ NONE: "NONE";
19478
20792
  SPREADSHEET: "SPREADSHEET";
19479
20793
  EXISTING_STORE: "EXISTING_STORE";
19480
20794
  PHOTOS: "PHOTOS";
19481
- NONE: "NONE";
19482
20795
  }>>;
19483
20796
  notes: z.ZodNullable<z.ZodString>;
19484
20797
  }, z.core.$strip>>;
@@ -19617,8 +20930,8 @@ export type ResponsePlanCode = PlanCode | (string & {});
19617
20930
  export declare const subscriptionStatusSchema: z.ZodEnum<{
19618
20931
  ACTIVE: "ACTIVE";
19619
20932
  CANCELED: "CANCELED";
19620
- PAST_DUE: "PAST_DUE";
19621
20933
  INCOMPLETE: "INCOMPLETE";
20934
+ PAST_DUE: "PAST_DUE";
19622
20935
  }>;
19623
20936
  export type SubscriptionStatus = z.infer<typeof subscriptionStatusSchema>;
19624
20937
  export declare const subscriptionLimitsSchema: z.ZodObject<{
@@ -19668,8 +20981,8 @@ export declare const storeSubscriptionSchema: z.ZodObject<{
19668
20981
  status: z.ZodEnum<{
19669
20982
  ACTIVE: "ACTIVE";
19670
20983
  CANCELED: "CANCELED";
19671
- PAST_DUE: "PAST_DUE";
19672
20984
  INCOMPLETE: "INCOMPLETE";
20985
+ PAST_DUE: "PAST_DUE";
19673
20986
  }>;
19674
20987
  interval: z.ZodNullable<z.ZodEnum<{
19675
20988
  MONTH: "MONTH";