@sayren/storefront-sdk 0.20.7 → 0.20.9

package/src/schemas/product-options.ts

@@ -1,4 +1,5 @@
 import { z } from "zod";
+import { stayRequestSchema, stayViewSchema } from "./stay";
 
 /**
  * 추가 선택·직접 입력 (이슈 #59) — 상품 상세의 옵션 표시, 장바구니 담기·바로 구매 요청, 줄 스냅샷의 공통 모양.
@@ -30,10 +31,62 @@ export const customInputViewSchema = z.object({
   placeholder: z.string().nullable().describe("입력 안내. 없으면 null"),
   maxLength: z.number().int().describe("최대 글자 수"),
   required: z.boolean(),
+  key: z.string().nullable().optional().describe("고정 키. 없으면 null"),
+  type: z
+    .string()
+    .optional()
+    .describe(
+      "입력 타입. 현재 값은 `text`·`number`(정수)·`select`·`date`(`YYYY-MM-DD`, 한국 날짜)·`datetime`(오프셋 있는 ISO 8601)·`image`(업로드 주소 목록, `maxLength`가 최대 장수)이고 값이 추가될 수 있어 문자열로 받는다. 없으면 `text`",
+    ),
+  options: z
+    .array(z.string())
+    .nullable()
+    .optional()
+    .describe("`select`의 선택지. 그 밖의 타입은 null"),
 });
 
 export type CustomInputView = z.infer<typeof customInputViewSchema>;
 
+/**
+ * 직접 입력값을 타입대로 검사하고 저장할 모양으로 바꾼다(정규화 뒤 값). 서버 판정(400 `CUSTOM_INPUT_INVALID`)과 스토어프론트
+ * 입력 검사가 이 함수 하나를 쓴다. 모르는 타입은 `text`로 본다. 맞지 않으면 null
+ */
+export function parseCustomInputValue(
+  type: string | null | undefined,
+  options: readonly string[] | null | undefined,
+  raw: string,
+): string | null {
+  const value = normalizeCustomInputValue(raw);
+  switch (type) {
+    case "number":
+      // 플로우 식의 int와 같은 범위 — 정수만 받는다(소수는 셀러가 단위를 바꿔 받는다, 예: g)
+      return /^-?\d{1,15}$/.test(value) ? String(Number(value)) : null;
+    case "select":
+      return options?.includes(value) ? value : null;
+    case "date": {
+      if (!/^\d{4}-\d{2}-\d{2}$/.test(value)) return null;
+      const date = new Date(`${value}T00:00:00Z`);
+      return !Number.isNaN(date.getTime()) && date.toISOString().slice(0, 10) === value
+        ? value
+        : null;
+    }
+    case "image": {
+      // 주문 입력 이미지(#115 E4) — 업로드 주소 목록(공백·줄바꿈 구분). 저장은 줄바꿈으로 잇는다. 주소의 출처(이 상점 업로드)는 서버가 본다
+      const urls = value.split(/\s+/).filter(Boolean);
+      if (urls.length === 0 || !urls.every((url) => /^https:\/\/\S+$/.test(url))) return null;
+      return [...new Set(urls)].join("\n");
+    }
+    case "datetime": {
+      if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}(:\d{2}(\.\d{1,3})?)?(Z|[+-]\d{2}:\d{2})$/.test(value))
+        return null;
+      const time = new Date(value);
+      return Number.isNaN(time.getTime()) ? null : time.toISOString();
+    }
+    default:
+      return value;
+  }
+}
+
 /**
  * 직접 입력값 정규화 — NFC로 모으고, 제어 문자(C0·C1·줄바꿈·줄·문단 구분자)는 공백으로, 제로폭·양방향 제어 문자는 지운 뒤
  * 앞뒤 공백을 지운다. 서버가 저장하는 값이 이것이다. 빈 문자열이면 입력하지 않은 것으로 본다.
@@ -88,8 +141,9 @@ export const lineSelectionRequestShape = {
     .max(20)
     .optional()
     .describe(
-      "직접 입력값. 필수 항목을 비우면 400 `CUSTOM_INPUT_REQUIRED`, 최대 글자 수를 넘으면 400 `CUSTOM_INPUT_TOO_LONG`, 없는 항목이면 400 `CUSTOM_INPUT_NOT_FOUND`",
+      "직접 입력값. 필수 항목을 비우면 400 `CUSTOM_INPUT_REQUIRED`, 최대 글자 수를 넘으면 400 `CUSTOM_INPUT_TOO_LONG`, 없는 항목이면 400 `CUSTOM_INPUT_NOT_FOUND`, 항목 타입에 맞지 않으면 400 `CUSTOM_INPUT_INVALID`",
     ),
+  stay: stayRequestSchema.optional(),
 };
 
 /** 줄의 옵션 선택 스냅샷 한 칸 — 조합 옵션은 옵션명마다 한 칸이고 추가금이 0이다(조합 추가금은 단가에 들어 있다) */
@@ -108,7 +162,9 @@ export type OptionSelectionView = z.infer<typeof optionSelectionViewSchema>;
 
 export const customInputValueViewSchema = z.object({
   label: z.string().describe("항목명"),
-  value: z.string().describe("구매자가 적은 값"),
+  value: z.string().describe("구매자가 적은 값(타입별 정규화 뒤 값, `datetime`은 UTC ISO 8601)"),
+  key: z.string().nullable().optional().describe("항목의 고정 키(주문 시점). 없으면 null"),
+  type: z.string().optional().describe("항목의 입력 타입(주문 시점). 없으면 `text`"),
 });
 
 export type CustomInputValueView = z.infer<typeof customInputValueViewSchema>;
@@ -125,4 +181,18 @@ export const lineSelectionResponseShape = {
     .optional()
     .default([])
     .describe("직접 입력값(항목명과 값). 없으면 빈 배열. 서버는 항상 싣는다"),
+  stay: stayViewSchema.optional().describe("숙박 기간과 박별 가격(날짜별 재고 상품만, 이슈 #118)"),
 };
+
+/** 주문 입력 이미지 업로드 자리 요청(#115 E4) — 파일명은 확장자만 쓰인다 */
+export const orderInputUploadRequestSchema = z.object({
+  filename: z.string().min(1).max(200),
+  size: z
+    .number()
+    .int()
+    .positive()
+    .optional()
+    .describe("바이트. 주면 상한을 넘을 때 미리 거절한다"),
+});
+
+export type OrderInputUploadRequest = z.infer<typeof orderInputUploadRequestSchema>;

package/src/schemas/stay.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+
+/**
+ * 숙박 기간·날짜별 달력(이슈 #118) — 날짜별 재고 상품(상품 상세 `inventoryMode: "DATED"`)은 담기·바로 구매에 기간을 함께 보내고,
+ * 가격은 박마다 달력의 가격을 더한 값이다. 날짜는 한국 날짜 `YYYY-MM-DD`다.
+ */
+export const stayRequestSchema = z
+  .object({
+    checkIn: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+    checkOut: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+  })
+  .describe(
+    "숙박 기간(날짜별 재고 상품만). 체크인 날부터 체크아웃 전날까지 박마다 재고·가격을 본다. 최대 30박. 날짜별 재고 상품에 빠지면 400 `STAY_REQUIRED`, 다른 상품에 주면 400 `STAY_NOT_APPLICABLE`, 재고가 없는 날이 있으면 409 `DATES_UNAVAILABLE`",
+  );
+export type StayRequest = z.infer<typeof stayRequestSchema>;
+
+export const stayViewSchema = z.object({
+  checkIn: z.string(),
+  checkOut: z.string(),
+  nights: z
+    .array(z.object({ date: z.string(), price: z.number().int() }))
+    .describe("박마다 날짜·가격(객실 1개 기준). 합이 줄 단가다"),
+});
+export type StayView = z.infer<typeof stayViewSchema>;
+
+/** 구매자 달력 한 칸 — 재고 수는 보이지 않고 예약 가능 여부만 */
+export const calendarDayViewSchema = z.object({
+  date: z.string(),
+  available: z.boolean(),
+  price: z.number().int().describe("그날 가격(원)"),
+});
+export type CalendarDayView = z.infer<typeof calendarDayViewSchema>;