@simplysm/core-node 13.0.0-beta.6 → 13.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (108) hide show
  1. package/dist/features/fs-watcher.d.ts.map +1 -0
  2. package/dist/features/fs-watcher.js +3 -3
  3. package/dist/features/fs-watcher.js.map +1 -2
  4. package/dist/index.d.ts.map +1 -0
  5. package/dist/index.js +6 -6
  6. package/dist/index.js.map +0 -1
  7. package/dist/utils/fs.d.ts.map +1 -0
  8. package/dist/utils/fs.js.map +0 -1
  9. package/dist/utils/path.d.ts.map +1 -0
  10. package/dist/utils/path.js.map +0 -1
  11. package/dist/worker/create-worker.d.ts.map +1 -0
  12. package/dist/worker/create-worker.js.map +0 -1
  13. package/dist/worker/types.d.ts.map +1 -0
  14. package/dist/worker/types.js.map +0 -1
  15. package/dist/worker/worker.d.ts.map +1 -0
  16. package/dist/worker/worker.js +4 -3
  17. package/dist/worker/worker.js.map +1 -2
  18. package/package.json +10 -6
  19. package/src/features/fs-watcher.ts +2 -2
  20. package/src/worker/worker.ts +5 -3
  21. package/.cache/typecheck-node.tsbuildinfo +0 -1
  22. package/.cache/typecheck-tests-node.tsbuildinfo +0 -1
  23. package/dist/core-common/src/common.types.d.ts +0 -74
  24. package/dist/core-common/src/common.types.d.ts.map +0 -1
  25. package/dist/core-common/src/env.d.ts +0 -6
  26. package/dist/core-common/src/env.d.ts.map +0 -1
  27. package/dist/core-common/src/errors/argument-error.d.ts +0 -25
  28. package/dist/core-common/src/errors/argument-error.d.ts.map +0 -1
  29. package/dist/core-common/src/errors/not-implemented-error.d.ts +0 -29
  30. package/dist/core-common/src/errors/not-implemented-error.d.ts.map +0 -1
  31. package/dist/core-common/src/errors/sd-error.d.ts +0 -27
  32. package/dist/core-common/src/errors/sd-error.d.ts.map +0 -1
  33. package/dist/core-common/src/errors/timeout-error.d.ts +0 -31
  34. package/dist/core-common/src/errors/timeout-error.d.ts.map +0 -1
  35. package/dist/core-common/src/extensions/arr-ext.d.ts +0 -15
  36. package/dist/core-common/src/extensions/arr-ext.d.ts.map +0 -1
  37. package/dist/core-common/src/extensions/arr-ext.helpers.d.ts +0 -19
  38. package/dist/core-common/src/extensions/arr-ext.helpers.d.ts.map +0 -1
  39. package/dist/core-common/src/extensions/arr-ext.types.d.ts +0 -215
  40. package/dist/core-common/src/extensions/arr-ext.types.d.ts.map +0 -1
  41. package/dist/core-common/src/extensions/map-ext.d.ts +0 -57
  42. package/dist/core-common/src/extensions/map-ext.d.ts.map +0 -1
  43. package/dist/core-common/src/extensions/set-ext.d.ts +0 -36
  44. package/dist/core-common/src/extensions/set-ext.d.ts.map +0 -1
  45. package/dist/core-common/src/features/debounce-queue.d.ts +0 -53
  46. package/dist/core-common/src/features/debounce-queue.d.ts.map +0 -1
  47. package/dist/core-common/src/features/event-emitter.d.ts +0 -66
  48. package/dist/core-common/src/features/event-emitter.d.ts.map +0 -1
  49. package/dist/core-common/src/features/serial-queue.d.ts +0 -47
  50. package/dist/core-common/src/features/serial-queue.d.ts.map +0 -1
  51. package/dist/core-common/src/index.d.ts +0 -32
  52. package/dist/core-common/src/index.d.ts.map +0 -1
  53. package/dist/core-common/src/types/date-only.d.ts +0 -152
  54. package/dist/core-common/src/types/date-only.d.ts.map +0 -1
  55. package/dist/core-common/src/types/date-time.d.ts +0 -96
  56. package/dist/core-common/src/types/date-time.d.ts.map +0 -1
  57. package/dist/core-common/src/types/lazy-gc-map.d.ts +0 -80
  58. package/dist/core-common/src/types/lazy-gc-map.d.ts.map +0 -1
  59. package/dist/core-common/src/types/time.d.ts +0 -68
  60. package/dist/core-common/src/types/time.d.ts.map +0 -1
  61. package/dist/core-common/src/types/uuid.d.ts +0 -35
  62. package/dist/core-common/src/types/uuid.d.ts.map +0 -1
  63. package/dist/core-common/src/utils/bytes.d.ts +0 -51
  64. package/dist/core-common/src/utils/bytes.d.ts.map +0 -1
  65. package/dist/core-common/src/utils/date-format.d.ts +0 -90
  66. package/dist/core-common/src/utils/date-format.d.ts.map +0 -1
  67. package/dist/core-common/src/utils/json.d.ts +0 -34
  68. package/dist/core-common/src/utils/json.d.ts.map +0 -1
  69. package/dist/core-common/src/utils/num.d.ts +0 -60
  70. package/dist/core-common/src/utils/num.d.ts.map +0 -1
  71. package/dist/core-common/src/utils/obj.d.ts +0 -258
  72. package/dist/core-common/src/utils/obj.d.ts.map +0 -1
  73. package/dist/core-common/src/utils/path.d.ts +0 -23
  74. package/dist/core-common/src/utils/path.d.ts.map +0 -1
  75. package/dist/core-common/src/utils/primitive.d.ts +0 -18
  76. package/dist/core-common/src/utils/primitive.d.ts.map +0 -1
  77. package/dist/core-common/src/utils/str.d.ts +0 -103
  78. package/dist/core-common/src/utils/str.d.ts.map +0 -1
  79. package/dist/core-common/src/utils/template-strings.d.ts +0 -84
  80. package/dist/core-common/src/utils/template-strings.d.ts.map +0 -1
  81. package/dist/core-common/src/utils/transferable.d.ts +0 -47
  82. package/dist/core-common/src/utils/transferable.d.ts.map +0 -1
  83. package/dist/core-common/src/utils/wait.d.ts +0 -19
  84. package/dist/core-common/src/utils/wait.d.ts.map +0 -1
  85. package/dist/core-common/src/utils/xml.d.ts +0 -36
  86. package/dist/core-common/src/utils/xml.d.ts.map +0 -1
  87. package/dist/core-common/src/zip/sd-zip.d.ts +0 -80
  88. package/dist/core-common/src/zip/sd-zip.d.ts.map +0 -1
  89. package/dist/core-node/src/features/fs-watcher.d.ts.map +0 -1
  90. package/dist/core-node/src/index.d.ts.map +0 -1
  91. package/dist/core-node/src/utils/fs.d.ts.map +0 -1
  92. package/dist/core-node/src/utils/path.d.ts.map +0 -1
  93. package/dist/core-node/src/worker/create-worker.d.ts.map +0 -1
  94. package/dist/core-node/src/worker/types.d.ts.map +0 -1
  95. package/dist/core-node/src/worker/worker.d.ts.map +0 -1
  96. package/lib/worker-dev-proxy.js +0 -12
  97. package/tests/utils/fs-watcher.spec.ts +0 -295
  98. package/tests/utils/fs.spec.ts +0 -754
  99. package/tests/utils/path.spec.ts +0 -192
  100. package/tests/worker/fixtures/test-worker.ts +0 -35
  101. package/tests/worker/sd-worker.spec.ts +0 -183
  102. /package/dist/{core-node/src/features → features}/fs-watcher.d.ts +0 -0
  103. /package/dist/{core-node/src/index.d.ts → index.d.ts} +0 -0
  104. /package/dist/{core-node/src/utils → utils}/fs.d.ts +0 -0
  105. /package/dist/{core-node/src/utils → utils}/path.d.ts +0 -0
  106. /package/dist/{core-node/src/worker → worker}/create-worker.d.ts +0 -0
  107. /package/dist/{core-node/src/worker → worker}/types.d.ts +0 -0
  108. /package/dist/{core-node/src/worker → worker}/worker.d.ts +0 -0
@@ -1,25 +0,0 @@
1
- import { SdError } from "./sd-error";
2
- /**
3
- * 인수 오류
4
- *
5
- * 잘못된 인수를 받았을 때 발생시키는 에러이다.
6
- * 인수 객체를 YAML 형식으로 메시지에 포함하여 디버깅을 용이하게 한다.
7
- *
8
- * @example
9
- * // 인수 객체만 전달
10
- * throw new ArgumentError({ userId: 123, name: null });
11
- * // 결과 메시지: "인수가 잘못되었습니다.\n\nuserId: 123\nname: null"
12
- *
13
- * @example
14
- * // 커스텀 메시지와 인수 객체 전달
15
- * throw new ArgumentError("유효하지 않은 사용자", { userId: 123 });
16
- * // 결과 메시지: "유효하지 않은 사용자\n\nuserId: 123"
17
- */
18
- export declare class ArgumentError extends SdError {
19
- /** 기본 메시지("인수가 잘못되었습니다.")와 함께 인수 객체를 YAML 형식으로 출력 */
20
- constructor(argObj: Record<string, unknown>);
21
- /** 커스텀 메시지와 함께 인수 객체를 YAML 형식으로 출력 */
22
- constructor(message: string, argObj: Record<string, unknown>);
23
- constructor(arg1: Record<string, unknown> | string, arg2?: Record<string, unknown>);
24
- }
25
- //# sourceMappingURL=argument-error.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"argument-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/argument-error.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,aAAc,SAAQ,OAAO;IACxC,qDAAqD;gBACzC,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"}
@@ -1,29 +0,0 @@
1
- import { SdError } from "./sd-error";
2
- /**
3
- * 미구현 오류
4
- *
5
- * 아직 구현되지 않은 기능을 호출했을 때 발생시키는 에러이다.
6
- * 추상 메서드 스텁, 향후 구현 예정인 분기 등에 사용한다.
7
- *
8
- * @example
9
- * // 추상 메서드 구현 전
10
- * class BaseService {
11
- * process(): void {
12
- * throw new NotImplementedError("서브클래스에서 구현 필요");
13
- * }
14
- * }
15
- *
16
- * @example
17
- * // 향후 구현 예정 분기
18
- * switch (type) {
19
- * case "A": return handleA();
20
- * case "B": throw new NotImplementedError(`타입 ${type} 처리`);
21
- * }
22
- */
23
- export declare class NotImplementedError extends SdError {
24
- /**
25
- * @param message 추가 설명 메시지
26
- */
27
- constructor(message?: string);
28
- }
29
- //# sourceMappingURL=not-implemented-error.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"not-implemented-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/not-implemented-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,mBAAoB,SAAQ,OAAO;IAC9C;;OAEG;gBACS,OAAO,CAAC,EAAE,MAAM;CAI7B"}
@@ -1,27 +0,0 @@
1
- /**
2
- * 오류의 Tree 구조 구성이 가능한 오류 클래스
3
- * ES2024 cause 속성 활용
4
- *
5
- * @example
6
- * // 원인 에러를 감싸서 생성
7
- * try {
8
- * await fetch(url);
9
- * } catch (err) {
10
- * throw new SdError(err, "API 호출 실패", "사용자 로드 실패");
11
- * }
12
- * // 결과 메시지: "사용자 로드 실패 => API 호출 실패 => 원본 에러 메시지"
13
- *
14
- * @example
15
- * // 메시지만으로 생성
16
- * throw new SdError("잘못된 상태", "처리 불가");
17
- * // 결과 메시지: "처리 불가 => 잘못된 상태"
18
- */
19
- export declare class SdError extends Error {
20
- cause?: Error;
21
- /** 원인 에러를 감싸서 생성. 메시지는 역순으로 연결됨 (상위 메시지 => 하위 메시지 => 원인 메시지) */
22
- constructor(cause: Error, ...messages: string[]);
23
- /** 메시지만으로 생성. 메시지는 역순으로 연결됨 (상위 메시지 => 하위 메시지) */
24
- constructor(...messages: string[]);
25
- constructor(arg1?: unknown, ...messages: string[]);
26
- }
27
- //# sourceMappingURL=sd-error.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sd-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/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;CA2BlD"}
@@ -1,31 +0,0 @@
1
- import { SdError } from "./sd-error";
2
- /**
3
- * 타임아웃 오류
4
- *
5
- * 대기 시간이 초과되었을 때 발생하는 에러이다.
6
- * Wait.until() 등의 비동기 대기 함수에서 최대 시도 횟수를 초과하면 자동으로 발생한다.
7
- *
8
- * @example
9
- * // Wait.until에서 자동 발생
10
- * try {
11
- * await Wait.until(() => isReady, 100, 50); // 100ms 간격, 최대 50회
12
- * } catch (err) {
13
- * if (err instanceof TimeoutError) {
14
- * console.log("시간 초과");
15
- * }
16
- * }
17
- *
18
- * @example
19
- * // 직접 발생
20
- * if (elapsed > maxTime) {
21
- * throw new TimeoutError(undefined, "API 응답 대기 초과");
22
- * }
23
- */
24
- export declare class TimeoutError extends SdError {
25
- /**
26
- * @param count 시도 횟수
27
- * @param message 추가 메시지
28
- */
29
- constructor(count?: number, message?: string);
30
- }
31
- //# sourceMappingURL=timeout-error.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"timeout-error.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/errors/timeout-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAa,SAAQ,OAAO;IACvC;;;OAGG;gBACS,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;CAM7C"}
@@ -1,15 +0,0 @@
1
- /**
2
- * Array 확장 메서드
3
- *
4
- * @remarks 각 메서드의 TSDoc은 타입 정의 파일(arr-ext.types.ts) 참조
5
- */
6
- import "./map-ext";
7
- import type { ReadonlyArrayExt, MutableArrayExt } from "./arr-ext.types";
8
- declare global {
9
- interface ReadonlyArray<T> extends ReadonlyArrayExt<T> {
10
- }
11
- interface Array<T> extends ReadonlyArrayExt<T>, MutableArrayExt<T> {
12
- }
13
- }
14
- export type { ArrayDiffsResult, ArrayDiffs2Result, TreeArray, ComparableType } from "./arr-ext.types";
15
- //# sourceMappingURL=arr-ext.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"arr-ext.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/extensions/arr-ext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,WAAW,CAAC;AAUnB,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAIhB,MAAM,iBAAiB,CAAC;AA2uBzB,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,aAAa,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC;KAAG;IACzD,UAAU,KAAK,CAAC,CAAC,CAAE,SAAQ,gBAAgB,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC;KAAG;CACtE;AAID,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}
@@ -1,19 +0,0 @@
1
- /**
2
- * Array 확장 헬퍼 함수
3
- */
4
- import type { ComparableType } from "./arr-ext.types";
5
- /**
6
- * DateTime, DateOnly, Time을 비교 가능한 primitive 값으로 변환
7
- */
8
- export declare function toComparable(value: ComparableType): string | number | boolean | undefined;
9
- /**
10
- * 정렬을 위한 비교 함수
11
- *
12
- * @param pp 비교 대상 1
13
- * @param pn 비교 대상 2
14
- * @param desc true: 내림차순, false: 오름차순
15
- * @returns 음수: pp가 앞, 0: 같음, 양수: pn이 앞
16
- * @note null/undefined 값은 오름차순 시 앞으로, 내림차순 시 뒤로 정렬됨
17
- */
18
- export declare function compareForOrder(pp: ComparableType, pn: ComparableType, desc: boolean): number;
19
- //# sourceMappingURL=arr-ext.helpers.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"arr-ext.helpers.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/extensions/arr-ext.helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAKzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAuB7F"}
@@ -1,215 +0,0 @@
1
- /**
2
- * Array 확장 타입 정의
3
- */
4
- import type { PrimitiveTypeMap, PrimitiveTypeStr, Type } from "../common.types";
5
- import type { DateTime } from "../types/date-time";
6
- import type { DateOnly } from "../types/date-only";
7
- import type { Time } from "../types/time";
8
- export interface ReadonlyArrayExt<T> {
9
- /**
10
- * 조건에 맞는 단일 요소 반환
11
- * @param predicate 필터 조건 (생략 시 배열 전체 대상)
12
- * @returns 요소가 없으면 undefined
13
- * @throws ArgumentError 조건에 맞는 요소가 2개 이상이면 발생
14
- */
15
- single(predicate?: (item: T, index: number) => boolean): T | undefined;
16
- /**
17
- * 첫 번째 요소 반환
18
- * @param predicate 필터 조건 (생략 시 첫 번째 요소 반환)
19
- * @returns 요소가 없으면 undefined
20
- */
21
- first(predicate?: (item: T, index: number) => boolean): T | undefined;
22
- /** 비동기 필터 (순차 실행) */
23
- filterAsync(predicate: (item: T, index: number) => Promise<boolean>): Promise<T[]>;
24
- /**
25
- * 마지막 요소 반환
26
- * @param predicate 필터 조건 (생략 시 마지막 요소 반환)
27
- * @returns 요소가 없으면 undefined
28
- */
29
- last(predicate?: (item: T, index: number) => boolean): T | undefined;
30
- /** null/undefined 제거 */
31
- filterExists(): NonNullable<T>[];
32
- /** 특정 타입의 요소만 필터링 (PrimitiveTypeStr 또는 생성자 타입) */
33
- ofType<K extends PrimitiveTypeStr>(type: K): Extract<T, PrimitiveTypeMap[K]>[];
34
- ofType<N extends T>(type: Type<N>): N[];
35
- /** 비동기 매핑 (순차 실행) */
36
- mapAsync<R>(selector: (item: T, index: number) => Promise<R>): Promise<R[]>;
37
- /** 중첩 배열 평탄화 */
38
- mapMany(): T extends readonly (infer U)[] ? U[] : T;
39
- /** 매핑 후 평탄화 */
40
- mapMany<R>(selector: (item: T, index: number) => R[]): R[];
41
- /** 비동기 매핑 후 평탄화 (순차 실행) */
42
- mapManyAsync<R>(selector: (item: T, index: number) => Promise<R[]>): Promise<R[]>;
43
- /**
44
- * 비동기 병렬 처리 (Promise.all 사용)
45
- * @note 하나라도 reject되면 전체가 fail-fast로 reject됨 (Promise.all 동작)
46
- */
47
- parallelAsync<R>(fn: (item: T, index: number) => Promise<R>): Promise<R[]>;
48
- /**
49
- * 키 기준 그룹화
50
- * @param keySelector 그룹 키 선택 함수
51
- * @note O(n²) 복잡도 (객체 키 지원을 위해 깊은 비교 사용). primitive 키만 필요하면 toArrayMap()이 O(n)으로 더 효율적
52
- */
53
- groupBy<K>(keySelector: (item: T, index: number) => K): {
54
- key: K;
55
- values: T[];
56
- }[];
57
- /**
58
- * 키 기준 그룹화 (값 변환 포함)
59
- * @param keySelector 그룹 키 선택 함수
60
- * @param valueSelector 값 변환 함수
61
- * @note O(n²) 복잡도 (객체 키 지원을 위해 깊은 비교 사용). primitive 키만 필요하면 toArrayMap()이 O(n)으로 더 효율적
62
- */
63
- groupBy<K, V>(keySelector: (item: T, index: number) => K, valueSelector: (item: T, index: number) => V): {
64
- key: K;
65
- values: V[];
66
- }[];
67
- toMap<K>(keySelector: (item: T, index: number) => K): Map<K, T>;
68
- toMap<K, V>(keySelector: (item: T, index: number) => K, valueSelector: (item: T, index: number) => V): Map<K, V>;
69
- toMapAsync<K>(keySelector: (item: T, index: number) => Promise<K>): Promise<Map<K, T>>;
70
- toMapAsync<K, V>(keySelector: (item: T, index: number) => Promise<K> | K, valueSelector: (item: T, index: number) => Promise<V> | V): Promise<Map<K, V>>;
71
- toArrayMap<K>(keySelector: (item: T, index: number) => K): Map<K, T[]>;
72
- toArrayMap<K, V>(keySelector: (item: T, index: number) => K, valueSelector: (item: T, index: number) => V): Map<K, V[]>;
73
- toSetMap<K>(keySelector: (item: T, index: number) => K): Map<K, Set<T>>;
74
- toSetMap<K, V>(keySelector: (item: T, index: number) => K, valueSelector: (item: T, index: number) => V): Map<K, Set<V>>;
75
- toMapValues<K, V>(keySelector: (item: T, index: number) => K, valueSelector: (items: T[]) => V): Map<K, V>;
76
- toObject(keySelector: (item: T, index: number) => string): Record<string, T>;
77
- toObject<V>(keySelector: (item: T, index: number) => string, valueSelector: (item: T, index: number) => V): Record<string, V>;
78
- /**
79
- * 평탄한 배열을 트리 구조로 변환한다
80
- *
81
- * @param keyProp 각 항목의 고유 키 속성명
82
- * @param parentKey 부모 항목의 키를 참조하는 속성명
83
- * @returns 루트 항목들의 배열 (각 항목에 children 속성 추가)
84
- *
85
- * @remarks
86
- * - parentKey 값이 null/undefined인 항목이 루트가 된다
87
- * - 내부적으로 toArrayMap을 사용하여 O(n) 복잡도로 처리한다
88
- * - 원본 항목은 복사되어 children 속성이 추가된다
89
- *
90
- * @example
91
- * ```typescript
92
- * interface Item {
93
- * id: number;
94
- * parentId?: number;
95
- * name: string;
96
- * }
97
- *
98
- * const items: Item[] = [
99
- * { id: 1, name: "root" },
100
- * { id: 2, parentId: 1, name: "child1" },
101
- * { id: 3, parentId: 1, name: "child2" },
102
- * { id: 4, parentId: 2, name: "grandchild" },
103
- * ];
104
- *
105
- * const tree = items.toTree("id", "parentId");
106
- * // [{ id: 1, name: "root", children: [
107
- * // { id: 2, name: "child1", children: [
108
- * // { id: 4, name: "grandchild", children: [] }
109
- * // ]},
110
- * // { id: 3, name: "child2", children: [] }
111
- * // ]}]
112
- * ```
113
- */
114
- toTree<K extends keyof T, P extends keyof T>(keyProp: K, parentKey: P): TreeArray<T>[];
115
- /**
116
- * 중복 제거
117
- * @param options matchAddress: 주소 비교 (true면 Set 사용), keyFn: 커스텀 키 함수 (O(n) 성능)
118
- * @note 객체 배열에서 keyFn 없이 사용 시 O(n²) 복잡도. 대량 데이터는 keyFn 사용 권장
119
- */
120
- distinct(options?: boolean | {
121
- matchAddress?: boolean;
122
- keyFn?: (item: T) => string | number;
123
- }): T[];
124
- orderBy(selector?: (item: T) => string | number | DateOnly | DateTime | Time | undefined): T[];
125
- orderByDesc(selector?: (item: T) => string | number | DateOnly | DateTime | Time | undefined): T[];
126
- /**
127
- * 두 배열 비교 (INSERT/DELETE/UPDATE)
128
- * @param target 비교 대상 배열
129
- * @param options keys: 키 비교용, excludes: 비교 제외 속성
130
- * @note target에 중복 키가 있으면 첫 번째 매칭만 사용됨
131
- */
132
- diffs<P>(target: P[], options?: {
133
- keys?: string[];
134
- excludes?: string[];
135
- }): ArrayDiffsResult<T, P>[];
136
- oneWayDiffs<K extends keyof T>(orgItems: T[] | Map<T[K], T>, keyPropNameOrFn: K | ((item: T) => K), options?: {
137
- includeSame?: boolean;
138
- excludes?: string[];
139
- includes?: string[];
140
- }): ArrayDiffs2Result<T>[];
141
- merge<P>(target: P[], options?: {
142
- keys?: string[];
143
- excludes?: string[];
144
- }): (T | P | (T & P))[];
145
- /**
146
- * 요소의 합계 반환
147
- * @param selector 값 선택 함수 (생략 시 요소 자체를 number로 사용)
148
- * @returns 빈 배열인 경우 0 반환
149
- */
150
- sum(selector?: (item: T, index: number) => number): number;
151
- min(): T extends number | string ? T | undefined : never;
152
- min<P extends number | string>(selector?: (item: T, index: number) => P): P | undefined;
153
- max(): T extends number | string ? T | undefined : never;
154
- max<P extends number | string>(selector?: (item: T, index: number) => P): P | undefined;
155
- shuffle(): T[];
156
- }
157
- /**
158
- * 원본 배열을 변경하는 확장 메서드
159
- * @mutates 모든 메서드가 원본 배열을 직접 변경합니다
160
- */
161
- export interface MutableArrayExt<T> {
162
- /**
163
- * 원본 배열에서 중복 제거
164
- * @param options matchAddress: 주소 비교 (true면 Set 사용), keyFn: 커스텀 키 함수 (O(n) 성능)
165
- * @note 객체 배열에서 keyFn 없이 사용 시 O(n²) 복잡도. 대량 데이터는 keyFn 사용 권장
166
- * @mutates
167
- */
168
- distinctThis(options?: boolean | {
169
- matchAddress?: boolean;
170
- keyFn?: (item: T) => string | number;
171
- }): T[];
172
- /** 원본 배열 오름차순 정렬 @mutates */
173
- orderByThis(selector?: (item: T) => string | number | DateOnly | DateTime | Time | undefined): T[];
174
- /** 원본 배열 내림차순 정렬 @mutates */
175
- orderByDescThis(selector?: (item: T) => string | number | DateOnly | DateTime | Time | undefined): T[];
176
- /** 원본 배열에 항목 삽입 @mutates */
177
- insert(index: number, ...items: T[]): this;
178
- /** 원본 배열에서 항목 제거 @mutates */
179
- remove(item: T): this;
180
- /** 원본 배열에서 조건에 맞는 항목 제거 @mutates */
181
- remove(selector: (item: T, index: number) => boolean): this;
182
- /** 원본 배열에서 항목 토글 (있으면 제거, 없으면 추가) @mutates */
183
- toggle(item: T): this;
184
- /** 원본 배열 비우기 @mutates */
185
- clear(): this;
186
- }
187
- export type ArrayDiffsResult<T, P> = {
188
- source: undefined;
189
- target: P;
190
- } | {
191
- source: T;
192
- target: undefined;
193
- } | {
194
- source: T;
195
- target: P;
196
- };
197
- export type ArrayDiffs2Result<T> = {
198
- type: "create";
199
- item: T;
200
- orgItem: undefined;
201
- } | {
202
- type: "update";
203
- item: T;
204
- orgItem: T;
205
- } | {
206
- type: "same";
207
- item: T;
208
- orgItem: T;
209
- };
210
- export type TreeArray<T> = T & {
211
- children: TreeArray<T>[];
212
- };
213
- /** 정렬/비교 가능한 타입 */
214
- export type ComparableType = string | number | boolean | DateTime | DateOnly | Time | undefined;
215
- //# sourceMappingURL=arr-ext.types.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"arr-ext.types.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/extensions/arr-ext.types.ts"],"names":[],"mappings":"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"}
@@ -1,57 +0,0 @@
1
- /**
2
- * Map 확장 메서드
3
- */
4
- declare global {
5
- interface Map<K, V> {
6
- /**
7
- * 키에 해당하는 값이 없으면 새 값을 설정하고 반환
8
- *
9
- * @remarks
10
- * **주의**: V 타입이 함수인 경우(예: `Map<string, () => void>`),
11
- * 두 번째 인자로 함수를 직접 전달하면 팩토리로 인식되어 호출됩니다.
12
- * 함수 자체를 값으로 저장하려면 팩토리로 감싸세요.
13
- *
14
- * @example
15
- * ```typescript
16
- * // 일반 값
17
- * map.getOrCreate("key", 0);
18
- * map.getOrCreate("key", []);
19
- *
20
- * // 팩토리 함수 (계산 비용이 큰 경우)
21
- * map.getOrCreate("key", () => expensiveComputation());
22
- *
23
- * // 함수를 값으로 저장하는 경우
24
- * const fnMap = new Map<string, () => void>();
25
- * const myFn = () => console.log("hello");
26
- * fnMap.getOrCreate("key", () => myFn); // 팩토리로 감싸기
27
- * ```
28
- */
29
- getOrCreate(key: K, newValue: V): V;
30
- getOrCreate(key: K, newValueFn: () => V): V;
31
- /**
32
- * 키에 해당하는 값을 함수로 업데이트한다
33
- *
34
- * @param key 업데이트할 키
35
- * @param updateFn 현재 값을 받아 새 값을 반환하는 함수 (키가 없으면 undefined 전달)
36
- *
37
- * @remarks
38
- * 키가 존재하지 않아도 updateFn이 호출되어 새 값이 설정된다.
39
- * 기존 값 기반 계산이 필요한 경우 (카운터 증가, 배열에 추가 등) 유용하다.
40
- *
41
- * @example
42
- * ```typescript
43
- * const countMap = new Map<string, number>();
44
- *
45
- * // 카운터 증가
46
- * countMap.update("key", (v) => (v ?? 0) + 1);
47
- *
48
- * // 배열에 항목 추가
49
- * const arrayMap = new Map<string, string[]>();
50
- * arrayMap.update("key", (v) => [...(v ?? []), "item"]);
51
- * ```
52
- */
53
- update(key: K, updateFn: (v: V | undefined) => V): void;
54
- }
55
- }
56
- export {};
57
- //# sourceMappingURL=map-ext.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"map-ext.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/extensions/map-ext.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;QAChB;;;;;;;;;;;;;;;;;;;;;;WAsBG;QACH,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;QACpC,WAAW,CAAC,GAAG,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QAE5C;;;;;;;;;;;;;;;;;;;;;WAqBG;QACH,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,KAAK,CAAC,GAAG,IAAI,CAAC;KACzD;CACF;AA6BD,OAAO,EAAE,CAAC"}
@@ -1,36 +0,0 @@
1
- /**
2
- * Set 확장 메서드
3
- */
4
- declare global {
5
- interface Set<T> {
6
- /**
7
- * 여러 값을 한 번에 추가
8
- */
9
- adds(...values: T[]): this;
10
- /**
11
- * 값을 토글한다 (있으면 제거, 없으면 추가)
12
- *
13
- * @param value 토글할 값
14
- * @param addOrDel 강제로 추가("add") 또는 제거("del") 지정 (생략 시 자동 토글)
15
- * @returns this (메서드 체이닝 가능)
16
- *
17
- * @remarks
18
- * addOrDel 파라미터로 조건부 추가/제거를 간결하게 표현할 수 있다.
19
- *
20
- * @example
21
- * ```typescript
22
- * const set = new Set<number>([1, 2, 3]);
23
- *
24
- * set.toggle(2); // 2가 있으므로 제거 → {1, 3}
25
- * set.toggle(4); // 4가 없으므로 추가 → {1, 3, 4}
26
- *
27
- * // 조건부 토글
28
- * const isAdmin = true;
29
- * set.toggle(5, isAdmin ? "add" : "del"); // 강제 추가
30
- * ```
31
- */
32
- toggle(value: T, addOrDel?: "add" | "del"): this;
33
- }
34
- }
35
- export {};
36
- //# sourceMappingURL=set-ext.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"set-ext.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/extensions/set-ext.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,GAAG,CAAC,CAAC;QACb;;WAEG;QACH,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC;QAE3B;;;;;;;;;;;;;;;;;;;;;WAqBG;QACH,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;KAClD;CACF;AAgCD,OAAO,EAAE,CAAC"}
@@ -1,53 +0,0 @@
1
- /**
2
- * 비동기 함수 디바운스 큐
3
- *
4
- * 짧은 시간 내에 여러 번 호출되면 마지막 요청만 실행하고 이전 요청은 무시합니다.
5
- * 입력 필드 자동완성, 연속적인 상태 변경 배치 처리 등에 유용합니다.
6
- *
7
- * @remarks
8
- * 실행 중에 추가된 요청은 디바운스 지연 없이 현재 실행이 완료된 직후 처리됩니다.
9
- * 이는 실행 완료 전에 들어온 요청이 누락되지 않도록 하기 위한 의도적 설계입니다.
10
- *
11
- * @example
12
- * const queue = new DebounceQueue(300); // 300ms 딜레이
13
- * queue.run(() => console.log("1")); // 무시됨
14
- * queue.run(() => console.log("2")); // 무시됨
15
- * queue.run(() => console.log("3")); // 300ms 후 실행됨
16
- *
17
- * @example
18
- * // 에러 처리
19
- * queue.on("error", (err) => console.error(err));
20
- */
21
- import { SdError } from "../errors/sd-error";
22
- import { EventEmitter } from "./event-emitter";
23
- interface DebounceQueueEvents {
24
- error: SdError;
25
- }
26
- export declare class DebounceQueue extends EventEmitter<DebounceQueueEvents> {
27
- private readonly _delay?;
28
- private static readonly _logger;
29
- private _pendingFn;
30
- private _isRunning;
31
- private _isDisposed;
32
- private _timer;
33
- /**
34
- * @param _delay 디바운스 지연 시간 (밀리초). 생략 시 즉시 실행 (다음 이벤트 루프)
35
- */
36
- constructor(_delay?: number | undefined);
37
- /**
38
- * 대기 중인 작업과 타이머 정리
39
- */
40
- dispose(): void;
41
- /**
42
- * using 문 지원
43
- */
44
- [Symbol.dispose](): void;
45
- /**
46
- * 함수를 큐에 추가
47
- * 이전에 추가된 함수가 있으면 대체됨
48
- */
49
- run(fn: () => void | Promise<void>): void;
50
- private _processLast;
51
- }
52
- export {};
53
- //# sourceMappingURL=debounce-queue.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"debounce-queue.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/features/debounce-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,UAAU,mBAAmB;IAC3B,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,qBAAa,aAAc,SAAQ,YAAY,CAAC,mBAAmB,CAAC;IAWtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAVpC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAA4C;IAE3E,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAA4C;IAE1D;;OAEG;gBAC0B,MAAM,CAAC,EAAE,MAAM,YAAA;IAI5C;;OAEG;IACM,OAAO,IAAI,IAAI;IAUxB;;OAEG;IACM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;IAIjC;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;YAiB3B,YAAY;CA+B3B"}
@@ -1,66 +0,0 @@
1
- /**
2
- * EventTarget 래퍼 - EventEmitter와 유사한 API 제공
3
- *
4
- * 브라우저와 Node.js 모두에서 사용 가능한 타입 안전한 이벤트 에미터이다.
5
- * 내부적으로 EventTarget을 사용하여 구현되어 있다.
6
- *
7
- * @typeParam T 이벤트 타입 맵. 키는 이벤트 이름, 값은 이벤트 데이터 타입
8
- *
9
- * @example
10
- * interface MyEvents {
11
- * data: string;
12
- * error: Error;
13
- * done: void;
14
- * }
15
- *
16
- * class MyEmitter extends EventEmitter<MyEvents> {}
17
- *
18
- * const emitter = new MyEmitter();
19
- * emitter.on("data", (data) => console.log(data)); // data: string
20
- * emitter.emit("data", "hello");
21
- * emitter.emit("done"); // void 타입은 인자 없이 호출
22
- */
23
- export declare class EventEmitter<T extends {
24
- [K in keyof T]: unknown;
25
- } = Record<string, unknown>> {
26
- private readonly _target;
27
- private readonly _listenerMap;
28
- /**
29
- * 이벤트 리스너 등록
30
- *
31
- * @param type 이벤트 타입
32
- * @param listener 이벤트 핸들러
33
- * @note 같은 리스너를 같은 이벤트에 중복 등록하면 무시됨
34
- */
35
- on<K extends keyof T & string>(type: K, listener: (data: T[K]) => void): void;
36
- /**
37
- * 이벤트 리스너 제거
38
- *
39
- * @param type 이벤트 타입
40
- * @param listener 제거할 이벤트 핸들러
41
- */
42
- off<K extends keyof T & string>(type: K, listener: (data: T[K]) => void): void;
43
- /**
44
- * 이벤트 발생
45
- *
46
- * @param type 이벤트 타입
47
- * @param args 이벤트 데이터 (void 타입이면 생략)
48
- */
49
- emit<K extends keyof T & string>(type: K, ...args: T[K] extends void ? [] : [data: T[K]]): void;
50
- /**
51
- * 특정 이벤트의 리스너 수 반환
52
- *
53
- * @param type 이벤트 타입
54
- * @returns 등록된 리스너 수
55
- */
56
- listenerCount<K extends keyof T & string>(type: K): number;
57
- /**
58
- * 모든 이벤트 리스너를 제거한다.
59
- */
60
- dispose(): void;
61
- /**
62
- * using 문 지원
63
- */
64
- [Symbol.dispose](): void;
65
- }
66
- //# sourceMappingURL=event-emitter.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/features/event-emitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,YAAY,CAAC,CAAC,SAAS;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,OAAO;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAG7C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwD;IAErF;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAgB7E;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI;IAgB9E;;;;;OAKG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI/F;;;;;OAKG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM;IAI1D;;OAEG;IACH,OAAO,IAAI,IAAI;IASf;;OAEG;IACH,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGzB"}