@simplysm/core-common 13.0.100 → 14.0.1

package/dist/utils/bytes.d.ts

@@ -1,8 +1,8 @@
 import type { Bytes } from "../common.types";
 /**
- * Concatenate multiple Uint8Arrays
- * @param arrays Uint8Array array to concatenate
- * @returns New concatenated Uint8Array
+ * 여러 Uint8Array 결합
+ * @param arrays 결합할 Uint8Array 배열
+ * @returns 결합된 새 Uint8Array
  * @example
  * const a = new Uint8Array([1, 2]);
  * const b = new Uint8Array([3, 4]);
@@ -11,38 +11,38 @@ import type { Bytes } from "../common.types";
  */
 export declare function concat(arrays: Bytes[]): Bytes;
 /**
- * Convert to hex string
- * @param bytes Uint8Array to convert
- * @returns Lowercase hex string
+ * hex 문자열로 변환
+ * @param bytes 변환할 Uint8Array
+ * @returns 소문자 hex 문자열
  * @example
  * toHex(new Uint8Array([255, 0, 127]));
  * // "ff007f"
  */
 export declare function toHex(bytes: Bytes): string;
 /**
- * Convert from hex string to Uint8Array
- * @param hex Hex string to convert (lowercase and uppercase allowed)
- * @returns Converted Uint8Array
- * @throws {ArgumentError} If odd length or invalid hex characters are present
+ * hex 문자열을 Uint8Array로 변환
+ * @param hex 변환할 hex 문자열 (대소문자 허용)
+ * @returns 변환된 Uint8Array
+ * @throws {ArgumentError} 홀수 길이이거나 유효하지 않은 hex 문자가 포함된 경우
  * @example
  * fromHex("ff007f");
  * // Uint8Array([255, 0, 127])
  */
 export declare function fromHex(hex: string): Bytes;
 /**
- * Convert Bytes to base64 string
- * @param bytes Uint8Array to convert
- * @returns Base64 encoded string
+ * Bytes를 base64 문자열로 변환
+ * @param bytes 변환할 Uint8Array
+ * @returns Base64 인코딩된 문자열
  * @example
  * toBase64(new Uint8Array([72, 101, 108, 108, 111]));
  * // "SGVsbG8="
  */
 export declare function toBase64(bytes: Bytes): string;
 /**
- * Convert base64 string to Bytes
- * @param base64 Base64 string to convert
- * @returns Decoded Uint8Array
- * @throws {ArgumentError} If invalid base64 character is present
+ * base64 문자열을 Bytes로 변환
+ * @param base64 변환할 base64 문자열
+ * @returns 디코딩된 Uint8Array
+ * @throws {ArgumentError} 유효하지 않은 base64 문자가 포함된 경우
  * @example
  * fromBase64("SGVsbG8=");
  * // Uint8Array([72, 101, 108, 108, 111])

package/dist/utils/bytes.js

@@ -1,91 +1,147 @@
 import { ArgumentError } from "../errors/argument-error.js";
+/**
+ * Uint8Array 유틸리티 함수 (복잡한 연산만)
+ *
+ * 기능:
+ * - concat: 여러 Uint8Array 결합
+ * - toHex: Uint8Array를 hex 문자열로 변환
+ * - fromHex: hex 문자열을 Uint8Array로 변환
+ * - toBase64: Uint8Array를 base64 문자열로 변환
+ * - fromBase64: base64 문자열을 Uint8Array로 변환
+ */
+/** hex 변환용 조회 테이블 (성능 최적화) */
 const hexTable = Array.from({ length: 256 }, (_, i) => i.toString(16).padStart(2, "0"));
+/** Base64 인코딩 테이블 */
 const BASE64_CHARS = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+/** Base64 디코딩 조회 테이블 (O(1) 조회, 모든 바이트 값 포함) */
 const BASE64_LOOKUP = Array.from({ length: 256 }, (_, i) => {
-  const idx = BASE64_CHARS.indexOf(String.fromCharCode(i));
-  return idx === -1 ? 0 : idx;
+    const idx = BASE64_CHARS.indexOf(String.fromCharCode(i));
+    return idx === -1 ? 0 : idx;
 });
-function concat(arrays) {
-  const total = arrays.reduce((sum, arr) => sum + arr.length, 0);
-  const result = new Uint8Array(total);
-  let offset = 0;
-  for (const arr of arrays) {
-    result.set(arr, offset);
-    offset += arr.length;
-  }
-  return result;
+/**
+ * 여러 Uint8Array 결합
+ * @param arrays 결합할 Uint8Array 배열
+ * @returns 결합된 새 Uint8Array
+ * @example
+ * const a = new Uint8Array([1, 2]);
+ * const b = new Uint8Array([3, 4]);
+ * concat([a, b]);
+ * // Uint8Array([1, 2, 3, 4])
+ */
+export function concat(arrays) {
+    const total = arrays.reduce((sum, arr) => sum + arr.length, 0);
+    const result = new Uint8Array(total);
+    let offset = 0;
+    for (const arr of arrays) {
+        result.set(arr, offset);
+        offset += arr.length;
+    }
+    return result;
 }
-function toHex(bytes) {
-  const h = hexTable;
-  let result = "";
-  for (let i = 0; i < bytes.length; i++) {
-    result += h[bytes[i]];
-  }
-  return result;
+/**
+ * hex 문자열로 변환
+ * @param bytes 변환할 Uint8Array
+ * @returns 소문자 hex 문자열
+ * @example
+ * toHex(new Uint8Array([255, 0, 127]));
+ * // "ff007f"
+ */
+export function toHex(bytes) {
+    const h = hexTable;
+    let result = "";
+    for (let i = 0; i < bytes.length; i++) {
+        result += h[bytes[i]];
+    }
+    return result;
 }
-function fromHex(hex) {
-  if (hex.length % 2 !== 0) {
-    throw new ArgumentError("Hex string must have even length", { hex });
-  }
-  if (hex.length > 0 && !/^[0-9a-fA-F]+$/.test(hex)) {
-    throw new ArgumentError("Invalid hex character included", { hex });
-  }
-  const bytes = new Uint8Array(hex.length / 2);
-  for (let i = 0; i < bytes.length; i++) {
-    bytes[i] = Number.parseInt(hex.substring(i * 2, i * 2 + 2), 16);
-  }
-  return bytes;
+/**
+ * hex 문자열을 Uint8Array로 변환
+ * @param hex 변환할 hex 문자열 (대소문자 허용)
+ * @returns 변환된 Uint8Array
+ * @throws {ArgumentError} 홀수 길이이거나 유효하지 않은 hex 문자가 포함된 경우
+ * @example
+ * fromHex("ff007f");
+ * // Uint8Array([255, 0, 127])
+ */
+export function fromHex(hex) {
+    if (hex.length % 2 !== 0) {
+        throw new ArgumentError("hex 문자열은 짝수 길이여야 합니다", { hex });
+    }
+    if (hex.length > 0 && !/^[0-9a-fA-F]+$/.test(hex)) {
+        throw new ArgumentError("유효하지 않은 hex 문자가 포함되어 있습니다", { hex });
+    }
+    const bytes = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < bytes.length; i++) {
+        bytes[i] = Number.parseInt(hex.substring(i * 2, i * 2 + 2), 16);
+    }
+    return bytes;
 }
-function toBase64(bytes) {
-  if (bytes.length === 0) {
-    return "";
-  }
-  let result = "";
-  const len = bytes.length;
-  for (let i = 0; i < len; i += 3) {
-    const b1 = bytes[i];
-    const b2 = i + 1 < len ? bytes[i + 1] : 0;
-    const b3 = i + 2 < len ? bytes[i + 2] : 0;
-    result += BASE64_CHARS[b1 >> 2];
-    result += BASE64_CHARS[(b1 & 3) << 4 | b2 >> 4];
-    result += i + 1 < len ? BASE64_CHARS[(b2 & 15) << 2 | b3 >> 6] : "=";
-    result += i + 2 < len ? BASE64_CHARS[b3 & 63] : "=";
-  }
-  return result;
+/**
+ * Bytes를 base64 문자열로 변환
+ * @param bytes 변환할 Uint8Array
+ * @returns Base64 인코딩된 문자열
+ * @example
+ * toBase64(new Uint8Array([72, 101, 108, 108, 111]));
+ * // "SGVsbG8="
+ */
+export function toBase64(bytes) {
+    if (bytes.length === 0) {
+        return "";
+    }
+    let result = "";
+    const len = bytes.length;
+    for (let i = 0; i < len; i += 3) {
+        const b1 = bytes[i];
+        const b2 = i + 1 < len ? bytes[i + 1] : 0;
+        const b3 = i + 2 < len ? bytes[i + 2] : 0;
+        result += BASE64_CHARS[b1 >> 2];
+        result += BASE64_CHARS[((b1 & 3) << 4) | (b2 >> 4)];
+        result += i + 1 < len ? BASE64_CHARS[((b2 & 15) << 2) | (b3 >> 6)] : "=";
+        result += i + 2 < len ? BASE64_CHARS[b3 & 63] : "=";
+    }
+    return result;
 }
-function fromBase64(base64) {
-  const cleanBase64 = base64.replace(/\s/g, "").replace(/=+$/, "");
-  if (cleanBase64.length === 0) {
-    return new Uint8Array(0);
-  }
-  if (!/^[A-Za-z0-9+/]+$/.test(cleanBase64)) {
-    throw new ArgumentError("Invalid base64 character included", {
-      base64: base64.substring(0, 20)
-    });
-  }
-  if (cleanBase64.length % 4 === 1) {
-    throw new ArgumentError("Invalid base64 length", { length: cleanBase64.length });
-  }
-  const len = cleanBase64.length;
-  const byteLen = Math.floor(len * 3 / 4);
-  const bytes = new Uint8Array(byteLen);
-  let byteIdx = 0;
-  for (let i = 0; i < len; i += 4) {
-    const c1 = BASE64_LOOKUP[cleanBase64.charCodeAt(i)];
-    const c2 = i + 1 < len ? BASE64_LOOKUP[cleanBase64.charCodeAt(i + 1)] : 0;
-    const c3 = i + 2 < len ? BASE64_LOOKUP[cleanBase64.charCodeAt(i + 2)] : 0;
-    const c4 = i + 3 < len ? BASE64_LOOKUP[cleanBase64.charCodeAt(i + 3)] : 0;
-    bytes[byteIdx++] = c1 << 2 | c2 >> 4;
-    if (byteIdx < byteLen) bytes[byteIdx++] = (c2 & 15) << 4 | c3 >> 2;
-    if (byteIdx < byteLen) bytes[byteIdx++] = (c3 & 3) << 6 | c4;
-  }
-  return bytes;
+/**
+ * base64 문자열을 Bytes로 변환
+ * @param base64 변환할 base64 문자열
+ * @returns 디코딩된 Uint8Array
+ * @throws {ArgumentError} 유효하지 않은 base64 문자가 포함된 경우
+ * @example
+ * fromBase64("SGVsbG8=");
+ * // Uint8Array([72, 101, 108, 108, 111])
+ */
+export function fromBase64(base64) {
+    // 공백 제거 및 패딩 정규화
+    const cleanBase64 = base64.replace(/\s/g, "").replace(/=+$/, "");
+    // 빈 문자열 처리
+    if (cleanBase64.length === 0) {
+        return new Uint8Array(0);
+    }
+    // 유효성 검사: 문자
+    if (!/^[A-Za-z0-9+/]+$/.test(cleanBase64)) {
+        throw new ArgumentError("유효하지 않은 base64 문자가 포함되어 있습니다", {
+            base64: base64.substring(0, 20),
+        });
+    }
+    // 유효성 검사: 길이 (패딩 제거 후 나머지가 1이면 유효하지 않음)
+    if (cleanBase64.length % 4 === 1) {
+        throw new ArgumentError("유효하지 않은 base64 길이입니다", { length: cleanBase64.length });
+    }
+    const len = cleanBase64.length;
+    const byteLen = Math.floor((len * 3) / 4);
+    const bytes = new Uint8Array(byteLen);
+    let byteIdx = 0;
+    for (let i = 0; i < len; i += 4) {
+        const c1 = BASE64_LOOKUP[cleanBase64.charCodeAt(i)];
+        const c2 = i + 1 < len ? BASE64_LOOKUP[cleanBase64.charCodeAt(i + 1)] : 0;
+        const c3 = i + 2 < len ? BASE64_LOOKUP[cleanBase64.charCodeAt(i + 2)] : 0;
+        const c4 = i + 3 < len ? BASE64_LOOKUP[cleanBase64.charCodeAt(i + 3)] : 0;
+        bytes[byteIdx++] = (c1 << 2) | (c2 >> 4);
+        if (byteIdx < byteLen)
+            bytes[byteIdx++] = ((c2 & 15) << 4) | (c3 >> 2);
+        if (byteIdx < byteLen)
+            bytes[byteIdx++] = ((c3 & 3) << 6) | c4;
+    }
+    return bytes;
 }
-export {
-  concat,
-  fromBase64,
-  fromHex,
-  toBase64,
-  toHex
-};
-//# sourceMappingURL=bytes.js.map
+//# sourceMappingURL=bytes.js.map

package/dist/utils/bytes.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/utils/bytes.ts"],
-  "mappings": "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",
-  "names": []
-}
+{"version":3,"file":"bytes.js","sourceRoot":"","sources":["../../src/utils/bytes.ts"],"names":[],"mappings":"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"}

package/dist/utils/date-format.d.ts

@@ -1,5 +1,5 @@
 /**
- * Result of year/month/day normalization when setting month
+ * 월 설정 시 연/월/일 정규화 결과
  */
 export interface DtNormalizedMonth {
     year: number;
@@ -7,14 +7,14 @@ export interface DtNormalizedMonth {
     day: number;
 }
 /**
- * Normalize year/month/day when setting month
- * - Adjust year if month is outside 1-12 range
- * - Adjust to last day of target month if current day is greater than the number of days in the target month
+ * 월 설정 시 연/월/일 정규화
+ * - 월이 1-12 범위를 벗어나면 연도 조정
+ * - 현재 일이 대상 월의 일수보다 크면 해당 월의 마지막 일로 조정
  *
- * @param year Base year
- * @param month Month to set (values outside 1-12 range allowed)
- * @param day Base day
- * @returns Normalized year, month, day
+ * @param year 기준 연도
+ * @param month 설정할 월 (1-12 범위 밖의 값 허용)
+ * @param day 기준 일
+ * @returns 정규화된 연도, 월, 일
  *
  * @example
  * normalizeMonth(2025, 13, 15) // { year: 2026, month: 1, day: 15 }
@@ -22,48 +22,48 @@ export interface DtNormalizedMonth {
  */
 export declare function normalizeMonth(year: number, month: number, day: number): DtNormalizedMonth;
 /**
- * Convert 12-hour format to 24-hour format
+ * 12시간 형식을 24시간 형식으로 변환
  * - 12:00 AM = 0:00, 12:00 PM = 12:00
  * - 1-11 AM = 1-11, 1-11 PM = 13-23
  *
- * @param rawHour 12-hour format hour (1-12)
- * @param isPM Whether PM
- * @returns 24-hour format hour (0-23)
+ * @param rawHour 12시간 형식의 시 (1-12)
+ * @param isPM 오후 여부
+ * @returns 24시간 형식의 시 (0-23)
  */
 export declare function convert12To24(rawHour: number, isPM: boolean): number;
 /**
- * Convert date/time to string according to format string
+ * 형식 문자열에 따라 날짜/시간을 문자열로 변환
  *
- * @param formatString Format string
- * @param args Date/time components
+ * @param formatString 형식 문자열
+ * @param args 날짜/시간 구성요소
  *
  * @remarks
- * Supports the same format strings as C#:
+ * C#과 동일한 형식 문자열을 지원:
  *
- * | Format | Description | Example |
- * |--------|-------------|---------|
- * | yyyy | 4-digit year | 2024 |
- * | yy | 2-digit year | 24 |
- * | MM | Zero-padded month | 01~12 |
- * | M | Month | 1~12 |
- * | ddd | Day of week | Sun, Mon, Tue, Wed, Thu, Fri, Sat |
- * | dd | Zero-padded day | 01~31 |
- * | d | Day | 1~31 |
- * | tt | AM/PM | AM, PM |
- * | hh | Zero-padded 12-hour | 01~12 |
- * | h | 12-hour | 1~12 |
- * | HH | Zero-padded 24-hour | 00~23 |
- * | H | 24-hour | 0~23 |
- * | mm | Zero-padded minute | 00~59 |
- * | m | Minute | 0~59 |
- * | ss | Zero-padded second | 00~59 |
- * | s | Second | 0~59 |
- * | fff | Milliseconds (3 digits) | 000~999 |
- * | ff | Milliseconds (2 digits) | 00~99 |
- * | f | Milliseconds (1 digit) | 0~9 |
- * | zzz | Timezone offset (±HH:mm) | +09:00 |
- * | zz | Timezone offset (±HH) | +09 |
- * | z | Timezone offset (±H) | +9 |
+ * | 형식 | 설명 | 예시 |
+ * |------|------|------|
+ * | yyyy | 4자리 연도 | 2024 |
+ * | yy | 2자리 연도 | 24 |
+ * | MM | 0 채움 월 | 01~12 |
+ * | M | 월 | 1~12 |
+ * | ddd | 요일 | 일, 월, 화, 수, 목, 금, 토 |
+ * | dd | 0 채움 일 | 01~31 |
+ * | d | 일 | 1~31 |
+ * | tt | 오전/오후 | AM, PM |
+ * | hh | 0 채움 12시간 | 01~12 |
+ * | h | 12시간 | 1~12 |
+ * | HH | 0 채움 24시간 | 00~23 |
+ * | H | 24시간 | 0~23 |
+ * | mm | 0 채움 분 | 00~59 |
+ * | m | 분 | 0~59 |
+ * | ss | 0 채움 초 | 00~59 |
+ * | s | 초 | 0~59 |
+ * | fff | 밀리초 (3자리) | 000~999 |
+ * | ff | 밀리초 (2자리) | 00~99 |
+ * | f | 밀리초 (1자리) | 0~9 |
+ * | zzz | 타임존 오프셋 (±HH:mm) | +09:00 |
+ * | zz | 타임존 오프셋 (±HH) | +09 |
+ * | z | 타임존 오프셋 (±H) | +9 |
  *
  * @example
  * ```typescript