@simplysm/core-common 13.0.100 → 14.0.1

package/dist/common.types.d.ts

@@ -3,12 +3,12 @@ import { DateOnly } from "./types/date-only";
 import { Time } from "./types/time";
 import { Uuid } from "./types/uuid";
 /**
- * Binary type used instead of Buffer
+ * Buffer 대신 사용하는 바이너리 타입
  */
 export type Bytes = Uint8Array;
 /**
- * Primitive type mapping
- * Shared with orm-common
+ * 원시 타입 매핑
+ * orm-common과 공유
  */
 export type PrimitiveTypeMap = {
     string: string;
@@ -21,19 +21,19 @@ export type PrimitiveTypeMap = {
     Bytes: Bytes;
 };
 /**
- * Primitive type string key
+ * 원시 타입 문자열 key
  */
 export type PrimitiveTypeStr = keyof PrimitiveTypeMap;
 /**
- * Primitive type union
+ * 원시 타입 union
  */
 export type PrimitiveType = PrimitiveTypeMap[PrimitiveTypeStr] | undefined;
 /**
- * Deep Partial type
+ * Deep Partial 타입
  *
- * Recursively makes all properties of an object optional.
- * Primitive types (string, number, boolean, etc.) are kept as-is,
- * only object/array types have Partial applied recursively.
+ * 객체의 모든 속성을 재귀적으로 optional로 만든다.
+ * 원시 타입(string, number, boolean 등)은 그대로 유지하고,
+ * object/array 타입에만 재귀적으로 Partial을 적용한다.
  *
  * @example
  * ```typescript
@@ -45,7 +45,7 @@ export type PrimitiveType = PrimitiveTypeMap[PrimitiveTypeStr] | undefined;
  *   };
  * }
  *
- * // All properties at every depth become optional
+ * // 모든 깊이의 속성이 optional이 됨
  * const partial: DeepPartial<User> = {
  *   profile: { address: {} }
  * };
@@ -55,10 +55,10 @@ export type DeepPartial<TObject> = Partial<{
     [K in keyof TObject]: TObject[K] extends PrimitiveType ? TObject[K] : DeepPartial<TObject[K]>;
 }>;
 /**
- * Constructor type
+ * 생성자 타입
  *
- * Used to represent a class constructor as a type.
- * Primarily used in dependency injection, factory patterns, and instanceof checks.
+ * 클래스 생성자를 타입으로 표현할 때 사용한다.
+ * 주로 의존성 주입, 팩토리 패턴, instanceof 체크에 활용된다.
  *
  * @example
  * function create<T>(ctor: Type<T>): T {
@@ -66,7 +66,7 @@ export type DeepPartial<TObject> = Partial<{
  * }
  *
  * class MyClass { name = "test"; }
- * const instance = create(MyClass); // MyClass instance
+ * const instance = create(MyClass); // MyClass 인스턴스
  */
 export interface Type<TInstance> extends Function {
     new (...args: unknown[]): TInstance;

package/dist/common.types.js

@@ -2,4 +2,5 @@ import { DateTime } from "./types/date-time.js";
 import { DateOnly } from "./types/date-only.js";
 import { Time } from "./types/time.js";
 import { Uuid } from "./types/uuid.js";
-//# sourceMappingURL=common.types.js.map
+//#endregion
+//# sourceMappingURL=common.types.js.map

package/dist/common.types.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/common.types.ts"],
-  "mappings": "AAAA,SAAS,gBAAgB;AACzB,SAAS,gBAAgB;AACzB,SAAS,YAAY;AACrB,SAAS,YAAY;",
-  "names": []
-}
+{"version":3,"file":"common.types.js","sourceRoot":"","sources":["../src/common.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAuFpC,YAAY"}

package/dist/env.d.ts

@@ -3,6 +3,11 @@ declare global {
         env?: Record<string, unknown>;
     }
 }
+/**
+ * 환경변수 값을 boolean으로 파싱
+ * "true", "1", "yes", "on" (대소문자 무시) → true, 그 외 → false
+ */
+export declare function parseBoolEnv(value: unknown): boolean;
 export declare const env: {
     DEV: boolean;
     VER?: string;

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B;CACF;AAMD,eAAO,MAAM,GAAG,EAAE;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAKxB,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAEA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAC/B;CACF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEpD;AAMD,eAAO,MAAM,GAAG,EAAE;IAChB,GAAG,EAAE,OAAO,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAKxB,CAAC"}

package/dist/env.js

@@ -1,12 +1,16 @@
+/**
+ * 환경변수 값을 boolean으로 파싱
+ * "true", "1", "yes", "on" (대소문자 무시) → true, 그 외 → false
+ */
+export function parseBoolEnv(value) {
+    return ["true", "1", "yes", "on"].includes(String(value ?? "").toLowerCase());
+}
 const _metaEnv = import.meta.env ?? {};
 const _processEnv = typeof process !== "undefined" ? process.env : {};
 const _raw = { ..._metaEnv, ..._processEnv };
-const env = {
-  ..._raw,
-  DEV: JSON.parse(String(_raw["DEV"] != null && String(_raw["DEV"]) !== "" ? _raw["DEV"] : false)),
-  VER: _raw["VER"]
+export const env = {
+    ..._raw,
+    DEV: parseBoolEnv(_raw["DEV"]),
+    VER: _raw["VER"],
 };
-export {
-  env
-};
-//# sourceMappingURL=env.js.map
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../src/env.ts"],
-  "mappings": "AAQA,MAAM,WAAoC,YAAY,OAAO,CAAC;AAC9D,MAAM,cAAuC,OAAO,YAAY,cAAc,QAAQ,MAAM,CAAC;AAC7F,MAAM,OAAgC,EAAE,GAAG,UAAU,GAAG,YAAY;AAE7D,MAAM,MAIT;AAAA,EACF,GAAG;AAAA,EACH,KAAK,KAAK,MAAM,OAAO,KAAK,KAAK,KAAK,QAAQ,OAAO,KAAK,KAAK,CAAC,MAAM,KAAK,KAAK,KAAK,IAAI,KAAK,CAAC;AAAA,EAC/F,KAAK,KAAK,KAAK;AACjB;",
-  "names": []
-}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,QAAQ,GAA4B,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;AAChE,MAAM,WAAW,GAA4B,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/F,MAAM,IAAI,GAA4B,EAAE,GAAG,QAAQ,EAAE,GAAG,WAAW,EAAE,CAAC;AAEtE,MAAM,CAAC,MAAM,GAAG,GAIZ;IACF,GAAG,IAAI;IACP,GAAG,EAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,GAAG,EAAE,IAAI,CAAC,KAAK,CAAuB;CACvC,CAAC"}

package/dist/errors/argument-error.d.ts

@@ -1,24 +1,24 @@
 import { SdError } from "./sd-error";
 /**
- * Argument error
+ * 인자 오류
  *
- * An error thrown when invalid arguments are received.
- * Includes the argument object in YAML format in the message to facilitate debugging.
+ * 유효하지 않은 인자를 전달받았을 때 발생하는 에러.
+ * 디버깅을 용이하게 하기 위해 인자 객체를 YAML 형식으로 메시지에 포함한다.
  *
  * @example
- * // Passing only the argument object
+ * // 인자 객체만 전달
  * throw new ArgumentError({ userId: 123, name: null });
- * // Result message: "Invalid arguments.\n\nuserId: 123\nname: null"
+ * // 결과 메시지: "잘못된 인자입니다.\n\nuserId: 123\nname: null"
  *
  * @example
- * // Passing a custom message and argument object
- * throw new ArgumentError("Invalid user", { userId: 123 });
- * // Result message: "Invalid user\n\nuserId: 123"
+ * // 커스텀 메시지와 인자 객체를 전달
+ * throw new ArgumentError("잘못된 사용자", { userId: 123 });
+ * // 결과 메시지: "잘못된 사용자\n\nuserId: 123"
  */
 export declare class ArgumentError extends SdError {
-    /** Output argument object in YAML format with default message ("Invalid arguments.") */
+    /** 기본 메시지("잘못된 인자입니다.")와 함께 인자 객체를 YAML 형식으로 출력 */
     constructor(argObj: Record<string, unknown>);
-    /** Output argument object in YAML format with a custom message */
+    /** 커스텀 메시지와 함께 인자 객체를 YAML 형식으로 출력 */
     constructor(message: string, argObj: Record<string, unknown>);
     constructor(arg1: Record<string, unknown> | string, arg2?: Record<string, unknown>);
 }

package/dist/errors/argument-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"argument-error.d.ts","sourceRoot":"","sources":["../../src/errors/argument-error.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,wFAAwF;gBAC5E,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3C,kEAAkE;gBACtD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYnF"}
+{"version":3,"file":"argument-error.d.ts","sourceRoot":"","sources":["../../src/errors/argument-error.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,mDAAmD;gBACvC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3C,sCAAsC;gBAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;gBAChD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAYnF"}

package/dist/errors/argument-error.js

@@ -1,18 +1,35 @@
+// yaml 라이브러리를 사용하는 이유:
+// 중첩된 객체 구조를 읽기 쉬운 형식으로 표현하기 위함.
+// JSON.stringify보다 트리 구조가 더 명확하게 보임.
 import YAML from "yaml";
 import { SdError } from "./sd-error.js";
-class ArgumentError extends SdError {
-  constructor(arg1, arg2) {
-    const message = typeof arg1 === "string" ? arg1 : void 0;
-    const argObj = typeof arg1 === "string" ? arg2 : arg1;
-    if (argObj != null) {
-      super((message ?? "Invalid arguments.") + "\n\n" + YAML.stringify(argObj));
-    } else {
-      super(message ?? "Invalid arguments.");
+/**
+ * 인자 오류
+ *
+ * 유효하지 않은 인자를 전달받았을 때 발생하는 에러.
+ * 디버깅을 용이하게 하기 위해 인자 객체를 YAML 형식으로 메시지에 포함한다.
+ *
+ * @example
+ * // 인자 객체만 전달
+ * throw new ArgumentError({ userId: 123, name: null });
+ * // 결과 메시지: "잘못된 인자입니다.\n\nuserId: 123\nname: null"
+ *
+ * @example
+ * // 커스텀 메시지와 인자 객체를 전달
+ * throw new ArgumentError("잘못된 사용자", { userId: 123 });
+ * // 결과 메시지: "잘못된 사용자\n\nuserId: 123"
+ */
+export class ArgumentError extends SdError {
+    constructor(arg1, arg2) {
+        const message = typeof arg1 === "string" ? arg1 : undefined;
+        const argObj = typeof arg1 === "string" ? arg2 : arg1;
+        if (argObj != null) {
+            super((message ?? "잘못된 인자입니다.") + "\n\n" + YAML.stringify(argObj));
+        }
+        else {
+            super(message ?? "잘못된 인자입니다.");
+        }
+        this.name = "ArgumentError";
     }
-    this.name = "ArgumentError";
-  }
 }
-export {
-  ArgumentError
-};
-//# sourceMappingURL=argument-error.js.map
+//# sourceMappingURL=argument-error.js.map

package/dist/errors/argument-error.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/errors/argument-error.ts"],
-  "mappings": "AAGA,OAAO,UAAU;AACjB,SAAS,eAAe;AAkBjB,MAAM,sBAAsB,QAAQ;AAAA,EAMzC,YAAY,MAAwC,MAAgC;AAClF,UAAM,UAAU,OAAO,SAAS,WAAW,OAAO;AAClD,UAAM,SAAS,OAAO,SAAS,WAAW,OAAO;AAEjD,QAAI,UAAU,MAAM;AAClB,aAAO,WAAW,wBAAwB,SAAS,KAAK,UAAU,MAAM,CAAC;AAAA,IAC3E,OAAO;AACL,YAAM,WAAW,oBAAoB;AAAA,IACvC;AACA,SAAK,OAAO;AAAA,EACd;AACF;",
-  "names": []
-}
+{"version":3,"file":"argument-error.js","sourceRoot":"","sources":["../../src/errors/argument-error.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,iCAAiC;AACjC,qCAAqC;AACrC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,aAAc,SAAQ,OAAO;IAMxC,YAAY,IAAsC,EAAE,IAA8B;QAChF,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,MAAM,MAAM,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QAEtD,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACnB,KAAK,CAAC,CAAC,OAAO,IAAI,YAAY,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,OAAO,IAAI,YAAY,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/errors/not-implemented-error.d.ts

@@ -1,28 +1,28 @@
 import { SdError } from "./sd-error";
 /**
- * Not implemented error
+ * 미구현 오류
  *
- * An error thrown when a feature that has not yet been implemented is called.
- * Used for abstract method stubs, branches planned for future implementation, etc.
+ * 아직 구현되지 않은 기능이 호출되었을 때 발생하는 에러.
+ * 추상 메서드 스텁, 향후 구현 예정인 분기 등에 사용된다.
  *
  * @example
- * // Before abstract method implementation
+ * // 추상 메서드 구현 전
  * class BaseService {
  *   process(): void {
- *     throw new NotImplementedError("Implementation required in subclass");
+ *     throw new NotImplementedError("서브클래스에서 구현 필요");
  *   }
  * }
  *
  * @example
- * // Branch planned for future implementation
+ * // 향후 구현 예정인 분기
  * switch (type) {
  *   case "A": return handleA();
- *   case "B": throw new NotImplementedError(`Handling for type ${type}`);
+ *   case "B": throw new NotImplementedError(`타입 ${type} 처리`);
  * }
  */
 export declare class NotImplementedError extends SdError {
     /**
-     * @param message Additional description message
+     * @param message 추가 설명 메시지
      */
     constructor(message?: string);
 }

package/dist/errors/not-implemented-error.js

@@ -1,14 +1,32 @@
 import { SdError } from "./sd-error.js";
-class NotImplementedError extends SdError {
-  /**
-   * @param message Additional description message
-   */
-  constructor(message) {
-    super("Not implemented" + (message != null ? ": " + message : ""));
-    this.name = "NotImplementedError";
-  }
+/**
+ * 미구현 오류
+ *
+ * 아직 구현되지 않은 기능이 호출되었을 때 발생하는 에러.
+ * 추상 메서드 스텁, 향후 구현 예정인 분기 등에 사용된다.
+ *
+ * @example
+ * // 추상 메서드 구현 전
+ * class BaseService {
+ *   process(): void {
+ *     throw new NotImplementedError("서브클래스에서 구현 필요");
+ *   }
+ * }
+ *
+ * @example
+ * // 향후 구현 예정인 분기
+ * switch (type) {
+ *   case "A": return handleA();
+ *   case "B": throw new NotImplementedError(`타입 ${type} 처리`);
+ * }
+ */
+export class NotImplementedError extends SdError {
+    /**
+     * @param message 추가 설명 메시지
+     */
+    constructor(message) {
+        super("미구현" + (message != null ? ": " + message : ""));
+        this.name = "NotImplementedError";
+    }
 }
-export {
-  NotImplementedError
-};
-//# sourceMappingURL=not-implemented-error.js.map
+//# sourceMappingURL=not-implemented-error.js.map

package/dist/errors/not-implemented-error.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/errors/not-implemented-error.ts"],
-  "mappings": "AAAA,SAAS,eAAe;AAuBjB,MAAM,4BAA4B,QAAQ;AAAA;AAAA;AAAA;AAAA,EAI/C,YAAY,SAAkB;AAC5B,UAAM,qBAAqB,WAAW,OAAO,OAAO,UAAU,GAAG;AACjE,SAAK,OAAO;AAAA,EACd;AACF;",
-  "names": []
-}
+{"version":3,"file":"not-implemented-error.js","sourceRoot":"","sources":["../../src/errors/not-implemented-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,OAAO;IAC9C;;OAEG;IACH,YAAY,OAAgB;QAC1B,KAAK,CAAC,KAAK,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}

package/dist/errors/sd-error.d.ts

@@ -1,26 +1,26 @@
 /**
- * Error class supporting Tree structure composition
- * Utilizes ES2024 cause property
+ * 트리 구조 조합을 지원하는 에러 클래스
+ * ES2024 cause 속성을 활용
  *
  * @example
- * // Wrap a cause error
+ * // 원인 에러를 감싸기
  * try {
  *   await fetch(url);
  * } catch (err) {
- *   throw new SdError(err, "API call failed", "User load failed");
+ *   throw new SdError(err, "API 호출 실패", "사용자 로드 실패");
  * }
- * // Result message: "User load failed => API call failed => original error message"
+ * // 결과 메시지: "사용자 로드 실패 => API 호출 실패 => 원본 에러 메시지"
  *
  * @example
- * // Create with message only
- * throw new SdError("invalid state", "processing not possible");
- * // Result message: "processing not possible => invalid state"
+ * // 메시지만으로 생성
+ * throw new SdError("잘못된 상태", "처리 불가");
+ * // 결과 메시지: "처리 불가 => 잘못된 상태"
  */
 export declare class SdError extends Error {
     cause?: Error;
-    /** Create by wrapping a cause error. Messages are joined in reverse order (upper message => lower message => cause message) */
+    /** 원인 에러를 감싸서 생성. 메시지는 역순으로 결합됨 (상위 메시지 => 하위 메시지 => 원인 메시지) */
     constructor(cause: Error, ...messages: string[]);
-    /** Create with messages only. Messages are joined in reverse order (upper message => lower message) */
+    /** 메시지만으로 생성. 메시지는 역순으로 결합됨 (상위 메시지 => 하위 메시지) */
     constructor(...messages: string[]);
     constructor(arg1?: unknown, ...messages: string[]);
 }

package/dist/errors/sd-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sd-error.d.ts","sourceRoot":"","sources":["../../src/errors/sd-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IAEvB,+HAA+H;gBACnH,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;IAC/C,uGAAuG;gBAC3F,GAAG,QAAQ,EAAE,MAAM,EAAE;gBACrB,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;CAoClD"}
+{"version":3,"file":"sd-error.d.ts","sourceRoot":"","sources":["../../src/errors/sd-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,OAAQ,SAAQ,KAAK;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IAEvB,gEAAgE;gBACpD,KAAK,EAAE,KAAK,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;IAC/C,kDAAkD;gBACtC,GAAG,QAAQ,EAAE,MAAM,EAAE;gBACrB,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE;CAoClD"}

package/dist/errors/sd-error.js

@@ -1,26 +1,47 @@
-class SdError extends Error {
-  cause;
-  constructor(arg1, ...messages) {
-    const arg1Message = arg1 instanceof Error ? arg1.message : typeof arg1 === "string" ? arg1 : arg1 != null ? String(arg1) : void 0;
-    const fullMessage = [arg1Message, ...messages].filter((m) => m != null).reverse().join(" => ");
-    const cause = arg1 instanceof Error ? arg1 : void 0;
-    super(fullMessage, { cause });
-    Object.setPrototypeOf(this, new.target.prototype);
-    this.name = "SdError";
-    if ("captureStackTrace" in Error) {
-      Error.captureStackTrace(
-        this,
-        new.target
-      );
+/**
+ * 트리 구조 조합을 지원하는 에러 클래스
+ * ES2024 cause 속성을 활용
+ *
+ * @example
+ * // 원인 에러를 감싸기
+ * try {
+ *   await fetch(url);
+ * } catch (err) {
+ *   throw new SdError(err, "API 호출 실패", "사용자 로드 실패");
+ * }
+ * // 결과 메시지: "사용자 로드 실패 => API 호출 실패 => 원본 에러 메시지"
+ *
+ * @example
+ * // 메시지만으로 생성
+ * throw new SdError("잘못된 상태", "처리 불가");
+ * // 결과 메시지: "처리 불가 => 잘못된 상태"
+ */
+export class SdError extends Error {
+    cause;
+    constructor(arg1, ...messages) {
+        const arg1Message = arg1 instanceof Error
+            ? arg1.message
+            : typeof arg1 === "string"
+                ? arg1
+                : arg1 != null
+                    ? String(arg1)
+                    : undefined;
+        const fullMessage = [arg1Message, ...messages]
+            .filter((m) => m != null)
+            .reverse()
+            .join(" => ");
+        const cause = arg1 instanceof Error ? arg1 : undefined;
+        super(fullMessage, { cause });
+        Object.setPrototypeOf(this, new.target.prototype);
+        this.name = "SdError";
+        // captureStackTrace는 V8 엔진(Node.js, Chrome)에서만 사용 가능
+        if ("captureStackTrace" in Error) {
+            Error.captureStackTrace(this, new.target);
+        }
+        // 원인 체인 stack을 현재 stack에 추가
+        if (cause?.stack != null) {
+            this.stack += `\n---- cause stack ----\n${cause.stack}`;
+        }
     }
-    if ((cause == null ? void 0 : cause.stack) != null) {
-      this.stack += `
----- cause stack ----
-${cause.stack}`;
-    }
-  }
 }
-export {
-  SdError
-};
-//# sourceMappingURL=sd-error.js.map
+//# sourceMappingURL=sd-error.js.map

package/dist/errors/sd-error.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/errors/sd-error.ts"],
-  "mappings": "AAkBO,MAAM,gBAAgB,MAAM;AAAA,EACxB;AAAA,EAOT,YAAY,SAAmB,UAAoB;AACjD,UAAM,cACJ,gBAAgB,QACZ,KAAK,UACL,OAAO,SAAS,WACd,OACA,QAAQ,OACN,OAAO,IAAI,IACX;AAEV,UAAM,cAAc,CAAC,aAAa,GAAG,QAAQ,EAC1C,OAAO,CAAC,MAAM,KAAK,IAAI,EACvB,QAAQ,EACR,KAAK,MAAM;AAEd,UAAM,QAAQ,gBAAgB,QAAQ,OAAO;AAE7C,UAAM,aAAa,EAAE,MAAM,CAAC;AAE5B,WAAO,eAAe,MAAM,WAAW,SAAS;AAChD,SAAK,OAAO;AAGZ,QAAI,uBAAuB,OAAO;AAChC,MAAC,MAAM;AAAA,QACL;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAGA,SAAI,+BAAO,UAAS,MAAM;AACxB,WAAK,SAAS;AAAA;AAAA,EAA4B,MAAM,KAAK;AAAA,IACvD;AAAA,EACF;AACF;",
-  "names": []
-}
+{"version":3,"file":"sd-error.js","sourceRoot":"","sources":["../../src/errors/sd-error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,OAAQ,SAAQ,KAAK;IACvB,KAAK,CAAS;IAOvB,YAAY,IAAc,EAAE,GAAG,QAAkB;QAC/C,MAAM,WAAW,GACf,IAAI,YAAY,KAAK;YACnB,CAAC,CAAC,IAAI,CAAC,OAAO;YACd,CAAC,CAAC,OAAO,IAAI,KAAK,QAAQ;gBACxB,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,IAAI,IAAI,IAAI;oBACZ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;oBACd,CAAC,CAAC,SAAS,CAAC;QAEpB,MAAM,WAAW,GAAG,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC;aAC3C,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC;aACxB,OAAO,EAAE;aACT,IAAI,CAAC,MAAM,CAAC,CAAC;QAEhB,MAAM,KAAK,GAAG,IAAI,YAAY,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAEvD,KAAK,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAE9B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QAEtB,qDAAqD;QACrD,IAAI,mBAAmB,IAAI,KAAK,EAAE,CAAC;YAChC,KAAK,CAAC,iBAA+E,CACpF,IAAI,EACJ,GAAG,CAAC,MAAM,CACX,CAAC;QACJ,CAAC;QAED,4BAA4B;QAC5B,IAAI,KAAK,EAAE,KAAK,IAAI,IAAI,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,IAAI,4BAA4B,KAAK,CAAC,KAAK,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;CACF"}

package/dist/errors/timeout-error.d.ts

@@ -1,30 +1,30 @@
 import { SdError } from "./sd-error";
 /**
- * Timeout error
+ * 타임아웃 오류
  *
- * An error that occurs when the waiting time is exceeded.
- * Automatically thrown when the maximum number of attempts is exceeded in async waiting functions like Wait.until().
+ * 대기 시간이 초과되었을 때 발생하는 에러.
+ * Wait.until() 같은 비동기 대기 함수에서 최대 시도 횟수를 초과하면 자동으로 발생한다.
  *
  * @example
- * // Automatically thrown from Wait.until
+ * // Wait.until에서 자동 발생
  * try {
- *   await Wait.until(() => isReady, 100, 50); // 100ms interval, max 50 attempts
+ *   await Wait.until(() => isReady, 100, 50); // 100ms 간격, 최대 50회 시도
  * } catch (err) {
  *   if (err instanceof TimeoutError) {
- *     console.log("Timeout exceeded");
+ *     console.log("타임아웃 초과");
  *   }
  * }
  *
  * @example
- * // Thrown directly
+ * // 직접 발생
  * if (elapsed > maxTime) {
- *   throw new TimeoutError(undefined, "Waiting for API response exceeded");
+ *   throw new TimeoutError(undefined, "API 응답 대기 초과");
  * }
  */
 export declare class TimeoutError extends SdError {
     /**
-     * @param count Number of attempts
-     * @param message Additional message
+     * @param count 시도 횟수
+     * @param message 추가 메시지
      */
     constructor(count?: number, message?: string);
 }

package/dist/errors/timeout-error.js

@@ -1,17 +1,36 @@
 import { SdError } from "./sd-error.js";
-class TimeoutError extends SdError {
-  /**
-   * @param count Number of attempts
-   * @param message Additional message
-   */
-  constructor(count, message) {
-    super(
-      "Waiting time exceeded" + (count != null ? `(${count} attempts)` : "") + (message != null ? `: ${message}` : "")
-    );
-    this.name = "TimeoutError";
-  }
+/**
+ * 타임아웃 오류
+ *
+ * 대기 시간이 초과되었을 때 발생하는 에러.
+ * Wait.until() 같은 비동기 대기 함수에서 최대 시도 횟수를 초과하면 자동으로 발생한다.
+ *
+ * @example
+ * // Wait.until에서 자동 발생
+ * try {
+ *   await Wait.until(() => isReady, 100, 50); // 100ms 간격, 최대 50회 시도
+ * } catch (err) {
+ *   if (err instanceof TimeoutError) {
+ *     console.log("타임아웃 초과");
+ *   }
+ * }
+ *
+ * @example
+ * // 직접 발생
+ * if (elapsed > maxTime) {
+ *   throw new TimeoutError(undefined, "API 응답 대기 초과");
+ * }
+ */
+export class TimeoutError extends SdError {
+    /**
+     * @param count 시도 횟수
+     * @param message 추가 메시지
+     */
+    constructor(count, message) {
+        super("대기 시간 초과" +
+            (count != null ? `(${count}회 시도)` : "") +
+            (message != null ? `: ${message}` : ""));
+        this.name = "TimeoutError";
+    }
 }
-export {
-  TimeoutError
-};
-//# sourceMappingURL=timeout-error.js.map
+//# sourceMappingURL=timeout-error.js.map

package/dist/errors/timeout-error.js.map

@@ -1,6 +1 @@
-{
-  "version": 3,
-  "sources": ["../../src/errors/timeout-error.ts"],
-  "mappings": "AAAA,SAAS,eAAe;AAwBjB,MAAM,qBAAqB,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA,EAKxC,YAAY,OAAgB,SAAkB;AAC5C;AAAA,MACE,2BACG,SAAS,OAAO,IAAI,KAAK,eAAe,OACxC,WAAW,OAAO,KAAK,OAAO,KAAK;AAAA,IACxC;AACA,SAAK,OAAO;AAAA,EACd;AACF;",
-  "names": []
-}
+{"version":3,"file":"timeout-error.js","sourceRoot":"","sources":["../../src/errors/timeout-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,YAAa,SAAQ,OAAO;IACvC;;;OAGG;IACH,YAAY,KAAc,EAAE,OAAgB;QAC1C,KAAK,CACH,UAAU;YACR,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACvC,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC1C,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/extensions/arr-ext.d.ts

@@ -1,7 +1,7 @@
 /**
- * Array extension methods
+ * Array 확장 메서드
  *
- * @remarks See type definition file (arr-ext.types.ts) for TSDoc of each method
+ * @remarks 각 메서드의 TSDoc은 타입 정의 파일(arr-ext.types.ts)을 참조
  */
 import "./map-ext";
 import type { ReadonlyArrayExt, MutableArrayExt } from "./arr-ext.types";

package/dist/extensions/arr-ext.helpers.d.ts

@@ -1,24 +1,24 @@
 /**
- * Array extension helper functions
+ * Array 확장 헬퍼 함수
  */
 import type { ComparableType } from "./arr-ext.types";
 /**
- * Convert DateTime, DateOnly, Time to comparable primitive values
+ * DateTime, DateOnly, Time을 비교 가능한 원시 값으로 변환
  */
 export declare function toComparable(value: ComparableType): string | number | boolean | undefined;
 /**
- * Comparison function for sorting
+ * 정렬용 비교 함수
  *
- * @param pp comparison target 1
- * @param pn comparison target 2
- * @param desc true: descending, false: ascending
- * @returns negative: pp comes first, 0: equal, positive: pn comes first
- * @note null/undefined values are sorted first in ascending, last in descending
+ * @param pp 비교 대상 1
+ * @param pn 비교 대상 2
+ * @param desc true: 내림차순, false: 오름차순
+ * @returns 음수: pp가 앞, 0: 같음, 양수: pn이 앞
+ * @note null/undefined 값은 오름차순에서 앞, 내림차순에서 뒤로 정렬됨
  */
 export declare function compareForOrder(pp: ComparableType, pn: ComparableType, desc: boolean): number;
 /**
- * Returns a Set of indices to KEEP (i.e., first occurrence of each unique item).
- * Handles all deduplication strategies: matchAddress, keyFn, and default type-based.
+ * 유지할 index의 Set을 반환 (즉, 각 고유 항목의 첫 번째 등장 위치).
+ * matchAddress, keyFn, 기본 타입 기반 등 모든 중복 제거 전략을 처리한다.
  */
 export declare function getDistinctIndices<TItem>(items: readonly TItem[], options?: boolean | {
     matchAddress?: boolean;