@zalkera/client 0.14.0 → 0.16.0

package/dist/index.d.cts

@@ -949,7 +949,7 @@ declare class ZalkeraError extends Error {
  * 이 패키지는 그 방언을 읽는 헬퍼([asHandle]·[asHandleArray]·[assetPath]·[readConfig])를 실어 나른다.
  * 그래서 아래 `SECTION_CONTRACT` 리터럴은 rev 3 과 **바이트 동일**하다(동기 스크립트가 확인한다).
  */
-declare const SECTION_CONTRACT_REV = 4;
+declare const SECTION_CONTRACT_REV = 5;
 /** 업종 분류 — 콘솔 섹션 픽커의 그룹핑에 쓴다(테넌트 업종 필드는 아직 없다·memo102 §5). */
 type SectionVertical = "BEAUTY" | "GENERAL";
 interface SectionSpec {
@@ -972,6 +972,17 @@ interface SectionSpec {
      * **필수성의 집행 지점은 팩/시드뿐이다** — 런타임은 그대로 관용이다(렌더러 스킵·콘솔 raw 편집 허용).
      */
     readonly requiredRefs: readonly string[];
+    /**
+     * **참조 그룹**(rev 5) — 각 그룹에서 **하나 이상**이 채워져야 한다.
+     *
+     * rev 3 은 필수성을 키 하나(`productIds`)에 걸었는데, rev 5 에서 갈래 참조(`categorySlug`)가 같은
+     * 역할을 하게 되면서 필수의 단위가 **"참조 존재"**로 옮겨갔다. 막으려는 것은 그대로다 — 아무것도
+     * 안 가리킨 채 시드에 들어와 개시 직후 조용히 사라지는 섹션.
+     *
+     * `requiredRefs`(무조건 필수)와 **함께** 쓴다: 그룹으로 표현되는 섹션은 `requiredRefs` 가 빈 배열이고,
+     * 종전처럼 단일 키가 무조건 필수인 섹션은 이 필드가 빈 배열이다. 둘 다 빈 배열이면 참조 요구가 없다.
+     */
+    readonly requiredRefsAnyOf: readonly (readonly string[])[];
 }
 /**
  * 아는 섹션 전량. **순서는 콘솔 픽커의 노출 순서**(관행 아크: 주목→가치→신뢰→행동).
@@ -985,62 +996,74 @@ declare const SECTION_CONTRACT: readonly [{
     readonly type: "SERVICE_MENU";
     readonly vertical: "BEAUTY";
     readonly jsonLd: "ItemList";
-    readonly requiredRefs: readonly ["productIds"];
+    readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [readonly ["productIds", "categorySlug"]];
 }, {
     readonly type: "BEFORE_AFTER_GALLERY";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "BOOKING_CTA";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
-    readonly requiredRefs: readonly ["productId"];
+    readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [readonly ["productId", "categorySlug"]];
 }, {
     readonly type: "DOCTOR_INTRO";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "HERO";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "FEATURE_GRID";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "TEXT_MEDIA";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "LOGO_WALL";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "STATS_BAND";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "TESTIMONIALS";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "FAQ_LIST";
     readonly vertical: "GENERAL";
     readonly jsonLd: "FAQPage";
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "LEAD_CTA";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }];
 /** 지금 렌더러가 아는 섹션 타입. 이 밖의 값이 와도 정상이다(스킵). */
 type KnownSectionType = (typeof SECTION_CONTRACT)[number]["type"];

package/dist/index.d.ts

@@ -949,7 +949,7 @@ declare class ZalkeraError extends Error {
  * 이 패키지는 그 방언을 읽는 헬퍼([asHandle]·[asHandleArray]·[assetPath]·[readConfig])를 실어 나른다.
  * 그래서 아래 `SECTION_CONTRACT` 리터럴은 rev 3 과 **바이트 동일**하다(동기 스크립트가 확인한다).
  */
-declare const SECTION_CONTRACT_REV = 4;
+declare const SECTION_CONTRACT_REV = 5;
 /** 업종 분류 — 콘솔 섹션 픽커의 그룹핑에 쓴다(테넌트 업종 필드는 아직 없다·memo102 §5). */
 type SectionVertical = "BEAUTY" | "GENERAL";
 interface SectionSpec {
@@ -972,6 +972,17 @@ interface SectionSpec {
      * **필수성의 집행 지점은 팩/시드뿐이다** — 런타임은 그대로 관용이다(렌더러 스킵·콘솔 raw 편집 허용).
      */
     readonly requiredRefs: readonly string[];
+    /**
+     * **참조 그룹**(rev 5) — 각 그룹에서 **하나 이상**이 채워져야 한다.
+     *
+     * rev 3 은 필수성을 키 하나(`productIds`)에 걸었는데, rev 5 에서 갈래 참조(`categorySlug`)가 같은
+     * 역할을 하게 되면서 필수의 단위가 **"참조 존재"**로 옮겨갔다. 막으려는 것은 그대로다 — 아무것도
+     * 안 가리킨 채 시드에 들어와 개시 직후 조용히 사라지는 섹션.
+     *
+     * `requiredRefs`(무조건 필수)와 **함께** 쓴다: 그룹으로 표현되는 섹션은 `requiredRefs` 가 빈 배열이고,
+     * 종전처럼 단일 키가 무조건 필수인 섹션은 이 필드가 빈 배열이다. 둘 다 빈 배열이면 참조 요구가 없다.
+     */
+    readonly requiredRefsAnyOf: readonly (readonly string[])[];
 }
 /**
  * 아는 섹션 전량. **순서는 콘솔 픽커의 노출 순서**(관행 아크: 주목→가치→신뢰→행동).
@@ -985,62 +996,74 @@ declare const SECTION_CONTRACT: readonly [{
     readonly type: "SERVICE_MENU";
     readonly vertical: "BEAUTY";
     readonly jsonLd: "ItemList";
-    readonly requiredRefs: readonly ["productIds"];
+    readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [readonly ["productIds", "categorySlug"]];
 }, {
     readonly type: "BEFORE_AFTER_GALLERY";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "BOOKING_CTA";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
-    readonly requiredRefs: readonly ["productId"];
+    readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [readonly ["productId", "categorySlug"]];
 }, {
     readonly type: "DOCTOR_INTRO";
     readonly vertical: "BEAUTY";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "HERO";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "FEATURE_GRID";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "TEXT_MEDIA";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "LOGO_WALL";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "STATS_BAND";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "TESTIMONIALS";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "FAQ_LIST";
     readonly vertical: "GENERAL";
     readonly jsonLd: "FAQPage";
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }, {
     readonly type: "LEAD_CTA";
     readonly vertical: "GENERAL";
     readonly jsonLd: null;
     readonly requiredRefs: readonly [];
+    readonly requiredRefsAnyOf: readonly [];
 }];
 /** 지금 렌더러가 아는 섹션 타입. 이 밖의 값이 와도 정상이다(스킵). */
 type KnownSectionType = (typeof SECTION_CONTRACT)[number]["type"];

package/dist/index.js

@@ -104,15 +104,25 @@ function createZalkeraClient(options) {
     if (init?.bearer) headers["Authorization"] = `Bearer ${init.bearer}`;
     if (init?.cartSession) headers["X-Cart-Session"] = init.cartSession;
     if (init?.idempotencyKey) headers["Idempotency-Key"] = init.idempotencyKey;
+    const method = init?.method ?? "GET";
+    const isRead = method === "GET";
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeoutMs);
+    let timedOut = false;
+    const deadline = new Promise((_, reject) => {
+      setTimeout(() => {
+        timedOut = true;
+        reject(new Error("AbortError"));
+      }, timeoutMs).unref?.();
+    });
     let response;
     try {
       const fetchInit = {
-        method: init?.method ?? "GET",
+        method,
         headers,
         body: init?.body != null ? JSON.stringify(init.body) : void 0,
-        signal: controller.signal,
+        // 읽기는 위 이유로 signal 을 뺀다(메모이제이션 보존).
+        ...isRead ? {} : { signal: controller.signal },
         // 리다이렉트를 따라가지 않는다 — **보안 불변식이라 스위치를 두지 않는다**(옵션으로 열면
         // 그 옵션이 곧 사고 경로가 된다). 기본값 `follow` 로 크로스오리진 3xx 를 따라가면
         // `X-Storefront-Key`(테넌트 시크릿)·`X-Tenant`·`X-Cart-Session`·`Idempotency-Key` 가
@@ -122,9 +132,10 @@ function createZalkeraClient(options) {
         redirect: "manual"
       };
       if (init?.next) fetchInit.next = init.next;
-      response = await fetchImpl(url.toString(), fetchInit);
+      const call = fetchImpl(url.toString(), fetchInit);
+      response = isRead ? await Promise.race([call, deadline]) : await call;
     } catch (cause) {
-      const aborted = cause instanceof Error && cause.name === "AbortError";
+      const aborted = timedOut || cause instanceof Error && cause.name === "AbortError";
       throw new ZalkeraError(
         aborted ? `\uC694\uCCAD \uC2DC\uAC04\uC774 \uCD08\uACFC\uB418\uC5C8\uC2B5\uB2C8\uB2E4 (${timeoutMs}ms)` : "\uB124\uD2B8\uC6CC\uD06C \uC694\uCCAD\uC774 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.",
         { status: 0, cause }
@@ -290,7 +301,7 @@ function safeJsonParse(text) {
 }
 
 // src/sections.ts
-var SECTION_CONTRACT_REV = 4;
+var SECTION_CONTRACT_REV = 5;
 var SECTION_CONTRACT = [
   // 뷰티(memo47) — append-only 계약상 불변
   // SERVICE_MENU 의 ItemList 는 rev 2 에서 올라왔다(memo119 T6-ⓒ): 쇼핑몰 유형엔 상품 목록 표면을
@@ -298,19 +309,19 @@ var SECTION_CONTRACT = [
   // 정위치는 별도 라우트가 아니라 홈의 이 섹션이라, FAQ_LIST→FAQPage 와 같은 형태로 섹션이 직접 낸다.
   // rev 3 에서 productIds 의 `?` 가 떨어졌다 — 목록을 내겠다고 선언한 섹션이 목록을 안 가리키는 상태가
   // 계약상 성립하지 않게 됐다(BOOKING_CTA.productId 는 rev 1 부터 필수였다·비대칭 해소).
-  { type: "SERVICE_MENU", vertical: "BEAUTY", jsonLd: "ItemList", requiredRefs: ["productIds"] },
-  { type: "BEFORE_AFTER_GALLERY", vertical: "BEAUTY", jsonLd: null, requiredRefs: [] },
-  { type: "BOOKING_CTA", vertical: "BEAUTY", jsonLd: null, requiredRefs: ["productId"] },
-  { type: "DOCTOR_INTRO", vertical: "BEAUTY", jsonLd: null, requiredRefs: [] },
+  { type: "SERVICE_MENU", vertical: "BEAUTY", jsonLd: "ItemList", requiredRefs: [], requiredRefsAnyOf: [["productIds", "categorySlug"]] },
+  { type: "BEFORE_AFTER_GALLERY", vertical: "BEAUTY", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "BOOKING_CTA", vertical: "BEAUTY", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [["productId", "categorySlug"]] },
+  { type: "DOCTOR_INTRO", vertical: "BEAUTY", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
   // 기업 마케팅(memo102 §2)
-  { type: "HERO", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "FEATURE_GRID", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "TEXT_MEDIA", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "LOGO_WALL", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "STATS_BAND", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "TESTIMONIALS", vertical: "GENERAL", jsonLd: null, requiredRefs: [] },
-  { type: "FAQ_LIST", vertical: "GENERAL", jsonLd: "FAQPage", requiredRefs: [] },
-  { type: "LEAD_CTA", vertical: "GENERAL", jsonLd: null, requiredRefs: [] }
+  { type: "HERO", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "FEATURE_GRID", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "TEXT_MEDIA", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "LOGO_WALL", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "STATS_BAND", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "TESTIMONIALS", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "FAQ_LIST", vertical: "GENERAL", jsonLd: "FAQPage", requiredRefs: [], requiredRefsAnyOf: [] },
+  { type: "LEAD_CTA", vertical: "GENERAL", jsonLd: null, requiredRefs: [], requiredRefsAnyOf: [] }
 ];
 function sectionsOfVertical(vertical) {
   return SECTION_CONTRACT.filter((s) => s.vertical === vertical);