@uniai-fe/uds-templates 0.1.30 → 0.1.31

package/package.json

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

package/src/cctv/apis/client.ts

@@ -6,7 +6,7 @@ import type {
 } from "../types";
 import { getQueryString } from "@uniai-fe/util-functions";
 
-export const getCctvCompanyList = async ({
+export const getClientCctvCompanyList = async ({
   username,
   url,
 }: {
@@ -14,7 +14,9 @@ export const getCctvCompanyList = async ({
   url?: string;
 }) =>
   await (
-    await fetch(`${url ?? "/api/cctv/company-list"}${getQueryString(username)}`)
+    await fetch(
+      `${url ?? "/api/cctv/company-list"}${getQueryString({ username })}`,
+    )
   ).json();
 
 export const useQueryCctvCompanyList = ({
@@ -26,7 +28,7 @@ export const useQueryCctvCompanyList = ({
 }): UseQueryResult<{ data: API_Res_CctvCompanyGroup[]; total_count: number }> =>
   useQuery({
     queryKey: ["cctv_company_list", username, url],
-    queryFn: () => getCctvCompanyList({ username, url }),
+    queryFn: () => getClientCctvCompanyList({ username, url }),
     enabled: Boolean(username),
   });
 

package/src/cctv/apis/server.ts

@@ -1,10 +1,14 @@
 import {
+  fetchWithBody,
   generateBackendQueryUrl_GET,
   nextAPILog,
 } from "@uniai-fe/util-functions";
 import type {
   API_Req_GetCompanyListParams,
+  API_Req_GetCctvTokenParams,
+  API_Req_CctvRtcTokenOrigin,
   API_Res_CctvCompanyGroup,
+  API_Res_CctvRtcToken,
 } from "../types";
 
 export const GROUP_PRESET: API_Res_CctvCompanyGroup[] = [
@@ -125,7 +129,7 @@ export function classifyGroups(
 }
 
 /**
- * CCTV; API route.ts 로직
+ * CCTV; company-list API route.ts 로직
  * @api
  * @route /v1/users/{username}/cctvs
  * @param {API_Req_GetCompanyListParams} params
@@ -134,7 +138,7 @@ export function classifyGroups(
  * @property {string} [queryUrl] 백엔드 요청 url
  * @property {URLSearchParams | object} searchParams 요청 searchParams
  */
-export async function getCompanyList({
+export async function getServerCompanyList({
   domain,
   routeUrl,
   queryUrl,
@@ -186,3 +190,104 @@ export async function getCompanyList({
     };
   }
 }
+
+/**
+ * CCTV; token API route.ts 로직
+ * @api
+ * @route /token
+ * @param {API_Req_GetCctvTokenParams} params
+ * @property {string} domain API 요청 도메인(서버)
+ * @property {string} routeUrl Next.js app/api 이하 경로 url
+ * @property {string} [queryUrl] 백엔드 요청 url
+ * @property {NextRequest} req Next.js API body 데이터
+ */
+export async function getServerCctvToken({
+  domain,
+  routeUrl,
+  queryUrl,
+  req,
+  headers,
+}: API_Req_GetCctvTokenParams): Promise<{
+  res: API_Res_CctvRtcToken;
+  domain: string;
+  queryUrl: string;
+  options?: ResponseInit;
+}> {
+  const query_url = queryUrl || "/token";
+  const reqBody = await req.json();
+
+  const API_OPTION = {
+    domain,
+    queryUrl: query_url,
+  };
+
+  const alternateResponse: API_Res_CctvRtcToken = {
+    token: "",
+  };
+
+  const BODY_PRESET: API_Req_CctvRtcTokenOrigin = {
+    site: "company_id",
+    username: "harim",
+    password: "harim",
+    action: "read",
+    path: "cam_id",
+    ttl_seconds: 3600,
+    kid: "streaming-auth-1",
+  };
+
+  if (!reqBody || !reqBody.username || !reqBody.company_id || !reqBody.cam_id) {
+    return {
+      res: alternateResponse,
+      ...API_OPTION,
+      options: {
+        status: 400,
+        statusText: "토큰 요청 파라미터가 올바르지 않습니다.",
+      },
+    };
+  }
+
+  const site = !isNaN(Number(reqBody.company_id))
+    ? `farm${reqBody.company_id}`
+    : String(reqBody.company_id);
+  const username = reqBody.username;
+  const password = reqBody.password || reqBody.username;
+  const path = !isNaN(Number(reqBody.cam_id))
+    ? `cam${reqBody.cam_id}`
+    : String(reqBody.cam_id);
+
+  // 토큰 요청 payload 구성
+  const bodyData: API_Req_CctvRtcTokenOrigin = {
+    ...BODY_PRESET,
+    site,
+    username,
+    password,
+    path,
+  };
+
+  try {
+    const res = await fetchWithBody<
+      API_Req_CctvRtcTokenOrigin,
+      API_Res_CctvRtcToken
+    >({
+      method: "POST",
+      routeUrl,
+      ...API_OPTION,
+      headers: {
+        accept: "application/json",
+        "Content-Type": "application/json",
+        ...(headers || {}),
+      },
+      bodyData,
+      alternateResponse,
+    });
+
+    return { res, ...API_OPTION };
+  } catch (error) {
+    nextAPILog("POST", routeUrl, query_url, { error });
+    return {
+      res: alternateResponse,
+      ...API_OPTION,
+      options: { status: 500 },
+    };
+  }
+}

package/src/cctv/types/api.ts

@@ -1,4 +1,5 @@
 import type { UtilQueryBaseParams } from "@uniai-fe/util-functions";
+import type { NextRequest } from "next/server";
 
 /**
  * CCTV; api getCompanyList params
@@ -109,15 +110,72 @@ export interface API_Res_CctvCompanyGroup {
 }
 
 /**
- * CCTV; 실시간 스트리밍 토큰 요청
+ * CCTV; 실시간 스트리밍 토큰 요청 (Next.js API 요청)
  * @property {string} company_id 업체 id코드
  * @property {string} cam_id 카메라 id코드
- * @property {string} username 사용자명
+ * @property {string} username 사용자 계정 아이디
  */
 export interface API_Req_CctvRtcToken {
-  company_id: string;
-  cam_id: string;
+  /**
+   * 업체 id 코드
+   */
+  company_id: number | string;
+  /**
+   * 카메라 id 코드
+   */
+  cam_id: number | string;
+  /**
+   * 사용자 계정 아이디
+   */
   username: string;
+  /**
+   * 사용자 계정 비밀번호
+   */
+  password?: string;
+}
+
+/**
+ * CCTV; 실시간 스트리밍 토큰 요청 (백엔드 요청)
+ * @property {string} site company_id 맵핑 (ex. farm102)
+ * @property {string} username 사용자 계정 아이디
+ * @property {string} password 사용자 계정 비밀번호 (대체로 계정 아이디 맵핑)
+ * @property {string} action "read"
+ * @property {string} path cam_id 맵핑 (ex. cam3)
+ * @property {number} ttl_seconds 시간? (default 3600)
+ * @property {string} kid "streaming-auth-1"
+ */
+export interface API_Req_CctvRtcTokenOrigin {
+  /**
+   * company_id 맵핑
+   * ex) farm102
+   */
+  site: string;
+  /**
+   * 사용자 계정 아이디
+   */
+  username: string;
+  /**
+   * 사용자 계정 비밀번호
+   * - 대체로 계정 아이디 맵핑
+   */
+  password: string;
+  /**
+   * "read"
+   */
+  action: string;
+  /**
+   * cam_id 맵핑
+   * ex) cam3
+   */
+  path: string;
+  /**
+   * default) 3600
+   */
+  ttl_seconds: number;
+  /**
+   * "streaming-auth-1"
+   */
+  kid: string;
 }
 
 /**
@@ -125,6 +183,10 @@ export interface API_Req_CctvRtcToken {
  * @property {string} token 인증 토큰
  */
 export interface API_Res_CctvRtcToken {
+  /**
+   * JWT 인증 토큰
+   * Bearer
+   */
   token: string;
 }
 
@@ -164,3 +226,38 @@ export interface API_Req_CctvStreamToken {
    */
   cam_id: string;
 }
+
+/**
+ * CCTV; 서버 토큰 요청 파라미터
+ * @property {string} domain API 요청 도메인(서버)
+ * @property {string} routeUrl Next.js app/api 이하 경로 url
+ * @property {string} [queryUrl] 백엔드 요청 url
+ * @property {string} username 사용자 아이디
+ * @property {string} company_id 업체 id코드(site)
+ * @property {string} cam_id 카메라 id코드
+ * @property {string} [password] 사용자 비밀번호 (없으면 username 사용)
+ * @property {number} [ttl_seconds] 토큰 만료시간
+ * @property {string} [kid] 키 id
+ * @property {Record<string, string>} [headers] 추가 요청 헤더
+ */
+export type API_Req_CctvTokenPreset = Partial<
+  Pick<API_Req_CctvRtcTokenOrigin, "password" | "ttl_seconds" | "kid">
+>;
+
+export interface API_Req_GetCctvTokenParams extends Omit<
+  UtilQueryBaseParams,
+  "queryUrl"
+> {
+  /**
+   * 백엔드 요청 url
+   */
+  queryUrl?: string;
+  /**
+   * Next.js API 요청 body
+   */
+  req: NextRequest;
+  /**
+   * 추가 요청 헤더
+   */
+  headers?: Record<string, string>;
+}