@sayren/store-sdk 0.39.0 → 0.41.0

package/src/schemas/ai.ts

@@ -96,9 +96,15 @@ export const aiActivitySchema = z.enum([
 ]);
 export type AiActivity = z.infer<typeof aiActivitySchema>;
 
+/** 바뀐 줄 미리보기 한 줄의 최대 길이 — 서버가 이 길이로 자르고 화면은 이보다 긴 줄을 앞부분으로 비교한다 */
+export const AI_TOOL_CHANGE_LINE_MAX = 300;
+/** 바뀐 줄 범위(`lines`) 개수 상한 */
+export const AI_TOOL_CHANGE_RANGES_MAX = 200;
+
 /**
  * 도구가 바꾼 파일 하나(2026-10-13, AI 상점 도우미 작업 공간의 수정 중인 코드) — 서버가 도구 입력으로 계산한다.
- * `edit`는 바꾼 부분의 줄 비교, `write`는 새로 쓴 내용(이전 내용을 모르므로 모두 추가로 센다). `preview`는 바뀐 줄 앞부분 12줄까지다
+ * `edit`는 바꾼 부분의 줄 비교, `write`는 새로 쓴 내용(이전 내용을 모르므로 모두 추가로 센다). `preview`는 바뀐 줄 앞부분 12줄까지다.
+ * `lines`는 바꾼 뒤 파일에서 추가된 줄의 범위(1부터, 양끝 포함)다 — `edit`가 성공한 뒤에만 실행기가 채운다(옛 기록·`write`에는 없다)
  */
 export const aiToolChangeSchema = z.object({
   path: z.string().max(300),
@@ -106,8 +112,17 @@ export const aiToolChangeSchema = z.object({
   added: z.number().int().min(0),
   removed: z.number().int().min(0),
   preview: z
-    .array(z.object({ kind: z.enum(["added", "removed"]), text: z.string().max(300) }))
+    .array(
+      z.object({
+        kind: z.enum(["added", "removed"]),
+        text: z.string().max(AI_TOOL_CHANGE_LINE_MAX),
+      }),
+    )
     .max(12),
+  lines: z
+    .array(z.tuple([z.number().int().min(1), z.number().int().min(1)]))
+    .max(AI_TOOL_CHANGE_RANGES_MAX)
+    .optional(),
 });
 export type AiToolChange = z.infer<typeof aiToolChangeSchema>;
 
@@ -127,28 +142,49 @@ export const aiAgentPhaseSchema = z.enum(AI_AGENT_PHASES);
 export type AiAgentPhase = z.infer<typeof aiAgentPhaseSchema>;
 
 /**
- * AI 상점 도우미의 작업 메모 폴더(2026-10-14) — 회차마다 읽는 숨은 규칙(`rules.md`)과 디자인 계획(`design.md`). 셀러 화면(타임라인·코드 탭·변경 기록)에
- * 보이지 않는다. 편집 Sandbox가 점(.)으로 시작하는 경로를 받지 않아 작업 트리의 `src` 아래에 둔다(앱이 import하지 않는 문서라 빌드에 들어가지 않는다)
+ * AI 상점 도우미의 작업 메모 폴더(2026-10-14) — 회차마다 읽는 숨은 규칙(`rules.md`)과 디자인 계획(`design.md`). 편집 Sandbox가 점(.)으로 시작하는
+ * 경로를 받지 않아 작업 트리의 `src` 아래에 둔다(앱이 import하지 않는 문서라 빌드에 들어가지 않는다). 숨은 규칙은 셀러 화면(타임라인·코드 탭·변경 기록)에
+ * 보이지 않는다. 디자인 계획은 2026-10-24부터 셀러 문서(작업 공간 문서 탭의 「디자인 가이드라인」)라 숨기지 않는다(`AI_DESIGN_GUIDE_PATH`)
  */
 export const AI_AGENT_NOTES_DIR = "src/site/agent";
+/** 디자인 가이드라인(디자인 계획) — 작업 메모 폴더에 있지만 셀러가 읽는 문서다 */
+export const AI_DESIGN_GUIDE_PATH = `${AI_AGENT_NOTES_DIR}/design.md`;
+/** 사이트맵 — 에이전트가 쓰는 화면 구성 문서(`{version:1,pages:[…]}`) */
+export const AI_SITEMAP_PATH = "src/site/sitemap.json";
+
+/** 작업 공간 문서 탭의 문서 파일인가(사이트맵·디자인 가이드라인) — 앱 코드가 아니라서 코드 탭·미리보기 점검·코드 변경 판정에서 뺀다 */
+export function isAiWorkspaceDocPath(path: string): boolean {
+  return path === AI_SITEMAP_PATH || path === AI_DESIGN_GUIDE_PATH;
+}
+
+/** 「이어서 진행」 버튼(실패한 실행 잇기)이 보내는 선택 값 — 선택지 답처럼 같은 할 일 목록을 잇는다 */
+export const AI_RUN_RESUME_CHOICE = "run:resume";
 
 /**
  * 에이전트의 할 일 목록(2026-10-14, Claude Code의 TaskCreate·TaskUpdate·TaskList와 같다) — 에이전트가 패널 도구로 할 일을 만들고 상태를 바꾼다.
- * 이벤트·조각은 그 시점의 목록 전체이고 작업 공간 왼쪽 패널이 마지막 목록을 체크리스트로 그린다. 진행중은 한 번에 하나다
+ * 이벤트·조각은 그 시점의 목록 전체이고 작업 공간 로드맵 탭이 마지막 목록을 칸반으로 그린다. 진행중은 한 번에 하나다.
+ * 목록은 셀러 요청 하나(사이클)의 일이다 — 새 요청이면 빈 목록에서 시작하고 선택지 답이면 잇는다(2026-10-24). 개수 상한은 없다
+ * (옛 30개 상한은 대화 전체에 할 일이 쌓여 넘쳤다 — 크기는 사이클 범위가, 폭주는 턴 예산이 막는다).
+ * `blocked`는 같은 문제를 거듭 고쳐도 남아 멈춘 일이고 `note`가 그 사유다(이어 가기 리마인더가 남은 일로 세지 않는다)
  */
-export const AI_TODO_STATUSES = ["pending", "in_progress", "completed"] as const;
+export const AI_TODO_STATUSES = ["pending", "in_progress", "completed", "blocked"] as const;
 export const aiTodoSchema = z.object({
-  /** 할 일 번호(대화 안에서 1부터) — 옛 조각에는 없다 */
+  /** 할 일 번호(사이클 안에서 1부터) — 옛 조각에는 없다 */
   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(),
+  /** 막힌 사유(`blocked`일 때만) */
+  note: z.string().max(300).optional(),
 });
 export type AiTodo = z.infer<typeof aiTodoSchema>;
+/** @deprecated 할 일 개수 상한은 없앴다(2026-10-24). 공개 export라 값만 남긴다 */
 export const AI_TODOS_MAX = 30;
 
+/** 셀러에게 보이지 않는 작업 메모인가 — 작업 메모 폴더에서 디자인 가이드라인을 뺀 나머지다 */
 export function isAiAgentNotesPath(path: string): boolean {
+  if (path === AI_DESIGN_GUIDE_PATH) return false;
   return path === AI_AGENT_NOTES_DIR || path.startsWith(`${AI_AGENT_NOTES_DIR}/`);
 }
 
@@ -260,7 +296,12 @@ export const AI_DESIGN_CONFIRM_APPROVE = "design:approve";
  * - `todos`: 에이전트의 할 일 목록 전체(작업 공간의 체크리스트)
  */
 export const aiMessagePartSchema = z.discriminatedUnion("type", [
-  z.object({ type: z.literal("text"), text: z.string() }),
+  z.object({
+    type: z.literal("text"),
+    text: z.string(),
+    /** 셀러가 선택지 버튼으로 보낸 답의 값(사용자 메시지만) — 할 일 목록(사이클)을 잇는 기준(`isAiChoiceAnswer`) */
+    choice: z.string().max(200).optional(),
+  }),
   z.object({
     type: z.literal("tool"),
     toolCallId: z.string(),
@@ -302,7 +343,7 @@ export const aiMessagePartSchema = z.discriminatedUnion("type", [
   z.object({ type: z.literal("reasoning"), text: z.string() }),
   z.object({ type: z.literal("phase"), phase: aiAgentPhaseSchema }),
   /** 에이전트의 할 일 목록 — 그 시점의 목록 전체다(가장 최근 것이 지금 목록) */
-  z.object({ type: z.literal("todos"), todos: z.array(aiTodoSchema).max(AI_TODOS_MAX) }),
+  z.object({ type: z.literal("todos"), todos: z.array(aiTodoSchema) }),
 ]);
 export type AiMessagePart = z.infer<typeof aiMessagePartSchema>;
 
@@ -506,7 +547,7 @@ export const aiStreamEventSchema = z.discriminatedUnion("type", [
   z.object({
     type: z.literal("todos"),
     messageId: z.string(),
-    todos: z.array(aiTodoSchema).max(AI_TODOS_MAX),
+    todos: z.array(aiTodoSchema),
   }),
   z.object({
     type: z.literal("tool_start"),
@@ -527,6 +568,8 @@ export const aiStreamEventSchema = z.discriminatedUnion("type", [
     toolCallId: z.string(),
     status: z.enum(["ok", "error", "unknown"]),
     summary: z.string().nullable(),
+    /** 결과로 확정한 변경(바뀐 줄 범위 포함) — 있으면 `tool_start`의 `changes`를 바꾼다 */
+    changes: z.array(aiToolChangeSchema).max(10).optional(),
   }),
   z.object({
     type: z.literal("choices"),
@@ -622,3 +665,12 @@ export const storeDraftPreviewSchema = z.object({
   used: z.boolean(),
 });
 export type StoreDraftPreview = z.infer<typeof storeDraftPreviewSchema>;
+
+/**
+ * 셀러 메시지가 선택지에서 고른 답인가(조각에 `choice`가 있다) — 할 일 목록은 셀러 요청 하나(사이클)의 일이고, 고른 답(선택지·만들기 확인·계획 승인·발행 확인·
+ * 「이어서 진행」)은 같은 사이클을 잇고 새로 쓴 글은 새 사이클이다(2026-10-24). api(`currentCycleRows`)와 상점 플랫폼(로드맵)이 이 판정 하나를 쓴다.
+ * 직전 답에 선택지가 있었는지로 가르면 선택지를 무시하고 새 요청을 쓴 경우도 옛 사이클에 묶였다
+ */
+export function isAiChoiceAnswer(parts: readonly { type: string; choice?: string }[]): boolean {
+  return parts.some((part) => part.type === "text" && Boolean(part.choice));
+}

package/src/schemas/payment.ts

@@ -513,7 +513,7 @@ export const paymentProviderSchema = z.object({
       "지금 새 결제의 후보가 아닌 사유. 후보면 null. 판정 원천은 서버 라우팅이다(상점 플랫폼이 다시 계산하지 않는다). " +
         "후보가 아닌 PG에는 항상 사유 코드를 붙인다(연결 안 된 PG 포함) — 모든 PG는 `candidates`에 있거나 이 값이 null이 아니다. 현재 값: " +
         "`NOT_CONNECTED`(연결 안 됨) · `DISABLED`(사용 중지) · `CREDENTIAL_MISSING`(활성 환경 자격 증명 없음) · " +
-        "`SANDBOX_IN_LIVE_STORE`(다른 PG가 라이브라 이 샌드박스 PG는 실구매자 결제에 쓰지 않음) · " +
+        "`SANDBOX_IN_LIVE_STORE`(더는 반환하지 않음 — PG는 각자 쓰인다) · " +
         "`PLATFORM_BLOCKED`(플랫폼이 실결제를 막음) · `MODE_MISMATCH`(라이브를 연 서버 모드와 현재 모드가 다름). " +
         "값이 추가될 수 있어 문자열로 받는다 — 모르는 값은 후보 아님으로 다룬다." +
         " 서버는 항상 싣는다. 이 필드가 없는 이전 서버 응답은 기본값(null)으로 읽는다",

package/src/schemas/storefront-hosting.ts

@@ -25,7 +25,6 @@ import { RESERVED_STORE_CODES } from "./store";
  * - 409 `STOREFRONT_NO_ROLLBACK_TARGET` — 되돌릴 이전 발행 버전이 없다
  * - 409 `STOREFRONT_NOT_READY` — 공개 전환: 판매 중인 상품(샘플 제외)이 없다(이슈 #70). 상품을 등록한 뒤 공개한다
  * - 409 `TEMPLATE_CHANGE_NOT_SUPPORTED` — 템플릿 변경(`POST /v1/storefront/site/template`, 폐기)은 항상 이 오류다
- * - 400 `STOREFRONT_SLUG_CONFIRM_MISMATCH` — 호스팅 끄기 확인 입력이 현재 슬러그와 다르다
  * - 503 `STOREFRONT_PREVIEW_NOT_CONFIGURED` — 미리보기 서명 키가 설정되지 않았다
  *
  * 편집(M2b, `/v1/storefront/site/editing`·`files/**`·`checks/**`·`verify`·`builds/**`, 버전 만들기):
@@ -551,9 +550,13 @@ export const setStorefrontVisibilityRequestSchema = z.object({
 });
 export type SetStorefrontVisibilityRequest = z.infer<typeof setStorefrontVisibilityRequestSchema>;
 
-/** 호스팅 끄기 — 사이트를 닫고(`CLOSED`) 슬러그를 보류한다. 확인 입력은 현재 슬러그다 */
+/** 호스팅 끄기 — 사이트를 닫고(`CLOSED`) 슬러그를 보류한다. 확인 입력은 받지 않는다(2026-10-22) */
 export const disableStorefrontHostingRequestSchema = z.object({
-  confirmSlug: z.string().min(1).describe("확인 입력 — 현재 슬러그"),
+  confirmSlug: z
+    .string()
+    .max(200)
+    .optional()
+    .describe("쓰지 않는다 — 보내도 무시한다(옛 확인 입력)"),
 });
 export type DisableStorefrontHostingRequest = z.infer<typeof disableStorefrontHostingRequestSchema>;
 

package/src/session.ts

@@ -1,5 +1,5 @@
 import { base64UrlFromBytes } from "./base64";
-import { toApiError, unwrapData } from "./http";
+import { SAYREN_API_BASE_URL, toApiError, unwrapData } from "./http";
 import {
   buildAuthorizeUrl,
   createPkcePair,
@@ -50,8 +50,8 @@ export interface StoreAuthServer {
 }
 
 export interface StoreSessionOptions {
-  /** api 주소(예: https://api.example.com/v1) — `userinfo()`의 `GET /me`에 쓴다 */
-  baseUrl: string;
+  /** api 주소(버전 경로 포함) — `userinfo()`의 `GET /me`에 쓴다. 생략하면 운영 주소(`https://api.sayren.io/v1`) */
+  baseUrl?: string;
   /** 인가 서버(accounts) 주소들 */
   authServer: StoreAuthServer;
   /** OAuth public client id (예: avarlabs) */
@@ -114,9 +114,12 @@ export interface StoreSession {
 }
 
 export function createStoreSession(options: StoreSessionOptions): StoreSession {
-  const { baseUrl, clientId, storage, authServer } = options;
+  const { clientId, storage, authServer } = options;
+  const baseUrl = options.baseUrl ?? SAYREN_API_BASE_URL;
   const { revokeUrl, tokenUrl, resource } = authServer;
-  const fetchFn = options.fetch ?? globalThis.fetch;
+  // 주입이 없으면 부를 때마다 지금의 전역 fetch를 쓴다(http.ts와 같다)
+  const fetchFn: typeof globalThis.fetch =
+    options.fetch ?? ((input, init) => globalThis.fetch(input, init));
   const listeners = new Set<() => void>();
 
   function notify(): void {

package/dist/webhook-headers-ap_exsb9.mjs

@@ -1,22 +0,0 @@
-//#region src/webhook-headers.ts
-/** 웹훅 발송 요청 헤더 상수 (공개 계약). zod 의존 없이 서버 엔트리포인트에서도 가볍게 쓴다 */
-/** 서명 헤더. 형식: `t=<unix초>,v1=<hex>[,v1=<hex>]` */
-const WEBHOOK_SIGNATURE_HEADER = "Sayren-Signature";
-/** 이벤트 ID 헤더. 본문 `id`와 같다. 중복 제거 키 */
-const WEBHOOK_EVENT_ID_HEADER = "Sayren-Event-Id";
-/** 이벤트 타입 헤더. 본문 `type`과 같다 */
-const WEBHOOK_EVENT_TYPE_HEADER = "Sayren-Event-Type";
-/** 전송 기록 ID 헤더. 전송 기록의 `deliveryId`와 같다 */
-const WEBHOOK_DELIVERY_ID_HEADER = "Sayren-Delivery-Id";
-/** 발송 요청의 `User-Agent` 값 */
-const WEBHOOK_USER_AGENT = "Sayren-Webhooks/1.0";
-/** 수신 측 권장 타임스탬프 허용 오차(초) */
-const WEBHOOK_DEFAULT_TOLERANCE_SEC = 300;
-const WEBHOOK_HEADERS = {
-	signature: WEBHOOK_SIGNATURE_HEADER,
-	eventId: WEBHOOK_EVENT_ID_HEADER,
-	eventType: WEBHOOK_EVENT_TYPE_HEADER,
-	deliveryId: WEBHOOK_DELIVERY_ID_HEADER
-};
-//#endregion
-export { WEBHOOK_HEADERS as a, WEBHOOK_EVENT_TYPE_HEADER as i, WEBHOOK_DELIVERY_ID_HEADER as n, WEBHOOK_SIGNATURE_HEADER as o, WEBHOOK_EVENT_ID_HEADER as r, WEBHOOK_USER_AGENT as s, WEBHOOK_DEFAULT_TOLERANCE_SEC as t };