@uniai-fe/util-functions 0.2.0 → 0.2.2

package/README.md

@@ -1,47 +1,3 @@
 # util / functions
 
 의존성을 최소화한 범용 도구 모음
-
-## 빠른 사용법 (API + 환경변수)
-
-- 1단계만 기억하세요: **env 맵만 넘겨 `createBackendApiClientFromEnv`를 호출**합니다.
-- 예시:
-
-  ```ts
-  import { createBackendApiClientFromEnv } from "@uniai-fe/util-functions/api";
-
-  // env 맵 → 도메인으로 바꿔주는 클라이언트를 한 번만 생성
-  const api = createBackendApiClientFromEnv({
-    ai: process.env.AI_API_BASE,
-    db: process.env.DB_API_BASE,
-    uniai: process.env.UNIAI_API_BASE,
-  });
-
-  export const { generateBackendQueryUrl_GET, fetchBackendQuery } = api;
-  export const apiLog = api.logger; // == nextAPILog
-  ```
-
-- 서비스 앱이든 모듈 패키지든 동일한 접근입니다. Next.js이면 `@uniai-fe/util-next`의 어댑터를 통해 같은 API를 그대로 사용하면 됩니다.
-
-## 타입 선언 관리 메모
-
-- 내부 타입 정의는 `.d.ts` 대신 `.ts` 모듈(예: `src/core/format/types.ts`)로 유지합니다.
-- tsup 번들 과정에서 선언 전용 파일이 엔트리에 포함되면 경고가 발생할 수 있어,
-  `.ts` 모듈로 import/export 하되 TypeScript가 컴파일 시 타입만 제거하도록 위임합니다.
-
-## 동작 원리 / 로직 개요
-
-- `createBackendApiClientFromEnv`는 env 맵 → `resolveDomain` → API 클라이언트로 이어지는 단계를 한 번에 처리합니다. env가 비어 있으면 `process.env[${INFRA}_API_BASE]` → `infra` 문자열 순으로 fallback 합니다.
-- 직접 제어가 필요하면 `createEnvDomainResolver`를 사용해 resolver만 만들고 `createBackendApiClient`에 주입할 수 있습니다.
-- 클라이언트에서 얻을 수 있는 것들:
-  - `generateBackendQueryUrl_GET`: 도메인 + 쿼리스트링 조합
-  - `fetchBackendQuery`: POST/DELETE 등 본문 포함 요청과 로깅/대체응답 처리
-  - `getQueryString`: 객체/URLSearchParams 직렬화
-  - `logger`: 공통 포맷 로거
-- 이 구조 덕분에 최종 사용 단계는 “한 번 정의한 클라이언트에서 함수 가져다 쓰기”로 끝납니다.
-
-## Next.js 유틸 안내
-
-- Next 서버 전용 API 도우미는 `@uniai-fe/util-next` 패키지로 이동했습니다.
-- 환경 구성(`api-infra.config.ts`)을 통해 도메인을 주입한 뒤 util-functions의 공용 API 헬퍼를 활용하세요.
-- JSX/파일 등 React 의존 유틸은 `@uniai-fe/util-react` 패키지에서 제공됩니다.

package/dist/index.cjs

@@ -786,7 +786,7 @@ var fetchWithBody = async ({
   }
 };
 
-// src/user-agent/device-patterns.ts
+// src/runtime-env/device.ts
 var apple = ["iPhone", "iPad", "iPod", "Mac", "Macintosh"];
 var tablet = ["Tablet", "iPad", "playbook", "silk"];
 var mobile = [
@@ -812,21 +812,17 @@ var mobile = [
   "Skyfire",
   "Zune"
 ];
-var devicePatterns = {
+var userAgentCollection = {
   apple,
   tablet,
   mobile
 };
-var device_patterns_default = devicePatterns;
-
-// src/user-agent/module.ts
 var setLowerCase = (v) => String(v).toLowerCase();
-var deviceLowerCasePatterns = Object.fromEntries(
-  Object.entries(device_patterns_default).map(([key, value]) => [
-    key,
-    value.map(setLowerCase)
-  ])
-);
+var deviceLowerCasePatterns = {
+  apple: apple.map(setLowerCase),
+  tablet: tablet.map(setLowerCase),
+  mobile: mobile.map(setLowerCase)
+};
 var checkResponsiveDevice = (userAgent) => {
   const { mobile: mobile2, tablet: tablet2 } = deviceLowerCasePatterns;
   const clientAgent = setLowerCase(userAgent);
@@ -841,6 +837,50 @@ var checkAppleDevice = (userAgent) => {
   return apple2.some((agent) => clientAgent.includes(agent));
 };
 
+// src/runtime-env/pwa.ts
+var DISPLAY_MODE_QUERIES = [
+  { mode: "standalone", query: "(display-mode: standalone)" },
+  { mode: "fullscreen", query: "(display-mode: fullscreen)" },
+  { mode: "minimal-ui", query: "(display-mode: minimal-ui)" },
+  { mode: "browser", query: "(display-mode: browser)" }
+];
+var STANDALONE_DISPLAY_MODES = /* @__PURE__ */ new Set([
+  "standalone",
+  "fullscreen",
+  "minimal-ui"
+]);
+var isWindowAvailable = () => typeof window !== "undefined";
+var detectDisplayMode = () => {
+  if (!isWindowAvailable() || typeof window.matchMedia !== "function") {
+    return "unknown";
+  }
+  for (const { mode, query } of DISPLAY_MODE_QUERIES) {
+    if (window.matchMedia(query).matches) {
+      return mode;
+    }
+  }
+  return "unknown";
+};
+var detectNavigatorStandalone = () => {
+  if (!isWindowAvailable()) {
+    return false;
+  }
+  const nav = window.navigator;
+  return typeof nav.standalone === "boolean" ? Boolean(nav.standalone) : false;
+};
+var getPwaRuntimeInfo = () => {
+  const displayMode = detectDisplayMode();
+  const navigatorStandalone = detectNavigatorStandalone();
+  if (displayMode === "unknown" && navigatorStandalone) {
+    return { isStandalone: true, displayMode: "standalone" };
+  }
+  return {
+    displayMode,
+    isStandalone: displayMode === "unknown" ? navigatorStandalone : STANDALONE_DISPLAY_MODES.has(displayMode)
+  };
+};
+var checkStandaloneApp = getPwaRuntimeInfo;
+
 // src/form/checkbox/module.ts
 var syncAllToEach = (checkStateObject, allCheckState) => Object.fromEntries(
   Object.entries(checkStateObject).map(([key]) => [key, allCheckState])
@@ -889,6 +929,7 @@ exports.capitalize = capitalize;
 exports.checkAppleDevice = checkAppleDevice;
 exports.checkDateMoment = checkDateMoment;
 exports.checkResponsiveDevice = checkResponsiveDevice;
+exports.checkStandaloneApp = checkStandaloneApp;
 exports.convert2Digit = convert2Digit;
 exports.convertDigit = convertDigit;
 exports.convertLiter = convertLiter;
@@ -900,7 +941,6 @@ exports.covertGram = covertGram;
 exports.covertKilogram = covertKilogram;
 exports.dateFormat = dateFormat;
 exports.deltaFormat = deltaFormat;
-exports.devicePatterns = device_patterns_default;
 exports.distanceFormat = distanceFormat;
 exports.durationFormat = durationFormat;
 exports.escapeQuotes = escapeQuotes;
@@ -919,6 +959,7 @@ exports.getNextDay = getNextDay;
 exports.getNextWeeks = getNextWeeks;
 exports.getNumberReplaceComma = getNumberReplaceComma;
 exports.getPrevDay = getPrevDay;
+exports.getPwaRuntimeInfo = getPwaRuntimeInfo;
 exports.getQueryString = getQueryString;
 exports.getRepeatCycleUnit = getRepeatCycleUnit;
 exports.getToday = getToday;
@@ -960,6 +1001,7 @@ exports.styleSpacingSize = styleSpacingSize;
 exports.syncAllToEach = syncAllToEach;
 exports.syncEachToAll = syncEachToAll;
 exports.timeFormat = timeFormat;
+exports.userAgentCollection = userAgentCollection;
 exports.weekOrderIndex = weekOrderIndex;
 exports.weekOrderKo = weekOrderKo;
 exports.weekdayByDayCode = weekdayByDayCode;