@zalkera/client 0.24.2 → 0.24.3

package/bin/check-aeo-surfaces.mjs

@@ -188,7 +188,8 @@ function isInternalHost(host) {
  *   이미 적어 두었다.
  */
 function embeddedIPv4(host) {
-    // ⚠ `::` 는 **접두가 없는** 형태라 마지막에 둔다 — 앞에 두면 `::ffff:` 를 그것으로 먼저 삼킨다.
+    // `::` 는 **접두가 없는** 형태라 마지막에 둔다. (JS 정규식 교대는 백트래킹하므로 앞에 둬도
+    // 결과는 같다 — 실측으로 7개 프로브 전부 동일. 읽는 사람이 「좁은 것부터」로 읽게 두는 배치다.)
     const PREFIX = "(?:::ffff:|64:ff9b::|::)";
     const dotted = new RegExp(`^${PREFIX}(\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3})$`, "i").exec(host);
     if (dotted) return dotted[1];

package/bin/validate-storefront.mjs

@@ -1926,17 +1926,29 @@ function echoValue(value) {
  * 위치(`at position N` · `line L column C`)는 남긴다 — 고치는 사람이 어디를 볼지 알아야 한다.
  * 그 숫자는 내용이 아니다.
  */
+/**
+ * JSON 의 **구조 문자**. 이것만 반려문에 실어도 내용이 새지 않는다 — 값에는 못 나오는 글자들이다
+ * (따옴표 안이면 파싱이 안 깨지고, 깨졌다는 것은 그 자리가 구조라는 뜻이다).
+ */
+const STRUCTURAL_JSON = new Set([",", ":", "{", "}", "[", "]", '"', "'", " ", "\t", "\n", "\r"]);
+
 function parseWhere(error) {
     const raw = String(error?.message ?? "");
     const where = /(?:at position \d+(?:\s*\(line \d+ column \d+\))?|line \d+ column \d+)/.exec(raw);
-    // ⚠ **어느 글자에서 걸렸는지만** 남긴다. Node 는 그 글자를 따옴표로 싸서 주는데, 그 한 글자는
-    //    구조 정보(쉼표·중괄호)이지 내용이 아니다. 그 **뒤**에 붙는 `..."조각"` 이 위험한 부분이다.
-    const token = /^Unexpected token ('.'|".")/.exec(raw);
-    const head = token
-        ? `예상하지 못한 글자 ${token[1]}`
-        : /Unexpected end of JSON input/.test(raw)
-          ? "내용이 도중에 끝났습니다"
-          : "형식이 올바르지 않습니다";
+    // ⚠ **걸린 글자는 구조 문자일 때만 싣는다.** 「그 한 글자는 구조 정보이지 내용이 아니다」는
+    //    **거짓이다** — 값이 따옴표 없이 적혀 있으면 그 글자는 **값의 첫 글자**다(실측: 시크릿을
+    //    비인용으로 두면 그 첫 글자가 반려문에 실린다). 회당 한 글자라도 여기서 내보내지 않는다.
+    //    구조 문자면 그대로 두는 이유: 「쉼표가 하나 더 있습니다」는 고치는 사람에게 실제로 쓸모가 있다.
+    const token = /^Unexpected token ('(.)'|"(.)")/.exec(raw);
+    const glyph = token ? (token[2] ?? token[3]) : null;
+    const head =
+        glyph !== null && STRUCTURAL_JSON.has(glyph)
+            ? `예상하지 못한 글자 '${glyph}'`
+            : glyph !== null
+              ? "값이 따옴표 없이 적혀 있거나 표기가 잘못됐습니다"
+              : /Unexpected end of JSON input/.test(raw)
+                ? "내용이 도중에 끝났습니다"
+                : "형식이 올바르지 않습니다";
     return where ? `${head} (${where[0]})` : head;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zalkera/client",
-    "version": "0.24.2",
+    "version": "0.24.3",
     "description": "zalkera 헤드리스 CMS 공개 API 클라이언트 (테넌트 사이트용)",
     "license": "MIT",
     "author": "Credium Co., Ltd.",