@uniai-fe/uds-templates 0.5.24 → 0.5.26

package/package.json

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

package/src/cctv/apis/client.ts

@@ -16,11 +16,13 @@ export const getClientCctvCompanyList = async ({
 
 export const useQueryCctvCompanyList = ({
   url,
+  queryKeyDeps = [],
 }: {
   url?: string;
+  queryKeyDeps?: readonly unknown[];
 }): UseQueryResult<API_Res_CctvCompany> =>
   useQuery({
-    queryKey: ["cctv_company_list", url],
+    queryKey: ["cctv_company_list", url, ...queryKeyDeps],
     queryFn: () => getClientCctvCompanyList({ url }),
   });
 

package/src/cctv/components/cam-list/Item.tsx

@@ -51,7 +51,7 @@ export default function CCTVCamListItem({
           activeLiveState: true,
           activeTitle: false,
           isLive,
-          isShared: typeof cam.cam_shared === "boolean" ? cam.cam_shared : true,
+          isShared: cam.is_public === true,
           title: cam.cam_name,
         }}
         footerOptions={{ activeTitle: true, activeOpenButton: true, cam }}

package/src/cctv/components/pagination/list/Item.tsx

@@ -54,8 +54,7 @@ export default function CCTVPaginationListItem({
             activeLiveState: true,
             activeTitle: false,
             isLive,
-            isShared:
-              typeof cam.cam_shared === "boolean" ? cam.cam_shared : true,
+            isShared: cam.is_public === true,
             title: cam.cam_name,
           }}
           footerOptions={{ cam }}

package/src/cctv/components/viewer/desktop/Video.tsx

@@ -51,7 +51,7 @@ export default function CCTVViewerDesktopVideo({
         activeTitle: true,
         activeCloseButton: true,
         isLive,
-        isShared: typeof cam?.cam_shared === "boolean" ? cam.cam_shared : true,
+        isShared: cam?.is_public === true,
         title: cam?.cam_name,
       }}
       footerOptions={{ activeTitle: false }}

package/src/cctv/hooks/useCompanyData.tsx

@@ -14,6 +14,7 @@ import type {
  * @hook
  * @param {UseCctvCompanyDataParams} [params] 훅 파라미터
  * @property {string} [url] 회사 리스트 API URL (Provider에서 주입된 기본값 대신 사용)
+ * @property {readonly unknown[]} [queryKeyDeps] 회사 리스트 캐시 분리용 query key deps
  * @return {UseCctvCompanyDataReturn} 회사 리스트 쿼리 반환값
  * @desc
  * return {
@@ -26,8 +27,8 @@ import type {
 export default function useCctvCompanyData(
   params?: UseCctvCompanyDataParams,
 ): UseCctvCompanyDataReturn {
-  // 변경: list 조회 계약은 URL만 override 대상으로 유지한다.
-  const { url } = params || {};
+  // 변경: list 조회 계약은 URL override와 캐시 분리 deps만 소비한다.
+  const { url, queryKeyDeps } = params || {};
 
   const { listUrl } = useCctvApiUrl();
   const resolvedUrl = useMemo(() => url ?? listUrl, [url, listUrl]);
@@ -36,6 +37,7 @@ export default function useCctvCompanyData(
   // URL에 맞춰 회사 리스트 API를 호출한다.
   const { data, isFetching, isError, ...rest } = useQueryCctvCompanyList({
     url: resolvedUrl,
+    queryKeyDeps,
   });
 
   // 응답 데이터를 react-hook-form rawData 필드로 반영한다.

package/src/cctv/hooks/useContext.ts

@@ -118,8 +118,6 @@ export default function useCctvContext(): UseCctvContextReturn {
           onSelect: () => onSelectCompany(d.company_id),
           cam_list: d.cam_list.map((cam: CctvCompanyCameraList) => ({
             ...cam,
-            cam_shared:
-              typeof cam.cam_shared === "boolean" ? cam.cam_shared : true,
             selected: cam.cam_id === selectedCamId,
             onSelect: () => onOpenCamera(cam.cam_id),
           })),

package/src/cctv/types/api.ts

@@ -1,5 +1,4 @@
 import type { API_Res_Base } from "@uniai-fe/util-api";
-import type { UtilQueryBaseParams } from "@uniai-fe/util-functions";
 import type { NextRequest } from "next/server";
 
 /**
@@ -29,44 +28,180 @@ export interface API_Req_GetCompanyListParams {
 }
 
 /**
- * CCTV: 업체에 설치된 카메라 목록
+ * CCTV; 카메라 식별 응답 구조
  * @property {string} cam_id 카메라 id코드
- * @property {string} cam_name 카메라 별칭
- * @property {boolean} cam_online 카메라 설치상태
- * @property {string} [cam_rtc] 카메라 스트리밍 WebRTC 경로
- * @property {string} [cam_rtcp] 카메라 RTCP 경로
- * @property {boolean} [cam_shared] 카메라 외부공유 여부
  */
-export interface API_Res_CctvCompanyCameraList {
-  // API 응답은 데이터-only 구조이므로 UI 전용 콜백은 포함하지 않는다.
+export interface API_Res_CctvCameraIdentity {
   /**
    * 카메라 ID (번호)
    */
   cam_id: string;
+}
+
+/**
+ * CCTV; 카메라 기본 메타데이터 응답 구조
+ * @property {string} cam_id 카메라 id코드
+ * @property {string} cam_name 카메라 별칭
+ */
+export interface API_Res_CctvCameraMeta extends API_Res_CctvCameraIdentity {
   /**
    * 카메라 이름
    * ex) 1동, 2동, ..., 외부1, 외부2, ...
    */
   cam_name: string;
+}
+
+/**
+ * CCTV; 카메라 스트림 path 응답 구조
+ * @property {string} stream_path 카메라 스트림 path
+ */
+export interface API_Res_CctvCameraStreamPath {
   /**
-   * 카메라 설치 상태
+   * 스트림 path
+   * ex) cam1, cam7
    */
-  cam_online: boolean;
+  stream_path: string;
+}
+
+/**
+ * CCTV; 카메라 RTC/RTSP 경로 응답 구조
+ * @property {string} cam_rtc 카메라 스트리밍 WebRTC 경로
+ * @property {string} cam_rtcp 카메라 RTCP 경로
+ * @property {string} cam_rtsp 카메라 RTSP 경로
+ */
+export interface API_Res_CctvCameraRtc {
   /**
    * RTC 경로
    * https://{company_id}.rtc.uniai.com/cam{cam_id}
    */
-  cam_rtc?: string;
+  cam_rtc: string;
   /**
    * RTCP 경로
    */
-  cam_rtcp?: string;
+  cam_rtcp: string;
   /**
-   * 외부공유 상태
+   * RTSP 경로
    */
-  cam_shared?: boolean;
+  cam_rtsp: string;
 }
 
+/**
+ * CCTV; 카메라 스트림 경로 응답 구조
+ * @property {string} stream_path 카메라 스트림 path
+ * @property {string} cam_rtc 카메라 스트리밍 WebRTC 경로
+ * @property {string} cam_rtcp 카메라 RTCP 경로
+ * @property {string} cam_rtsp 카메라 RTSP 경로
+ */
+export interface API_Res_CctvCameraStream
+  extends API_Res_CctvCameraStreamPath, API_Res_CctvCameraRtc {}
+
+/**
+ * CCTV; 카메라 외부공유 응답 구조
+ * @property {boolean} is_public 카메라 외부공유 여부
+ */
+export interface API_Res_CctvCameraVisibility {
+  /**
+   * 카메라 외부공유 여부
+   */
+  is_public: boolean;
+}
+
+/**
+ * CCTV; 카메라 외부시청 상태 응답 구조
+ * @property {boolean} is_watching 외부시청 중 여부
+ * @property {number} viewer_count 현재 외부시청 세션 수
+ */
+export interface API_Res_CctvCameraViewerStatus {
+  /**
+   * 외부시청 중 여부
+   */
+  is_watching: boolean;
+  /**
+   * 현재 외부시청 세션 수
+   */
+  viewer_count: number;
+}
+
+/**
+ * CCTV; 카메라 목록의 각 카메라 응답 데이터
+ * @property {string} cam_id
+ * @property {string} cam_name
+ * @property {string} cam_rtc
+ * @property {string} cam_rtcp
+ * @property {string} cam_rtsp
+ * @property {string} stream_path
+ * @property {boolean} is_public
+ * @property {boolean} is_watching
+ * @property {number} viewer_count
+ */
+export interface API_Res_CctvCameraData
+  extends
+    API_Res_CctvCameraMeta,
+    API_Res_CctvCameraStream,
+    API_Res_CctvCameraVisibility,
+    API_Res_CctvCameraViewerStatus {}
+
+/**
+ * CCTV: 업체에 설치된 카메라 목록
+ * @property {string} cam_id 카메라 id코드
+ * @property {string} cam_name 카메라 별칭
+ * @property {boolean} cam_online 카메라 설치상태
+ * @property {string} cam_rtc 카메라 스트리밍 WebRTC 경로
+ * @property {string} cam_rtcp 카메라 RTCP 경로
+ * @property {string} cam_rtsp 카메라 RTSP 경로
+ * @property {string} stream_path 카메라 스트림 path
+ * @property {boolean} is_public 카메라 외부공유 여부
+ * @property {boolean} is_watching 외부시청 중 여부
+ * @property {number} viewer_count 현재 외부시청 세션 수
+ */
+export interface API_Res_CctvCompanyCameraList extends API_Res_CctvCameraData {
+  // API 응답은 데이터-only 구조이므로 UI 전용 콜백은 포함하지 않는다.
+  /**
+   * 카메라 설치 상태
+   */
+  cam_online: boolean;
+}
+
+/**
+ * CCTV; 카메라 외부시청 상태 응답 데이터
+ * @property {string} company_id 업체 id코드
+ * @property {string} cam_id 카메라 id코드
+ * @property {string} stream_path 카메라 스트림 path
+ * @property {boolean} is_public 카메라 외부공유 여부
+ * @property {boolean} is_watching 외부시청 중 여부
+ * @property {number} viewer_count 현재 외부시청 세션 수
+ */
+export interface API_Res_CctvViewerStatusData
+  extends
+    API_Res_CctvCameraIdentity,
+    API_Res_CctvCameraStreamPath,
+    API_Res_CctvCameraVisibility,
+    API_Res_CctvCameraViewerStatus {
+  /**
+   * 업체 ID
+   */
+  company_id: string;
+  /**
+   * 스트림 path
+   */
+  stream_path: string;
+  /**
+   * 외부시청 중 여부
+   */
+  is_watching: boolean;
+  /**
+   * 현재 외부시청 세션 수
+   */
+  viewer_count: number;
+}
+
+/**
+ * CCTV; 카메라 외부시청 상태 응답
+ * @typedef {API_Res_Base<API_Res_CctvViewerStatusData>} API_Res_CctvViewerStatus
+ */
+export type API_Res_CctvViewerStatus =
+  API_Res_Base<API_Res_CctvViewerStatusData>;
+
 /**
  * CCTV; 각 분야그룹의 업체목록
  * @property {string} company_id 업체 id코드 (a.k.a site)
@@ -277,10 +412,15 @@ export type API_Req_CctvTokenPreset = Partial<
   Pick<API_Req_CctvRtcTokenOrigin, "password" | "ttl_seconds" | "kid">
 >;
 
-export interface API_Req_GetCctvTokenParams extends Omit<
-  UtilQueryBaseParams,
-  "queryUrl"
-> {
+export interface API_Req_GetCctvTokenParams {
+  /**
+   * API 도메인
+   */
+  domain: string;
+  /**
+   * Next.js /app/api 라우트 주소
+   */
+  routeUrl: string;
   /**
    * 백엔드 요청 url
    */

package/src/cctv/types/hook.ts

@@ -114,12 +114,17 @@ export interface UseCctvRtcStreamReturn extends UseCctvRtcStreamState {
 /**
  * CCTV; useCctvCompanyData params
  * @property {string} [url] 업체 리스트 API URL
+ * @property {readonly unknown[]} [queryKeyDeps] 업체 리스트 캐시 분리용 query key deps
  */
 export interface UseCctvCompanyDataParams {
   /**
    * 업체 리스트 API URL
    */
   url?: string;
+  /**
+   * 업체 리스트 캐시 분리용 query key deps
+   */
+  queryKeyDeps?: readonly unknown[];
 }
 
 /**

package/src/cctv/types/list.ts

@@ -13,6 +13,11 @@ import type {
  * @property {boolean} cam_online 카메라 설치상태
  * @property {string} [cam_rtc] 카메라 스트리밍 WebRTC 경로
  * @property {string} [cam_rtcp] 카메라 RTCP 경로
+ * @property {string} [cam_rtsp] 카메라 RTSP 경로
+ * @property {string} [stream_path] 카메라 스트림 path
+ * @property {boolean} is_public 카메라 외부공유 여부
+ * @property {boolean} [is_watching] 외부시청 중 여부
+ * @property {number} [viewer_count] 현재 외부시청 세션 수
  */
 export interface CctvCompanyCameraData extends API_Res_CctvCompanyCameraList {
   /**
@@ -44,6 +49,11 @@ export interface CctvCompanyCameraData extends API_Res_CctvCompanyCameraList {
  * @property {boolean} cam_online 카메라 설치상태
  * @property {string} [cam_rtc] 카메라 스트리밍 WebRTC 경로
  * @property {string} [cam_rtcp] 카메라 RTCP 경로
+ * @property {string} [cam_rtsp] 카메라 RTSP 경로
+ * @property {string} [stream_path] 카메라 스트림 path
+ * @property {boolean} is_public 카메라 외부공유 여부
+ * @property {boolean} [is_watching] 외부시청 중 여부
+ * @property {number} [viewer_count] 현재 외부시청 세션 수
  */
 export interface CctvCompanyCameraList extends CctvCompanyCameraData {
   /**

package/src/cctv/types/props.ts

@@ -193,7 +193,11 @@ export interface CctvVideoTemplateProps extends CctvVideoStateProps {
  * @property {boolean} cam_online 카메라 online 여부
  * @property {string} [cam_rtc] 카메라 rtc 경로
  * @property {string} [cam_rtcp] 카메라 rtcp 경로
- * @property {boolean} [cam_shared] 카메라 외부공유 여부
+ * @property {string} [cam_rtsp] 카메라 RTSP 경로
+ * @property {string} [stream_path] 카메라 스트림 path
+ * @property {boolean} is_public 카메라 외부공유 여부
+ * @property {boolean} [is_watching] 외부시청 중 여부
+ * @property {number} [viewer_count] 현재 외부시청 세션 수
  * @property {string} [company_id] 소속 업체 id
  * @property {string} [company_name] 소속 업체명
  */