@uniai-fe/uds-templates 0.4.8 → 0.4.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniai-fe/uds-templates",
-  "version": "0.4.8",
+  "version": "0.4.10",
   "description": "UNIAI Design System; UI Templates Package",
   "type": "module",
   "private": false,

package/src/service-inquiry/Icon.svg

@@ -0,0 +1,5 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M12 15C12.5523 15 13 15.4477 13 16C13 16.5523 12.5523 17 12 17C11.4477 17 11 16.5523 11 16C11 15.4477 11.4477 15 12 15Z" fill="#313235"/>
+<path d="M11.998 7.2002C13.2476 7.2002 14.3376 8.05045 14.6406 9.2627C14.7662 9.76506 14.7458 10.2929 14.582 10.7842L14.5293 10.9414C14.2978 11.6359 13.8415 12.2335 13.2324 12.6396L12.7998 12.9277V13.5C12.7998 13.9418 12.4418 14.2998 12 14.2998C11.5582 14.2998 11.2002 13.9418 11.2002 13.5V12.5889C11.2003 12.2658 11.362 11.9644 11.6309 11.7852L12.3447 11.3086C12.6578 11.0998 12.8927 10.7926 13.0117 10.4355L13.0635 10.2783C13.131 10.0757 13.1397 9.85761 13.0879 9.65039C12.9628 9.1506 12.5133 8.79981 11.998 8.7998H11.9404C11.4248 8.7998 10.9668 9.12998 10.8037 9.61914L10.7588 9.75293C10.6191 10.1721 10.1662 10.3985 9.74707 10.2588C9.32792 10.1191 9.10149 9.66622 9.24121 9.24707L9.28613 9.11328C9.66698 7.97078 10.7361 7.2002 11.9404 7.2002H11.998Z" fill="#313235"/>
+<path fill-rule="evenodd" clip-rule="evenodd" d="M12 2.2002C17.4124 2.2002 21.7998 6.58761 21.7998 12C21.7998 17.4124 17.4124 21.7998 12 21.7998C10.1462 21.7998 8.41115 21.2835 6.93164 20.3877L4.3125 21.3643C3.26584 21.7545 2.2468 20.7301 2.64258 19.6855L3.625 17.0898C2.72126 15.6057 2.2002 13.8627 2.2002 12C2.2002 6.58761 6.58761 2.2002 12 2.2002ZM12 3.7998C7.47126 3.7998 3.7998 7.47126 3.7998 12C3.7998 13.6028 4.25928 15.0964 5.05273 16.3584C5.26539 16.6969 5.3223 17.1274 5.17188 17.5244L4.37207 19.6338L6.50488 18.8398L6.6543 18.7939C6.95446 18.7215 7.2638 18.7605 7.53125 18.8887L7.66211 18.96L7.90039 19.1035C9.10585 19.8009 10.5053 20.2002 12 20.2002C16.5287 20.2002 20.2002 16.5287 20.2002 12C20.2002 7.47126 16.5287 3.7998 12 3.7998Z" fill="#313235"/>
+</svg>

package/src/service-inquiry/hooks/useUserContext.ts

@@ -1,6 +1,8 @@
 "use client";
 
+import { usePathname, useSearchParams } from "next/navigation";
 import { useAtom, useAtomValue } from "jotai";
+import { useMemo } from "react";
 import type {
   ServiceInquiryUserContext,
   UseServiceInquiryUserContextReturn,
@@ -20,9 +22,22 @@ import {
 export function useServiceInquiryUserContext(): UseServiceInquiryUserContextReturn {
   /** 1) form init — request context snapshot과 trigger 추가 context를 atom 기반으로 읽는다. */
   const requestContext = useAtomValue(serviceInquiryRequestContextAtom);
+  const pathname = usePathname();
+  const searchParams = useSearchParams();
   const [additionalUserContext, setAdditionalUserContext] = useAtom(
     serviceInquiryAdditionalUserContextAtom,
   );
+  const resolvedRequestContext = useMemo(
+    () => ({
+      ...requestContext,
+      // 변경 설명: route 이동 후에도 문의 submit 시점의 현재 URL이 page_path로 반영되도록 route 변화에 맞춰 snapshot을 새로 만든다.
+      page_path:
+        typeof window === "undefined"
+          ? requestContext.page_path
+          : window.location.href,
+    }),
+    [pathname, requestContext, searchParams],
+  );
 
   /** 2) submit/액션 — trigger별 추가 context를 append/reset 할 수 있게 연다. */
   const setNextAdditionalUserContext: UseServiceInquiryUserContextReturn["setAdditionalUserContext"] =
@@ -48,7 +63,7 @@ export function useServiceInquiryUserContext(): UseServiceInquiryUserContextRetu
     };
 
   return {
-    requestContext,
+    requestContext: resolvedRequestContext,
     additionalUserContext,
     setAdditionalUserContext: setNextAdditionalUserContext,
     appendUserContext,

package/src/service-inquiry/index.tsx

@@ -8,6 +8,10 @@ import {
   useServiceInquiryUserContext,
 } from "./hooks";
 import { createServiceInquiryModal } from "./utils/modal-option";
+import {
+  getServiceInquiryDebugHeaders,
+  parseResponseWithServiceInquiryDebug,
+} from "./utils/network-debug";
 
 /**
  * Service Inquiry; 문의 form + modal option 엔트리
@@ -21,6 +25,8 @@ export const ServiceInquiry = {
   useProvideContext: useProvideServiceInquiryContext,
   useUserContext: useServiceInquiryUserContext,
   createModal: createServiceInquiryModal,
+  getNetworkDebugHeaders: getServiceInquiryDebugHeaders,
+  parseResponseDebug: parseResponseWithServiceInquiryDebug,
 };
 
 export {
@@ -31,5 +37,7 @@ export {
   useProvideServiceInquiryContext,
   useServiceInquiryUserContext,
   createServiceInquiryModal,
+  getServiceInquiryDebugHeaders,
+  parseResponseWithServiceInquiryDebug,
 };
 export type * from "./types";

package/src/service-inquiry/types/hooks.ts

@@ -19,12 +19,44 @@ export interface ServiceInquiryProvidedContext {
   userContext?: ServiceInquiryUserContext | null;
 }
 
+/**
+ * Service Inquiry Hook; 네트워크 오류 헤더 요약
+ * @property {string} [uniai_native_domain] 응답 헤더 `Uniai-Native-Domain`
+ * @property {string} [uniai_native_path] 응답 헤더 `Uniai-Native-Path`
+ * @property {string} [uniai_native_url] 응답 헤더 `Uniai-Native-URL`
+ * @property {string} [content_type] 응답 헤더 `content-type`
+ * @property {boolean} [has_authorization] 요청 헤더에 Authorization 존재 여부
+ */
+export interface ServiceInquiryNetworkErrorHeaders {
+  /**
+   * 응답 헤더 `Uniai-Native-Domain`
+   */
+  uniai_native_domain?: string;
+  /**
+   * 응답 헤더 `Uniai-Native-Path`
+   */
+  uniai_native_path?: string;
+  /**
+   * 응답 헤더 `Uniai-Native-URL`
+   */
+  uniai_native_url?: string;
+  /**
+   * 응답 헤더 `content-type`
+   */
+  content_type?: string;
+  /**
+   * 요청 헤더에 Authorization 존재 여부
+   */
+  has_authorization?: boolean;
+}
+
 /**
  * Service Inquiry Hook; 네트워크 오류 기록
  * @property {string} [route] 요청 route 또는 endpoint
  * @property {number} [code] HTTP status code
  * @property {string} [state] 서비스 레이어 상태 문자열
  * @property {string} [message] 사용자/운영 확인용 오류 메시지
+ * @property {ServiceInquiryNetworkErrorHeaders} [headers] 선택 수집된 request/response 헤더 정보
  * @property {string} [timestamp] 오류 기록 시각
  */
 export interface ServiceInquiryNetworkError {
@@ -44,6 +76,10 @@ export interface ServiceInquiryNetworkError {
    * 사용자/운영 확인용 오류 메시지
    */
   message?: string;
+  /**
+   * 선택 수집된 request/response 헤더 정보
+   */
+  headers?: ServiceInquiryNetworkErrorHeaders;
   /**
    * 오류 기록 시각
    */

package/src/service-inquiry/utils/network-debug.ts

@@ -0,0 +1,112 @@
+import type { ServiceInquiryNetworkErrorHeaders } from "../types";
+
+/**
+ * Service Inquiry Utility; Authorization 헤더 존재 여부 판별
+ * @param {HeadersInit} [requestHeaders] 요청 헤더
+ * @returns {boolean} Authorization 헤더 존재 여부
+ * @example
+ * const hasAuthorization = resolveServiceInquiryHasAuthorization({
+ *   Authorization: "Bearer token",
+ * });
+ */
+const resolveServiceInquiryHasAuthorization = (
+  requestHeaders?: HeadersInit,
+): boolean => {
+  if (!requestHeaders) {
+    return false;
+  }
+
+  return new Headers(requestHeaders).has("Authorization");
+};
+
+/**
+ * Service Inquiry Utility; 선택 디버그 헤더 추출
+ * @param {Headers} responseHeaders 응답 헤더
+ * @param {HeadersInit} [requestHeaders] 요청 헤더
+ * @returns {ServiceInquiryNetworkErrorHeaders | undefined} service-inquiry에 기록할 최소 헤더 정보
+ * @example
+ * const headers = pickServiceInquiryDebugHeaders(response.headers, {
+ *   Authorization: "Bearer token",
+ * });
+ */
+const pickServiceInquiryDebugHeaders = (
+  responseHeaders: Headers,
+  requestHeaders?: HeadersInit,
+): ServiceInquiryNetworkErrorHeaders | undefined => {
+  const headers: ServiceInquiryNetworkErrorHeaders = {
+    uniai_native_domain:
+      responseHeaders.get("Uniai-Native-Domain") ?? undefined,
+    uniai_native_path: responseHeaders.get("Uniai-Native-Path") ?? undefined,
+    uniai_native_url: responseHeaders.get("Uniai-Native-URL") ?? undefined,
+    content_type: responseHeaders.get("content-type") ?? undefined,
+    has_authorization: resolveServiceInquiryHasAuthorization(requestHeaders),
+  };
+
+  if (
+    !headers.uniai_native_domain &&
+    !headers.uniai_native_path &&
+    !headers.uniai_native_url &&
+    !headers.content_type &&
+    !headers.has_authorization
+  ) {
+    return undefined;
+  }
+
+  return headers;
+};
+
+/**
+ * Service Inquiry Utility; 응답 payload에 디버그 헤더 주입
+ * @param {Response} response fetch 응답 객체
+ * @param {HeadersInit} [requestHeaders] 요청 헤더
+ * @returns {Promise<ResponseData>} 선택 디버그 헤더가 포함된 응답 payload
+ * @example
+ * const payload = await parseResponseWithServiceInquiryDebug(response, {
+ *   Authorization: "Bearer token",
+ * });
+ */
+export async function parseResponseWithServiceInquiryDebug<
+  ResponseData extends object,
+>(response: Response, requestHeaders?: HeadersInit): Promise<ResponseData> {
+  const payload = (await response.json()) as ResponseData;
+  const headers = pickServiceInquiryDebugHeaders(
+    response.headers,
+    requestHeaders,
+  );
+
+  if (!headers) {
+    return payload;
+  }
+
+  // 변경 설명: service-inquiry 네트워크 기록에 필요한 최소 header 정보만 응답 payload에 숨겨서 전달한다.
+  return Object.assign(payload, {
+    _service_inquiry_debug: {
+      headers,
+    },
+  });
+}
+
+/**
+ * Service Inquiry Utility; 응답 payload에서 디버그 헤더 읽기
+ * @param {unknown} response service 응답 payload
+ * @returns {ServiceInquiryNetworkErrorHeaders | undefined} 숨겨서 실은 디버그 헤더
+ * @example
+ * const headers = getServiceInquiryDebugHeaders(response);
+ */
+export function getServiceInquiryDebugHeaders(
+  response: unknown,
+): ServiceInquiryNetworkErrorHeaders | undefined {
+  if (!response || typeof response !== "object") {
+    return undefined;
+  }
+
+  const debugData = (
+    response as {
+      _service_inquiry_debug?: {
+        headers?: ServiceInquiryNetworkErrorHeaders;
+      };
+    }
+  )._service_inquiry_debug;
+
+  return debugData?.headers;
+}