@sayren/store-sdk 0.30.19 → 0.31.0

package/src/schemas/ai.ts

@@ -113,9 +113,16 @@ export type AiToolChange = z.infer<typeof aiToolChangeSchema>;
 
 /**
  * 에이전트 작업 단계(2026-10-13, AI 상점 도우미 작업 공간) — 에이전트가 패널 도구로 알린다.
- * 상점·상품·배포 준비 → 쇼핑몰 구조 설계 → 개발 환경 준비(라이브러리·SDK) → 코드 수정 루프 → 완료
+ * 상점·상품·배포 준비 → 쇼핑몰 구조 설계 → 디자인(아트보드, 2026-10-14 사용자 결정) → 개발 환경 준비(라이브러리·SDK) → 코드 수정 루프 → 완료
  */
-export const AI_AGENT_PHASES = ["STORE", "STRUCTURE", "ENVIRONMENT", "BUILD", "DONE"] as const;
+export const AI_AGENT_PHASES = [
+  "STORE",
+  "STRUCTURE",
+  "DESIGN",
+  "ENVIRONMENT",
+  "BUILD",
+  "DONE",
+] as const;
 export const aiAgentPhaseSchema = z.enum(AI_AGENT_PHASES);
 export type AiAgentPhase = z.infer<typeof aiAgentPhaseSchema>;
 
@@ -135,6 +142,8 @@ export const aiTodoSchema = z.object({
   id: z.string().max(10).optional(),
   content: z.string().min(1).max(200),
   status: z.enum(AI_TODO_STATUSES),
+  /** 이 할 일이 속한 작업 단계 — 진행중이 되면 실행기가 단계를 알린다(2026-10-14, 모델이 단계 알림을 빠뜨렸다) */
+  phase: aiAgentPhaseSchema.optional(),
 });
 export type AiTodo = z.infer<typeof aiTodoSchema>;
 export const AI_TODOS_MAX = 30;
@@ -143,11 +152,106 @@ export function isAiAgentNotesPath(path: string): boolean {
   return path === AI_AGENT_NOTES_DIR || path.startsWith(`${AI_AGENT_NOTES_DIR}/`);
 }
 
+/**
+ * 디자인 아트보드 폴더(2026-10-14 사용자 결정, Claude Code Design 캔버스의 파일 계약을 옮겼다) — DESIGN 단계에 에이전트가 쓰는 자기완결 HTML 아트보드와
+ * 인덱스 `canvas.json`이다. 앱 코드가 import하지 않아 발행 빌드에 들어가지 않고, 상점 플랫폼 작업 공간의 디자인 탭이 iframe(srcdoc)으로 그린다.
+ * 코드 탭 트리에서는 작업 메모처럼 뺀다
+ */
+export const AI_DESIGN_DIR = "src/site/design";
+export const AI_DESIGN_CANVAS_PATH = `${AI_DESIGN_DIR}/canvas.json`;
+export function isAiDesignPath(path: string): boolean {
+  return path === AI_DESIGN_DIR || path.startsWith(`${AI_DESIGN_DIR}/`);
+}
+/** 아트보드 파일 이름 — `src/site/design/` 바로 아래의 `.html` 하나(폴더 없음) */
+export const AI_DESIGN_BOARD_FILE_PATTERN = /^[a-z0-9][a-z0-9-]{0,63}\.html$/;
+export const AI_DESIGN_BOARD_KINDS = ["direction", "page", "scene"] as const;
+export const AI_DESIGN_VIEWPORTS = ["desktop", "mobile"] as const;
+/** 아트보드 상한 — 사이트맵의 화면마다 아트보드를 그린다(2026-10-15 사용자 결정, 화면 로드맵 29개 + 방향 후보 + 모바일). 24에서 올렸다 */
+export const AI_DESIGN_BOARDS_MAX = 64;
+/**
+ * 아트보드 하나 — `file`은 `src/site/design/` 아래 파일 이름, `kind`는 방향(저충실 후보)·페이지(고충실 화면)·장면(모션 시안, 셀러가 스크롤하며 본다),
+ * `viewport`는 데스크톱(1280)·모바일(390) 폭, `page`는 그 아트보드가 그리는 사이트 경로(구현 대조에 쓴다), `status`는 후보·채택·보관
+ */
+export const aiDesignBoardSchema = z.object({
+  file: z.string().regex(AI_DESIGN_BOARD_FILE_PATTERN),
+  title: z.string().min(1).max(60),
+  kind: z.enum(AI_DESIGN_BOARD_KINDS),
+  viewport: z.enum(AI_DESIGN_VIEWPORTS).default("desktop"),
+  page: z.string().max(200).optional(),
+  status: z.enum(["candidate", "chosen", "archived"]).default("chosen"),
+});
+export type AiDesignBoard = z.infer<typeof aiDesignBoardSchema>;
+export const aiDesignCanvasSchema = z.object({
+  version: z.literal(1),
+  /** 정한 방향 이름 — 방향 선택지에서 셀러가 고른 뒤 적는다(이름을 바꾸지 않는다) */
+  direction: z.string().max(80).nullable().default(null),
+  boards: z.array(aiDesignBoardSchema).max(AI_DESIGN_BOARDS_MAX),
+  /** 캔버스에 붙이는 메모(장 전환 규칙 등) */
+  notes: z.array(z.string().max(300)).max(20).default([]),
+});
+export type AiDesignCanvas = z.infer<typeof aiDesignCanvasSchema>;
+
+/** 셀러가 디자인 탭에서 고른 아트보드(2026-10-14) — 메시지와 함께 보내면 모델은 그 아트보드를 기준으로 고친다 */
+export const aiDesignSelectionSchema = z.object({
+  file: z.string().regex(AI_DESIGN_BOARD_FILE_PATTERN),
+  title: z.string().max(60),
+});
+export type AiDesignSelection = z.infer<typeof aiDesignSelectionSchema>;
+
+/** 쇼핑몰 형태(#124, 2026-10-13) — 템플릿은 basic 하나이고 형태는 에이전트에게 주는 화면 구성 지시다 */
+export const STORE_SHOP_TYPES = [
+  "BASIC",
+  "INTERACTIVE",
+  "STORYTELLING",
+  "MOBILE",
+  "CATALOG",
+  "LOOKBOOK",
+] as const;
+export const storeShopTypeSchema = z.enum(STORE_SHOP_TYPES);
+export type StoreShopType = z.infer<typeof storeShopTypeSchema>;
+
+/**
+ * 선택지 하나 — `templateId`는 스토어프론트 템플릿을, `shopType`은 쇼핑몰 형태를 고르는 선택지일 때의 값이다(2026-10-14). 상점 플랫폼이 썸네일을 붙인다
+ */
+export const aiChoiceOptionSchema = z.object({
+  label: z.string(),
+  value: z.string(),
+  templateId: z.string().max(64).optional(),
+  /** 쇼핑몰 형태를 고르는 선택지면 그 형태 — 상점 플랫폼이 형태 와이어프레임을 붙인다 */
+  shopType: storeShopTypeSchema.optional(),
+  /** 디자인 방향을 고르는 선택지면 그 아트보드 파일(`src/site/design/` 아래) — 상점 플랫폼이 아트보드를 썸네일로 붙인다(2026-10-14) */
+  boardFile: z.string().regex(AI_DESIGN_BOARD_FILE_PATTERN).optional(),
+});
+export type AiChoiceOption = z.infer<typeof aiChoiceOptionSchema>;
+
+/**
+ * 쇼핑몰 만들기 확인(2026-10-14) — 에이전트가 대화로 모은 값(라벨·값)과 고른 템플릿을 보이고 「이렇게 쇼핑몰을 만들까요?」를 묻는다.
+ * 셀러가 승인(`AI_SETUP_CONFIRM_APPROVE` 선택지)하면 만들기를 시작한다
+ */
+export const aiSetupConfirmItemSchema = z.object({ label: z.string(), value: z.string() });
+export type AiSetupConfirmItem = z.infer<typeof aiSetupConfirmItemSchema>;
+/** 확인 카드의 승인 선택지 값 */
+export const AI_SETUP_CONFIRM_APPROVE = "setup:approve";
+
+/**
+ * 디자인 확인(2026-10-14 사용자 결정) — DESIGN 단계 끝에 에이전트가 채택한 아트보드를 카드로 보이고 「이 디자인으로 만들까요?」를 묻는다.
+ * 셀러가 승인(`AI_DESIGN_CONFIRM_APPROVE` 선택지)해야 구현(ENVIRONMENT·BUILD)으로 넘어간다
+ */
+export const aiDesignConfirmBoardSchema = z.object({
+  file: z.string().regex(AI_DESIGN_BOARD_FILE_PATTERN),
+  title: z.string().max(60),
+});
+export type AiDesignConfirmBoard = z.infer<typeof aiDesignConfirmBoardSchema>;
+export const AI_DESIGN_CONFIRM_APPROVE = "design:approve";
+
 /**
  * 화면에 그리는 메시지 조각. 모델 원문(tool_use 블록 등)은 api가 보관하고 화면에는 이 형태만 준다.
  * - `text`: 글
  * - `tool`: 도구 호출 한 번(이름은 사람이 읽는 라벨, 결과 요약·링크)
  * - `choices`: 선택지 버튼(가장 최근 것만 누를 수 있다)
+ * - `setup_confirm`: 쇼핑몰 만들기 확인 카드(모은 값·템플릿, 승인은 뒤따르는 `choices`)
+ * - `design_confirm`: 디자인 확인 카드(채택한 아트보드, 승인은 뒤따르는 `choices`)
+ * - `design_selection`: 사용자가 디자인 탭에서 고른 아트보드
  * - `business_form`: 사업자 정보 입력 폼(가장 최근 것만 제출할 수 있다, 건너뛸 수 있다)
  * - `attachment`: 사용자가 올린 첨부
  * - `approval`: 승인 대기로 남은 쓰기
@@ -174,13 +278,23 @@ export const aiMessagePartSchema = z.discriminatedUnion("type", [
   z.object({
     type: z.literal("choices"),
     question: z.string(),
-    options: z
-      .array(z.object({ label: z.string(), value: z.string() }))
-      .min(1)
-      .max(6),
+    options: z.array(aiChoiceOptionSchema).min(1).max(6),
   }),
   z.object({ type: z.literal("business_form"), question: z.string() }),
+  /** 쇼핑몰 만들기 확인 카드 — 아래 선택지 조각이 승인을 묻는다 */
+  z.object({
+    type: z.literal("setup_confirm"),
+    items: z.array(aiSetupConfirmItemSchema).max(12),
+    templateId: z.string().max(64).optional(),
+  }),
+  /** 디자인 확인 카드 — 채택한 아트보드, 아래 선택지 조각이 승인을 묻는다 */
+  z.object({
+    type: z.literal("design_confirm"),
+    boards: z.array(aiDesignConfirmBoardSchema).min(1).max(AI_DESIGN_BOARDS_MAX),
+  }),
   z.object({ type: z.literal("attachment"), attachment: aiAttachmentSchema }),
+  /** 사용자가 디자인 탭에서 고른 아트보드 */
+  z.object({ type: z.literal("design_selection"), selection: aiDesignSelectionSchema }),
   /** 공개 뒤 승인이 필요한 쓰기를 승인 요청으로 남겼다(셀러가 승인함에서 결정한다) */
   z.object({ type: z.literal("approval"), approvalId: z.string(), title: z.string() }),
   /** 사용자가 미리보기에서 고른 요소(#65) */
@@ -218,18 +332,6 @@ export const aiConversationSchema = aiConversationSummarySchema.extend({
 });
 export type AiConversation = z.infer<typeof aiConversationSchema>;
 
-/** 쇼핑몰 형태(#124, 2026-10-13) — 템플릿은 basic 하나이고 형태는 에이전트에게 주는 화면 구성 지시다 */
-export const STORE_SHOP_TYPES = [
-  "BASIC",
-  "INTERACTIVE",
-  "STORYTELLING",
-  "MOBILE",
-  "CATALOG",
-  "LOOKBOOK",
-] as const;
-export const storeShopTypeSchema = z.enum(STORE_SHOP_TYPES);
-export type StoreShopType = z.infer<typeof storeShopTypeSchema>;
-
 /**
  * AI 상점 만들기 질문 화면의 답(#124, 2026-10-13) — 화면이 고정 질문으로 모은다. 초안과 함께 첫 메시지가 된다.
  * 배송비는 묻지 않는다(설정하지 않으면 무료배송). `slug`는 바라는 주소이고 쓸 수 있는지는 에이전트가 사이트를 만들 때 확인한다
@@ -268,6 +370,8 @@ export const sendAiMessageRequestSchema = z
     choice: z.string().max(200).optional(),
     /** 편집 미리보기에서 고른 요소(#65) — 모델은 이 요소를 기준으로 고친다 */
     selection: aiPreviewSelectionSchema.optional(),
+    /** 디자인 탭에서 고른 아트보드(2026-10-14) — 모델은 그 아트보드를 기준으로 고친다 */
+    designSelection: aiDesignSelectionSchema.optional(),
   })
   .refine((body) => body.text.length > 0 || body.attachments.length > 0, {
     message: "내용이나 첨부가 있어야 합니다",
@@ -428,10 +532,23 @@ export const aiStreamEventSchema = z.discriminatedUnion("type", [
     type: z.literal("choices"),
     messageId: z.string(),
     question: z.string(),
-    options: z.array(z.object({ label: z.string(), value: z.string() })),
+    options: z.array(aiChoiceOptionSchema),
   }),
   /** 사업자 정보 입력 폼을 보였다 — 답은 다음 메시지로 온다 */
   z.object({ type: z.literal("business_form"), messageId: z.string(), question: z.string() }),
+  /** 쇼핑몰 만들기 확인 카드를 보였다 — 이어서 승인 선택지(`choices`)가 온다 */
+  z.object({
+    type: z.literal("setup_confirm"),
+    messageId: z.string(),
+    items: z.array(aiSetupConfirmItemSchema),
+    templateId: z.string().max(64).optional(),
+  }),
+  /** 디자인 확인 카드를 보였다 — 이어서 승인 선택지(`choices`)가 온다 */
+  z.object({
+    type: z.literal("design_confirm"),
+    messageId: z.string(),
+    boards: z.array(aiDesignConfirmBoardSchema),
+  }),
   /** 공개 뒤 승인이 필요한 쓰기를 승인 요청으로 남겼다 */
   z.object({
     type: z.literal("approval"),

package/src/schemas/payment.ts

@@ -10,10 +10,21 @@ import { type PageParams, pageSchema } from "./common";
  */
 
 export const pgProviderSchema = z
-  .enum(["tosspayments", "portone"])
-  .describe("PG 식별자. `tosspayments`=토스페이먼츠, `portone`=포트원(V2)");
+  .enum(["tosspayments", "portone", "kakaopay", "naverpay"])
+  .describe(
+    "PG 식별자. `tosspayments`=토스페이먼츠, `portone`=포트원(V2), `kakaopay`=카카오페이(직접 연동), `naverpay`=네이버페이 결제형(직접 연동)",
+  );
 export type PgProvider = z.infer<typeof pgProviderSchema>;
 
+/**
+ * 간편결제 전용 PG — 결제수단이 간편결제 하나이고 간편결제사가 PG 자신이다(`kakaopay` → `KAKAOPAY`).
+ * 이 PG는 `easyPayProviders` 설정 없이 결제 옵션이 하나(`EASY_PAY` + 그 간편결제사) 나온다
+ */
+export const DEDICATED_EASY_PAY_PROVIDER = {
+  kakaopay: "KAKAOPAY",
+  naverpay: "NAVERPAY",
+} as const satisfies Partial<Record<PgProvider, string>>;
+
 export const pgPaymentMethodSchema = z
   .enum(["CARD", "BANK_TRANSFER", "VIRTUAL_ACCOUNT", "MOBILE", "EASY_PAY"])
   .describe("결제수단 (스토어프론트 결제 요청의 `paymentMethod`와 같은 값)");
@@ -138,6 +149,45 @@ export const portOneCredentialsInputSchema = z.object({
 });
 export type PortOneCredentialsInput = z.infer<typeof portOneCredentialsInputSchema>;
 
+/** 카카오페이 테스트 가맹점 코드 — 카카오페이 개발자센터의 단건 결제 테스트 CID */
+export const KAKAOPAY_TEST_CID = "TC0ONETIME";
+
+export const kakaoPayCredentialsInputSchema = z.object({
+  cid: z
+    .string()
+    .trim()
+    .min(4)
+    .max(20)
+    .describe(
+      "가맹점 코드(CID). 카카오페이와 계약하면 받는다. 공개 값. 테스트 세트는 `TC0ONETIME`(단건 결제 테스트 CID)을 쓸 수 있다",
+    ),
+  secretKey: secretInput()
+    .optional()
+    .describe(
+      "카카오페이 개발자센터 앱의 Secret key(테스트 세트는 dev, 실결제 세트는 운영 키). 비밀 값. 최초 연결 시 필수, 수정 시 생략하면 기존 값을 유지한다",
+    ),
+});
+export type KakaoPayCredentialsInput = z.infer<typeof kakaoPayCredentialsInputSchema>;
+
+export const naverPayCredentialsInputSchema = z.object({
+  clientId: z
+    .string()
+    .trim()
+    .min(4)
+    .max(100)
+    .describe("네이버페이 결제형 가입 후 받은 Client ID. 공개 값 — 결제창에서 쓰인다"),
+  chainId: z
+    .string()
+    .trim()
+    .min(4)
+    .max(100)
+    .describe("네이버페이 Chain ID. 공개 값 — 결제창과 API 요청에 쓰인다"),
+  clientSecret: secretInput()
+    .optional()
+    .describe("Client Secret. 비밀 값. 최초 연결 시 필수, 수정 시 생략하면 기존 값을 유지한다"),
+});
+export type NaverPayCredentialsInput = z.infer<typeof naverPayCredentialsInputSchema>;
+
 const upsertEnvironment = () =>
   pgEnvironmentSchema.describe(
     "저장할 자격 증명 세트. PG마다 `TEST`(샌드박스)·`LIVE`(실결제) 세트를 따로 둔다. " +
@@ -158,6 +208,18 @@ export const upsertPortOneProviderRequestSchema = z.object({
 });
 export type UpsertPortOneProviderRequest = z.infer<typeof upsertPortOneProviderRequestSchema>;
 
+export const upsertKakaoPayProviderRequestSchema = z.object({
+  environment: upsertEnvironment(),
+  credentials: kakaoPayCredentialsInputSchema,
+});
+export type UpsertKakaoPayProviderRequest = z.infer<typeof upsertKakaoPayProviderRequestSchema>;
+
+export const upsertNaverPayProviderRequestSchema = z.object({
+  environment: upsertEnvironment(),
+  credentials: naverPayCredentialsInputSchema,
+});
+export type UpsertNaverPayProviderRequest = z.infer<typeof upsertNaverPayProviderRequestSchema>;
+
 export const updatePaymentProviderRequestSchema = z
   .object({
     enabled: z
@@ -240,6 +302,8 @@ export type MaskedSecret = z.infer<typeof maskedSecretSchema>;
 const publicConfigSchema = z.union([
   z.object({ clientKey: z.string() }),
   z.object({ storeId: z.string(), channels: z.array(portOneChannelSchema) }),
+  z.object({ cid: z.string() }),
+  z.object({ clientId: z.string(), chainId: z.string() }),
 ]);
 
 const verificationSchema = z.object({
@@ -251,7 +315,7 @@ const verificationSchema = z.object({
 export const paymentCredentialSetSchema = z.object({
   environment: pgEnvironmentSchema,
   publicConfig: publicConfigSchema.describe(
-    "공개 값. 토스페이먼츠는 `{clientKey}`, 포트원은 `{storeId, channels}`",
+    "공개 값. 토스페이먼츠는 `{clientKey}`, 포트원은 `{storeId, channels}`, 카카오페이는 `{cid}`, 네이버페이는 `{clientId, chainId}`",
   ),
   secrets: z
     .array(maskedSecretSchema)
@@ -324,7 +388,8 @@ export const paymentProviderSchema = z.object({
   publicConfig: publicConfigSchema
     .nullable()
     .describe(
-      "활성 환경 세트의 공개 값. 토스페이먼츠는 `{clientKey}`, 포트원은 `{storeId, channels}`. 활성 세트가 없으면 null",
+      "활성 환경 세트의 공개 값. 토스페이먼츠는 `{clientKey}`, 포트원은 `{storeId, channels}`, 카카오페이는 `{cid}`, " +
+        "네이버페이는 `{clientId, chainId}`. 활성 세트가 없으면 null",
     ),
   secrets: z
     .array(maskedSecretSchema)
@@ -345,6 +410,18 @@ export const paymentProviderSchema = z.object({
     })
     .describe("환경별 자격 증명 세트. 등록되지 않은 세트는 null"),
   liveGate: liveGateSchema.describe("라이브 개방 조건. 조건을 모두 충족해야 샌드박스를 끌 수 있다"),
+  platformTestKeys: z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe(
+      "테스트모드 키 활성화. `true`면 TEST 세트가 sayren 지정 테스트 키로 고정된다(TEST 세트를 직접 저장·제거하면 409 `PLATFORM_TEST_KEYS_ENABLED`)",
+    ),
+  platformTestKeysAvailable: z
+    .boolean()
+    .optional()
+    .default(false)
+    .describe("이 PG에 sayren 지정 테스트 키가 있어 테스트모드 키를 켤 수 있는가"),
   easyPayProviders: z
     .array(easyPayProviderResponseSchema)
     .describe(
@@ -421,7 +498,17 @@ export const paymentSettingsSchema = z.object({
     .describe("결제 도메인 — 결제를 마친 구매자가 돌아올 스토어프론트 origin 목록"),
   providers: z
     .array(paymentProviderSchema)
-    .describe("지원하는 모든 PG. 연결된 것은 우선순위순, 연결되지 않은 것은 뒤에 온다"),
+    .describe(
+      "연결된 PG(우선순위순)와 연결되지 않은 토스페이먼츠·포트원. 카카오페이·네이버페이는 연결했을 때만 여기에 온다" +
+        "(이 PG를 모르는 이전 SDK가 응답을 읽을 수 있게). 연결할 수 있는 PG 전체는 `connectableProviders`다",
+    ),
+  connectableProviders: z
+    .array(paymentProviderSchema)
+    .optional()
+    .default(() => [])
+    .describe(
+      "연결되지 않은 PG 전체(카카오페이·네이버페이 포함). 서버는 항상 싣는다. 이 필드가 없는 이전 서버 응답은 기본값(빈 배열)으로 읽는다",
+    ),
   environment: pgEnvironmentSchema
     .nullable()
     .optional()
@@ -776,3 +863,38 @@ export interface PaymentListParams extends PageParams {
   /** 환불 대기가 있는 결제만(#115) */
   refundHeld?: boolean;
 }
+
+/** 테스트모드 키 활성화 요청(2026-10-14) — `PUT /v1/store/payment-providers/{provider}/platform-test-keys` */
+export const setPlatformTestKeysRequestSchema = z.object({
+  enabled: z
+    .boolean()
+    .describe(
+      "`true`면 sayren 지정 테스트 키를 TEST 세트로 저장하고 PG를 켠다. `false`면 고정만 푼다(TEST 세트는 그대로)",
+    ),
+});
+export type SetPlatformTestKeysRequest = z.infer<typeof setPlatformTestKeysRequestSchema>;
+
+/** 결제 상태 PG 한 줄 — 비밀 값·공개 키 없이 연결·사용·환경·테스트모드 키만 */
+export const paymentStatusProviderSchema = z.object({
+  provider: pgProviderSchema,
+  displayName: z.string(),
+  connected: z.boolean().describe("자격 증명이 저장돼 있는가"),
+  enabled: z.boolean().describe("결제에 사용 중인가"),
+  environment: pgEnvironmentSchema
+    .nullable()
+    .describe("새 결제에 쓰는 환경. 연결되지 않았으면 null"),
+  platformTestKeys: z.boolean().describe("테스트모드 키 활성화 여부"),
+  platformTestKeysAvailable: z.boolean().describe("sayren 지정 테스트 키로 바로 켤 수 있는가"),
+});
+export type PaymentStatusProvider = z.infer<typeof paymentStatusProviderSchema>;
+
+/** 결제 상태(2026-10-14) — `GET /v1/store/payment-status`. 지원 PG 전체와 상점의 연결 상태 */
+export const paymentStatusSchema = z.object({
+  environment: pgEnvironmentSchema
+    .nullable()
+    .describe("새 결제 세션의 환경(사용 중인 PG 기준). 쓸 수 있는 PG가 없으면 null"),
+  providers: z
+    .array(paymentStatusProviderSchema)
+    .describe("sayren이 지원하는 PG 전체(연결 안 된 PG 포함)"),
+});
+export type PaymentStatus = z.infer<typeof paymentStatusSchema>;

package/src/schemas/storefront-hosting.ts

@@ -952,6 +952,20 @@ export type StorefrontEditSession = z.infer<typeof storefrontEditSessionSchema>;
 export const storefrontDevLogsSchema = z.object({
   stdout: z.string(),
   stderr: z.string(),
+  browser: z
+    .array(
+      z.object({
+        seq: z.number().int().describe("세션 안에서 오르는 순번"),
+        at: z.string().describe("받은 시각"),
+        level: z.enum(["error", "warn"]),
+        message: z.string(),
+        url: z.string().describe("로그를 남긴 페이지 경로"),
+      }),
+    )
+    .default([])
+    .describe(
+      "편집 미리보기를 연 브라우저의 오류·경고(window 오류, 처리되지 않은 Promise 거부, console.error·warn) 최근 100건. 미리보기를 열어 둔 동안만 모인다",
+    ),
   at: z.string(),
 });
 export type StorefrontDevLogs = z.infer<typeof storefrontDevLogsSchema>;