@uniai-fe/uds-templates 0.4.8 → 0.4.9

package/package.json

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

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;
+}