@zalkera/client 0.7.2 → 0.9.0

package/dist/index.d.cts

@@ -67,6 +67,18 @@ interface SiteConfig {
      * 정책 문구와 이 값이 갈리지 않도록 금액은 항상 이 필드를 쓴다.
      */
     defaultReturnShippingFee: number | null;
+    /**
+     * 영업시간 JSON 문자열(스키마리스 — 테넌트가 채운다). 미설정이면 null.
+     * 권장 구조: `{weekly:[{dayOfWeek:["Monday",…], opens:"10:00", closes:"20:00"}], closedNote?:string}`.
+     *
+     * `dayOfWeek`·`opens`·`closes` 는 schema.org `OpeningHoursSpecification` 의 속성명을 그대로 쓴다 —
+     * 중간 어휘를 하나 더 만들면 매핑표가 사본이 되고, 사본은 갈라진다.
+     *
+     * **null 이면 JSON-LD 에서 필드를 통째로 빼라.** 영업시간을 모르는 채 "영업시간 있음"만 주장하는 것은
+     * 구조화 데이터로서 거짓이고, `LocalBusiness` 는 그 거짓이 곧바로 사람의 헛걸음이 되는 타입이다.
+     * **파싱 실패해도 죽으면 안 된다** — 패스스루라 어떤 값이든 올 수 있다.
+     */
+    openingHours: string | null;
 }
 /** 테넌트 업종. 서버가 값을 추가할 수 있다 — 모르는 값은 일반(Organization)으로 흘려보내라. */
 type BusinessType = "BEAUTY";
@@ -919,7 +931,7 @@ declare class ZalkeraError extends Error {
  * client 발행 전 `scripts/sync-section-contract.mjs` 로 대조한다.
  */
 /** 백엔드 스펙 `contractRev` 와 같아야 한다. 어긋나면 동기 스크립트가 잡는다. */
-declare const SECTION_CONTRACT_REV = 1;
+declare const SECTION_CONTRACT_REV = 2;
 /** 업종 분류 — 콘솔 섹션 픽커의 그룹핑에 쓴다(테넌트 업종 필드는 아직 없다·memo102 §5). */
 type SectionVertical = "BEAUTY" | "GENERAL";
 interface SectionSpec {
@@ -935,7 +947,7 @@ interface SectionSpec {
 declare const SECTION_CONTRACT: readonly [{
     readonly type: "SERVICE_MENU";
     readonly vertical: "BEAUTY";
-    readonly jsonLd: null;
+    readonly jsonLd: "ItemList";
 }, {
     readonly type: "BEFORE_AFTER_GALLERY";
     readonly vertical: "BEAUTY";
@@ -1012,7 +1024,13 @@ declare function asObjectArray(value: unknown): Record<string, unknown>[];
 declare function asString(value: unknown): string | undefined;
 /** 양의 정수가 아니면 undefined. */
 declare function asId(value: unknown): number | undefined;
-/** 미디어는 프록시로만 — presigned URL 을 마크업에 넣지 않는다(만료되면 깨진 이미지가 박제된다). */
+/**
+ * 미디어는 프록시로만 — presigned URL 을 마크업에 넣지 않는다(만료되면 깨진 이미지가 박제된다).
+ *
+ * 경로 조각은 URL 인코딩한다 — 선언은 `number` 지만 실제 인자는 백엔드가 검증하지 않는 raw config
+ * 에서 온다(이 파일 상단 참고). 인코딩이 없으면 `../` 이 프록시 라우트 밖으로 새어 나간다.
+ * **throw 하지 않는다**는 이 파일의 계약은 그대로다 — 인코딩만 하고 값을 판정하지 않는다.
+ */
 declare function mediaSrc(assetId: number): string;
 
 /**

package/dist/index.d.ts

@@ -67,6 +67,18 @@ interface SiteConfig {
      * 정책 문구와 이 값이 갈리지 않도록 금액은 항상 이 필드를 쓴다.
      */
     defaultReturnShippingFee: number | null;
+    /**
+     * 영업시간 JSON 문자열(스키마리스 — 테넌트가 채운다). 미설정이면 null.
+     * 권장 구조: `{weekly:[{dayOfWeek:["Monday",…], opens:"10:00", closes:"20:00"}], closedNote?:string}`.
+     *
+     * `dayOfWeek`·`opens`·`closes` 는 schema.org `OpeningHoursSpecification` 의 속성명을 그대로 쓴다 —
+     * 중간 어휘를 하나 더 만들면 매핑표가 사본이 되고, 사본은 갈라진다.
+     *
+     * **null 이면 JSON-LD 에서 필드를 통째로 빼라.** 영업시간을 모르는 채 "영업시간 있음"만 주장하는 것은
+     * 구조화 데이터로서 거짓이고, `LocalBusiness` 는 그 거짓이 곧바로 사람의 헛걸음이 되는 타입이다.
+     * **파싱 실패해도 죽으면 안 된다** — 패스스루라 어떤 값이든 올 수 있다.
+     */
+    openingHours: string | null;
 }
 /** 테넌트 업종. 서버가 값을 추가할 수 있다 — 모르는 값은 일반(Organization)으로 흘려보내라. */
 type BusinessType = "BEAUTY";
@@ -919,7 +931,7 @@ declare class ZalkeraError extends Error {
  * client 발행 전 `scripts/sync-section-contract.mjs` 로 대조한다.
  */
 /** 백엔드 스펙 `contractRev` 와 같아야 한다. 어긋나면 동기 스크립트가 잡는다. */
-declare const SECTION_CONTRACT_REV = 1;
+declare const SECTION_CONTRACT_REV = 2;
 /** 업종 분류 — 콘솔 섹션 픽커의 그룹핑에 쓴다(테넌트 업종 필드는 아직 없다·memo102 §5). */
 type SectionVertical = "BEAUTY" | "GENERAL";
 interface SectionSpec {
@@ -935,7 +947,7 @@ interface SectionSpec {
 declare const SECTION_CONTRACT: readonly [{
     readonly type: "SERVICE_MENU";
     readonly vertical: "BEAUTY";
-    readonly jsonLd: null;
+    readonly jsonLd: "ItemList";
 }, {
     readonly type: "BEFORE_AFTER_GALLERY";
     readonly vertical: "BEAUTY";
@@ -1012,7 +1024,13 @@ declare function asObjectArray(value: unknown): Record<string, unknown>[];
 declare function asString(value: unknown): string | undefined;
 /** 양의 정수가 아니면 undefined. */
 declare function asId(value: unknown): number | undefined;
-/** 미디어는 프록시로만 — presigned URL 을 마크업에 넣지 않는다(만료되면 깨진 이미지가 박제된다). */
+/**
+ * 미디어는 프록시로만 — presigned URL 을 마크업에 넣지 않는다(만료되면 깨진 이미지가 박제된다).
+ *
+ * 경로 조각은 URL 인코딩한다 — 선언은 `number` 지만 실제 인자는 백엔드가 검증하지 않는 raw config
+ * 에서 온다(이 파일 상단 참고). 인코딩이 없으면 `../` 이 프록시 라우트 밖으로 새어 나간다.
+ * **throw 하지 않는다**는 이 파일의 계약은 그대로다 — 인코딩만 하고 값을 판정하지 않는다.
+ */
 declare function mediaSrc(assetId: number): string;
 
 /**

package/dist/index.js

@@ -67,6 +67,11 @@ function isApiErrorBody(value) {
   return typeof value === "object" && value !== null && "message" in value && typeof value.message === "string";
 }
 
+// src/pathSegment.ts
+function seg(v) {
+  return encodeURIComponent(String(v));
+}
+
 // src/client.ts
 var DEFAULT_TIMEOUT_MS = 1e4;
 function createZalkeraClient(options) {
@@ -79,6 +84,9 @@ function createZalkeraClient(options) {
   }
   const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
   async function request(path, init) {
+    if (/(^|\/)\.{1,2}(\/|$)/.test(path)) {
+      throw new ZalkeraError(`\uACBD\uB85C\uC5D0 \uC0C1\uB300 \uC138\uADF8\uBA3C\uD2B8\uAC00 \uC788\uC2B5\uB2C8\uB2E4: ${path}`, { status: 400, code: "INVALID_PATH" });
+    }
     const url = new URL(`${baseUrl}/api${path}`);
     if (init?.query) {
       for (const [key, value] of Object.entries(init.query)) {
@@ -104,7 +112,14 @@ function createZalkeraClient(options) {
         method: init?.method ?? "GET",
         headers,
         body: init?.body != null ? JSON.stringify(init.body) : void 0,
-        signal: controller.signal
+        signal: controller.signal,
+        // 리다이렉트를 따라가지 않는다 — **보안 불변식이라 스위치를 두지 않는다**(옵션으로 열면
+        // 그 옵션이 곧 사고 경로가 된다). 기본값 `follow` 로 크로스오리진 3xx 를 따라가면
+        // `X-Storefront-Key`(테넌트 시크릿)·`X-Tenant`·`X-Cart-Session`·`Idempotency-Key` 가
+        // 제3자 오리진에 그대로 전달된다 — undici 는 커스텀 헤더를 벗기지 않는다(실측).
+        // `"error"` 를 쓰지 않는 이유: undici 에서 일반 `TypeError: fetch failed` 로 떨어져
+        // 아래 네트워크 분기에 흡수되고, 그러면 원인(대개 baseUrl 오배선)이 사라진다.
+        redirect: "manual"
       };
       if (init?.next) fetchInit.next = init.next;
       response = await fetchImpl(url.toString(), fetchInit);
@@ -117,6 +132,14 @@ function createZalkeraClient(options) {
     } finally {
       clearTimeout(timer);
     }
+    if (isRedirectResponse(response)) {
+      response.body?.cancel().catch(() => {
+      });
+      throw new ZalkeraError(
+        `\uBC31\uC5D4\uB4DC\uAC00 \uB9AC\uB2E4\uC774\uB809\uD2B8\uB85C \uC751\uB2F5\uD588\uC2B5\uB2C8\uB2E4 (HTTP ${response.status}). \uBCF4\uC548\uC0C1 \uB530\uB77C\uAC00\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4 \u2014 \uB530\uB77C\uAC00\uBA74 \uC694\uCCAD \uD5E4\uB354(\uD14C\uB10C\uD2B8 \uC2DC\uD06C\uB9BF \uD0A4\xB7\uC7A5\uBC14\uAD6C\uB2C8 \uC138\uC158)\uAC00 \uB2E4\uB978 \uC624\uB9AC\uC9C4\uC73C\uB85C \uC0D9\uB2C8\uB2E4. baseUrl \uC774 \uCD5C\uC885 \uC624\uB9AC\uC9C4\uC778\uC9C0 \uD655\uC778\uD558\uC138\uC694(http\u2194https \uC2B9\uACA9, www \uC720\uBB34, \uD504\uB85D\uC2DC\uC758 \uACBD\uB85C \uB9AC\uB77C\uC774\uD2B8).`,
+        { status: 502, code: "UPSTREAM_REDIRECT" }
+      );
+    }
     const text = await response.text();
     const parsed = text ? safeJsonParse(text) : null;
     if (!response.ok) {
@@ -142,18 +165,18 @@ function createZalkeraClient(options) {
         sort: params?.sort
       }
     }),
-    getPost: (slug) => request(`/public/posts/${encodeURIComponent(slug)}`),
-    recordPostView: (slug, context) => request(`/public/posts/${encodeURIComponent(slug)}/view`, {
+    getPost: (slug) => request(`/public/posts/${seg(slug)}`),
+    recordPostView: (slug, context) => request(`/public/posts/${seg(slug)}/view`, {
       method: "POST",
       context
     }),
-    getPage: (slug, options2) => request(`/public/pages/${encodeURIComponent(slug)}`, nextInit(options2)),
+    getPage: (slug, options2) => request(`/public/pages/${seg(slug)}`, nextInit(options2)),
     listPages: (params, options2) => request("/public/pages", {
       query: { page: params?.page, size: params?.size },
       ...nextInit(options2)
     }),
     listMenus: (options2) => request("/public/menus", { next: options2?.tags ? { tags: options2.tags } : void 0 }),
-    getMediaUrl: (id) => request(`/public/media/${id}/url`),
+    getMediaUrl: (id) => request(`/public/media/${seg(id)}/url`),
     submitInquiry: (input, context) => request("/public/inquiries", {
       method: "POST",
       body: input,
@@ -165,7 +188,7 @@ function createZalkeraClient(options) {
       context
     }),
     // ── 커머스: 카탈로그 ────────────────────────────────────
-    getProduct: (slug, options2) => request(`/public/products/${encodeURIComponent(slug)}`, nextInit(options2)),
+    getProduct: (slug, options2) => request(`/public/products/${seg(slug)}`, nextInit(options2)),
     listProducts: (params, options2) => request("/public/products", {
       query: {
         productType: params?.productType,
@@ -178,14 +201,14 @@ function createZalkeraClient(options) {
     }),
     listProductCategories: (options2) => request("/public/product-categories", nextInit(options2)),
     // ── 커머스: 상품후기(공개) ──────────────────────────────
-    listProductReviews: (productId, params, options2) => request(`/public/products/${productId}/reviews`, {
+    listProductReviews: (productId, params, options2) => request(`/public/products/${seg(productId)}/reviews`, {
       query: { page: params?.page, size: params?.size },
       next: options2?.tags ? { tags: options2.tags } : void 0
     }),
-    getProductReviewSummary: (productId, options2) => request(`/public/products/${productId}/reviews/summary`, {
+    getProductReviewSummary: (productId, options2) => request(`/public/products/${seg(productId)}/reviews/summary`, {
       next: options2?.tags ? { tags: options2.tags } : void 0
     }),
-    createProductReview: (productId, input, accessToken) => request(`/shop/products/${productId}/reviews`, { method: "POST", body: input, bearer: accessToken }),
+    createProductReview: (productId, input, accessToken) => request(`/shop/products/${seg(productId)}/reviews`, { method: "POST", body: input, bearer: accessToken }),
     // ── 커머스: 고객 인증 ───────────────────────────────────
     socialLogin: (input) => request("/shop/auth/social", { method: "POST", body: input }),
     refreshSession: (refreshToken) => request("/shop/auth/refresh", { method: "POST", body: { refreshToken } }),
@@ -200,11 +223,11 @@ function createZalkeraClient(options) {
     }),
     createBooking: (accessToken, input) => request("/shop/booking/bookings", { method: "POST", body: input, bearer: accessToken }),
     myBookings: (accessToken) => request("/shop/booking/bookings", { bearer: accessToken }),
-    cancelBooking: (accessToken, bookingCode) => request(`/shop/booking/bookings/${encodeURIComponent(bookingCode)}/cancel`, {
+    cancelBooking: (accessToken, bookingCode) => request(`/shop/booking/bookings/${seg(bookingCode)}/cancel`, {
       method: "POST",
       bearer: accessToken
     }),
-    rescheduleBooking: (accessToken, bookingCode, newSlotId) => request(`/shop/booking/bookings/${encodeURIComponent(bookingCode)}/reschedule`, {
+    rescheduleBooking: (accessToken, bookingCode, newSlotId) => request(`/shop/booking/bookings/${seg(bookingCode)}/reschedule`, {
       method: "POST",
       body: { newSlotId },
       bearer: accessToken
@@ -212,33 +235,33 @@ function createZalkeraClient(options) {
     // ── 커머스: 장바구니 ────────────────────────────────────
     getCart: (session) => request("/shop/cart", shopInit(session)),
     addToCart: (variantId, quantity, session) => request("/shop/cart/items", shopInit(session, { method: "POST", body: { variantId, quantity } })),
-    updateCartItem: (variantId, quantity, session) => request(`/shop/cart/items/${variantId}`, shopInit(session, { method: "PATCH", body: { quantity } })),
-    removeFromCart: (variantId, session) => request(`/shop/cart/items/${variantId}`, shopInit(session, { method: "DELETE" })),
+    updateCartItem: (variantId, quantity, session) => request(`/shop/cart/items/${seg(variantId)}`, shopInit(session, { method: "PATCH", body: { quantity } })),
+    removeFromCart: (variantId, session) => request(`/shop/cart/items/${seg(variantId)}`, shopInit(session, { method: "DELETE" })),
     clearCart: (session) => request("/shop/cart", shopInit(session, { method: "DELETE" })),
     // ── 커머스: 결제·주문·배송 ──────────────────────────────
     checkout: (input, session, idempotencyKey) => request("/shop/checkout", shopInit(session, { method: "POST", body: input, idempotencyKey })),
     confirmPayment: (orderNo, providerParams, access) => request(
-      `/shop/orders/${encodeURIComponent(orderNo)}/payment/confirm`,
+      `/shop/orders/${seg(orderNo)}/payment/confirm`,
       accessInit(access, { method: "POST", body: providerParams })
     ),
     startPayment: (orderNo, access) => request(
-      `/shop/orders/${encodeURIComponent(orderNo)}/payment/session`,
+      `/shop/orders/${seg(orderNo)}/payment/session`,
       accessInit(access, { method: "POST" })
     ),
-    getOrder: (orderNo, access) => request(`/shop/orders/${encodeURIComponent(orderNo)}`, accessInit(access)),
+    getOrder: (orderNo, access) => request(`/shop/orders/${seg(orderNo)}`, accessInit(access)),
     listMyOrders: (accessToken, params) => request("/shop/orders", {
       bearer: accessToken,
       query: { page: params?.page, size: params?.size }
     }),
     cancelOrder: (orderNo, access) => request(
-      `/shop/orders/${encodeURIComponent(orderNo)}/cancel`,
+      `/shop/orders/${seg(orderNo)}/cancel`,
       accessInit(access, { method: "POST" })
     ),
     completeOrder: (orderNo, access) => request(
-      `/shop/orders/${encodeURIComponent(orderNo)}/complete`,
+      `/shop/orders/${seg(orderNo)}/complete`,
       accessInit(access, { method: "POST" })
     ),
-    getShipment: (orderNo, access) => request(`/shop/orders/${encodeURIComponent(orderNo)}/shipment`, accessInit(access))
+    getShipment: (orderNo, access) => request(`/shop/orders/${seg(orderNo)}/shipment`, accessInit(access))
   };
 }
 function nextInit(options) {
@@ -254,6 +277,9 @@ function accessInit(access, extra) {
     query: access.phone ? { phone: access.phone } : void 0
   };
 }
+function isRedirectResponse(response) {
+  return response.type === "opaqueredirect" || response.status >= 300 && response.status < 400;
+}
 function safeJsonParse(text) {
   try {
     return JSON.parse(text);
@@ -263,10 +289,13 @@ function safeJsonParse(text) {
 }
 
 // src/sections.ts
-var SECTION_CONTRACT_REV = 1;
+var SECTION_CONTRACT_REV = 2;
 var SECTION_CONTRACT = [
   // 뷰티(memo47) — append-only 계약상 불변
-  { type: "SERVICE_MENU", vertical: "BEAUTY", jsonLd: null },
+  // SERVICE_MENU 의 ItemList 는 rev 2 에서 올라왔다(memo119 T6-ⓒ): 쇼핑몰 유형엔 상품 목록 표면을
+  // 요구하면서 예약 유형엔 시술 목록 표면이 없던 비대칭의 해소다. 뷰티 사이트에서 시술 목록의
+  // 정위치는 별도 라우트가 아니라 홈의 이 섹션이라, FAQ_LIST→FAQPage 와 같은 형태로 섹션이 직접 낸다.
+  { type: "SERVICE_MENU", vertical: "BEAUTY", jsonLd: "ItemList" },
   { type: "BEFORE_AFTER_GALLERY", vertical: "BEAUTY", jsonLd: null },
   { type: "BOOKING_CTA", vertical: "BEAUTY", jsonLd: null },
   { type: "DOCTOR_INTRO", vertical: "BEAUTY", jsonLd: null },
@@ -325,7 +354,7 @@ function asId(value) {
   return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : void 0;
 }
 function mediaSrc(assetId) {
-  return `/media/${assetId}`;
+  return `/media/${seg(assetId)}`;
 }
 
 // src/theme.ts