@fuzionx/framework 0.1.39 → 0.1.42

package/lib/utilities/ObjectUtil.js

@@ -1,170 +1,170 @@
-/**
- * ObjectUtil — 객체 순수 유틸리티
- */
-
-/**
- * Deep clone (structuredClone 폴백)
- * @param {*} obj
- * @returns {*}
- */
-export function deepClone(obj) {
-    if (typeof structuredClone === 'function') return structuredClone(obj);
-    return JSON.parse(JSON.stringify(obj));
-}
-
-/**
- * Deep merge — 비파괴 병합
- * @param {object} target
- * @param {...object} sources
- * @returns {object}
- */
-export function deepMerge(target, ...sources) {
-    const result = { ...target };
-    for (const source of sources) {
-        if (!source) continue;
-        for (const key of Object.keys(source)) {
-            const sv = source[key];
-            const tv = result[key];
-            if (isPlainObject(sv) && isPlainObject(tv)) {
-                result[key] = deepMerge(tv, sv);
-            } else {
-                result[key] = sv;
-            }
-        }
-    }
-    return result;
-}
-
-/**
- * 특정 키만 선택
- * @param {object} obj
- * @param {string[]} keys
- * @returns {object}
- *
- * @example pick({ a:1, b:2, c:3 }, ['a', 'c']) → { a:1, c:3 }
- */
-export function pick(obj, keys) {
-    const result = {};
-    for (const key of keys) {
-        if (key in obj) result[key] = obj[key];
-    }
-    return result;
-}
-
-/**
- * 특정 키 제외
- * @param {object} obj
- * @param {string[]} keys
- * @returns {object}
- */
-export function omit(obj, keys) {
-    const keySet = new Set(keys);
-    const result = {};
-    for (const key of Object.keys(obj)) {
-        if (!keySet.has(key)) result[key] = obj[key];
-    }
-    return result;
-}
-
-/**
- * Flatten — 중첩 객체를 dot notation으로 평탄화
- * @param {object} obj
- * @param {string} [prefix='']
- * @returns {object}
- *
- * @example flatten({ a: { b: 1, c: { d: 2 } } }) → { 'a.b': 1, 'a.c.d': 2 }
- */
-export function flatten(obj, prefix = '') {
-    const result = {};
-    for (const key of Object.keys(obj)) {
-        const path = prefix ? `${prefix}.${key}` : key;
-        const val = obj[key];
-        if (isPlainObject(val)) {
-            Object.assign(result, flatten(val, path));
-        } else {
-            result[path] = val;
-        }
-    }
-    return result;
-}
-
-/**
- * Unflatten — dot notation → 중첩 객체
- * @param {object} obj
- * @returns {object}
- */
-export function unflatten(obj) {
-    const result = {};
-    for (const [key, val] of Object.entries(obj)) {
-        const parts = key.split('.');
-        let current = result;
-        for (let i = 0; i < parts.length - 1; i++) {
-            if (!current[parts[i]] || typeof current[parts[i]] !== 'object') {
-                current[parts[i]] = {};
-            }
-            current = current[parts[i]];
-        }
-        current[parts[parts.length - 1]] = val;
-    }
-    return result;
-}
-
-/**
- * 객체가 비어있는지 확인
- * @param {*} obj
- * @returns {boolean}
- */
-export function isEmpty(obj) {
-    if (!obj) return true;
-    return Object.keys(obj).length === 0;
-}
-
-/**
- * dot notation으로 값 접근
- * @param {object} obj
- * @param {string} path
- * @param {*} [defaultValue]
- * @returns {*}
- *
- * @example get({ a: { b: { c: 42 } } }, 'a.b.c') → 42
- */
-export function get(obj, path, defaultValue) {
-    const parts = path.split('.');
-    let current = obj;
-    for (const part of parts) {
-        if (current == null || typeof current !== 'object') return defaultValue;
-        current = current[part];
-    }
-    return current !== undefined ? current : defaultValue;
-}
-
-/**
- * dot notation으로 값 설정 (비파괴 — 새 객체 반환)
- * @param {object} obj
- * @param {string} path
- * @param {*} value
- * @returns {object}
- */
-export function set(obj, path, value) {
-    const result = deepClone(obj);
-    const parts = path.split('.');
-    let current = result;
-    for (let i = 0; i < parts.length - 1; i++) {
-        if (!current[parts[i]] || typeof current[parts[i]] !== 'object') {
-            current[parts[i]] = {};
-        }
-        current = current[parts[i]];
-    }
-    current[parts[parts.length - 1]] = value;
-    return result;
-}
-
-/**
- * 순수 객체인지 확인 (Array, Date 등 제외)
- * @param {*} val
- * @returns {boolean}
- */
-export function isPlainObject(val) {
-    return val !== null && typeof val === 'object' && !Array.isArray(val)
-        && Object.getPrototypeOf(val) === Object.prototype;
-}
+/**
+ * ObjectUtil — 객체 순수 유틸리티
+ */
+
+/**
+ * Deep clone (structuredClone 폴백)
+ * @param {*} obj
+ * @returns {*}
+ */
+export function deepClone(obj) {
+    if (typeof structuredClone === 'function') return structuredClone(obj);
+    return JSON.parse(JSON.stringify(obj));
+}
+
+/**
+ * Deep merge — 비파괴 병합
+ * @param {object} target
+ * @param {...object} sources
+ * @returns {object}
+ */
+export function deepMerge(target, ...sources) {
+    const result = { ...target };
+    for (const source of sources) {
+        if (!source) continue;
+        for (const key of Object.keys(source)) {
+            const sv = source[key];
+            const tv = result[key];
+            if (isPlainObject(sv) && isPlainObject(tv)) {
+                result[key] = deepMerge(tv, sv);
+            } else {
+                result[key] = sv;
+            }
+        }
+    }
+    return result;
+}
+
+/**
+ * 특정 키만 선택
+ * @param {object} obj
+ * @param {string[]} keys
+ * @returns {object}
+ *
+ * @example pick({ a:1, b:2, c:3 }, ['a', 'c']) → { a:1, c:3 }
+ */
+export function pick(obj, keys) {
+    const result = {};
+    for (const key of keys) {
+        if (key in obj) result[key] = obj[key];
+    }
+    return result;
+}
+
+/**
+ * 특정 키 제외
+ * @param {object} obj
+ * @param {string[]} keys
+ * @returns {object}
+ */
+export function omit(obj, keys) {
+    const keySet = new Set(keys);
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        if (!keySet.has(key)) result[key] = obj[key];
+    }
+    return result;
+}
+
+/**
+ * Flatten — 중첩 객체를 dot notation으로 평탄화
+ * @param {object} obj
+ * @param {string} [prefix='']
+ * @returns {object}
+ *
+ * @example flatten({ a: { b: 1, c: { d: 2 } } }) → { 'a.b': 1, 'a.c.d': 2 }
+ */
+export function flatten(obj, prefix = '') {
+    const result = {};
+    for (const key of Object.keys(obj)) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        const val = obj[key];
+        if (isPlainObject(val)) {
+            Object.assign(result, flatten(val, path));
+        } else {
+            result[path] = val;
+        }
+    }
+    return result;
+}
+
+/**
+ * Unflatten — dot notation → 중첩 객체
+ * @param {object} obj
+ * @returns {object}
+ */
+export function unflatten(obj) {
+    const result = {};
+    for (const [key, val] of Object.entries(obj)) {
+        const parts = key.split('.');
+        let current = result;
+        for (let i = 0; i < parts.length - 1; i++) {
+            if (!current[parts[i]] || typeof current[parts[i]] !== 'object') {
+                current[parts[i]] = {};
+            }
+            current = current[parts[i]];
+        }
+        current[parts[parts.length - 1]] = val;
+    }
+    return result;
+}
+
+/**
+ * 객체가 비어있는지 확인
+ * @param {*} obj
+ * @returns {boolean}
+ */
+export function isEmpty(obj) {
+    if (!obj) return true;
+    return Object.keys(obj).length === 0;
+}
+
+/**
+ * dot notation으로 값 접근
+ * @param {object} obj
+ * @param {string} path
+ * @param {*} [defaultValue]
+ * @returns {*}
+ *
+ * @example get({ a: { b: { c: 42 } } }, 'a.b.c') → 42
+ */
+export function get(obj, path, defaultValue) {
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current == null || typeof current !== 'object') return defaultValue;
+        current = current[part];
+    }
+    return current !== undefined ? current : defaultValue;
+}
+
+/**
+ * dot notation으로 값 설정 (비파괴 — 새 객체 반환)
+ * @param {object} obj
+ * @param {string} path
+ * @param {*} value
+ * @returns {object}
+ */
+export function set(obj, path, value) {
+    const result = deepClone(obj);
+    const parts = path.split('.');
+    let current = result;
+    for (let i = 0; i < parts.length - 1; i++) {
+        if (!current[parts[i]] || typeof current[parts[i]] !== 'object') {
+            current[parts[i]] = {};
+        }
+        current = current[parts[i]];
+    }
+    current[parts[parts.length - 1]] = value;
+    return result;
+}
+
+/**
+ * 순수 객체인지 확인 (Array, Date 등 제외)
+ * @param {*} val
+ * @returns {boolean}
+ */
+export function isPlainObject(val) {
+    return val !== null && typeof val === 'object' && !Array.isArray(val)
+        && Object.getPrototypeOf(val) === Object.prototype;
+}

package/lib/utilities/PaginationUtil.js

@@ -1,81 +1,81 @@
-/**
- * PaginationUtil — 페이지네이션 순수 유틸리티
- *
- * Stateless 함수들. DB Pagination 클래스와 달리
- * 인메모리 배열/수동 메타 계산에 사용.
- *
- * @see lib/database/Pagination.js — DB 쿼리 결과용
- */
-
-/**
- * 메타 계산 — total, page, perPage로 페이지네이션 정보 생성
- * @param {number} total - 전체 레코드 수
- * @param {number} page - 현재 페이지 (1-based)
- * @param {number} perPage - 페이지당 수
- * @returns {{ total, page, perPage, lastPage, hasMore, from, to }}
- */
-export function buildMeta(total, page = 1, perPage = 20) {
-    const lastPage = Math.ceil(total / perPage) || 1;
-    const from = (page - 1) * perPage + 1;
-    const to = Math.min(page * perPage, total);
-    return {
-        total,
-        page,
-        perPage,
-        lastPage,
-        hasMore: page < lastPage,
-        from: total > 0 ? from : 0,
-        to: total > 0 ? to : 0,
-    };
-}
-
-/**
- * 인메모리 배열 페이지네이션
- * @param {Array} items - 전체 배열
- * @param {number} page - 현재 페이지 (1-based)
- * @param {number} perPage - 페이지당 수
- * @returns {{ data: Array, meta: object }}
- */
-export function paginate(items, page = 1, perPage = 20) {
-    const total = items.length;
-    const start = (page - 1) * perPage;
-    const data = items.slice(start, start + perPage);
-    return { data, meta: buildMeta(total, page, perPage) };
-}
-
-/**
- * offset/limit 계산
- * @param {number} page
- * @param {number} perPage
- * @returns {{ offset: number, limit: number }}
- */
-export function offsetLimit(page = 1, perPage = 20) {
-    return {
-        offset: (page - 1) * perPage,
-        limit: perPage,
-    };
-}
-
-/**
- * 페이지 번호 배열 생성 (페이지 네비게이션 UI용)
- * @param {number} current - 현재 페이지
- * @param {number} last - 마지막 페이지
- * @param {number} [delta=2] - 현재 페이지 앞뒤로 표시할 수
- * @returns {Array<number|'...'>}
- *
- * @example
- * pageNumbers(5, 20, 2) → [1, '...', 3, 4, 5, 6, 7, '...', 20]
- */
-export function pageNumbers(current, last, delta = 2) {
-    const pages = [];
-    const rangeStart = Math.max(2, current - delta);
-    const rangeEnd = Math.min(last - 1, current + delta);
-
-    pages.push(1);
-    if (rangeStart > 2) pages.push('...');
-    for (let i = rangeStart; i <= rangeEnd; i++) pages.push(i);
-    if (rangeEnd < last - 1) pages.push('...');
-    if (last > 1) pages.push(last);
-
-    return pages;
-}
+/**
+ * PaginationUtil — 페이지네이션 순수 유틸리티
+ *
+ * Stateless 함수들. DB Pagination 클래스와 달리
+ * 인메모리 배열/수동 메타 계산에 사용.
+ *
+ * @see lib/database/Pagination.js — DB 쿼리 결과용
+ */
+
+/**
+ * 메타 계산 — total, page, perPage로 페이지네이션 정보 생성
+ * @param {number} total - 전체 레코드 수
+ * @param {number} page - 현재 페이지 (1-based)
+ * @param {number} perPage - 페이지당 수
+ * @returns {{ total, page, perPage, lastPage, hasMore, from, to }}
+ */
+export function buildMeta(total, page = 1, perPage = 20) {
+    const lastPage = Math.ceil(total / perPage) || 1;
+    const from = (page - 1) * perPage + 1;
+    const to = Math.min(page * perPage, total);
+    return {
+        total,
+        page,
+        perPage,
+        lastPage,
+        hasMore: page < lastPage,
+        from: total > 0 ? from : 0,
+        to: total > 0 ? to : 0,
+    };
+}
+
+/**
+ * 인메모리 배열 페이지네이션
+ * @param {Array} items - 전체 배열
+ * @param {number} page - 현재 페이지 (1-based)
+ * @param {number} perPage - 페이지당 수
+ * @returns {{ data: Array, meta: object }}
+ */
+export function paginate(items, page = 1, perPage = 20) {
+    const total = items.length;
+    const start = (page - 1) * perPage;
+    const data = items.slice(start, start + perPage);
+    return { data, meta: buildMeta(total, page, perPage) };
+}
+
+/**
+ * offset/limit 계산
+ * @param {number} page
+ * @param {number} perPage
+ * @returns {{ offset: number, limit: number }}
+ */
+export function offsetLimit(page = 1, perPage = 20) {
+    return {
+        offset: (page - 1) * perPage,
+        limit: perPage,
+    };
+}
+
+/**
+ * 페이지 번호 배열 생성 (페이지 네비게이션 UI용)
+ * @param {number} current - 현재 페이지
+ * @param {number} last - 마지막 페이지
+ * @param {number} [delta=2] - 현재 페이지 앞뒤로 표시할 수
+ * @returns {Array<number|'...'>}
+ *
+ * @example
+ * pageNumbers(5, 20, 2) → [1, '...', 3, 4, 5, 6, 7, '...', 20]
+ */
+export function pageNumbers(current, last, delta = 2) {
+    const pages = [];
+    const rangeStart = Math.max(2, current - delta);
+    const rangeEnd = Math.min(last - 1, current + delta);
+
+    pages.push(1);
+    if (rangeStart > 2) pages.push('...');
+    for (let i = rangeStart; i <= rangeEnd; i++) pages.push(i);
+    if (rangeEnd < last - 1) pages.push('...');
+    if (last > 1) pages.push(last);
+
+    return pages;
+}