@mandujs/core 0.12.2 → 0.13.0

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 (173) hide show
  1. package/README.ko.md +304 -304
  2. package/README.md +653 -653
  3. package/package.json +1 -1
  4. package/src/brain/architecture/analyzer.ts +28 -26
  5. package/src/brain/doctor/analyzer.ts +1 -1
  6. package/src/bundler/build.ts +91 -91
  7. package/src/bundler/css.ts +302 -302
  8. package/src/bundler/dev.ts +0 -1
  9. package/src/change/history.ts +3 -3
  10. package/src/change/snapshot.ts +10 -9
  11. package/src/change/transaction.ts +2 -2
  12. package/src/client/Link.tsx +227 -227
  13. package/src/client/globals.ts +44 -44
  14. package/src/client/hooks.ts +267 -267
  15. package/src/client/index.ts +5 -5
  16. package/src/client/island.ts +8 -8
  17. package/src/client/router.ts +435 -435
  18. package/src/client/runtime.ts +23 -23
  19. package/src/client/serialize.ts +404 -404
  20. package/src/client/window-state.ts +101 -101
  21. package/src/config/mandu.ts +94 -96
  22. package/src/config/validate.ts +213 -215
  23. package/src/config/watcher.ts +311 -311
  24. package/src/constants.ts +40 -40
  25. package/src/content/content-layer.ts +314 -314
  26. package/src/content/content.test.ts +433 -433
  27. package/src/content/data-store.ts +245 -245
  28. package/src/content/digest.ts +133 -133
  29. package/src/content/index.ts +164 -164
  30. package/src/content/loader-context.ts +172 -172
  31. package/src/content/loaders/api.ts +216 -216
  32. package/src/content/loaders/file.ts +169 -169
  33. package/src/content/loaders/glob.ts +252 -252
  34. package/src/content/loaders/index.ts +34 -34
  35. package/src/content/loaders/types.ts +137 -137
  36. package/src/content/meta-store.ts +209 -209
  37. package/src/content/types.ts +282 -282
  38. package/src/content/watcher.ts +135 -135
  39. package/src/contract/client-safe.test.ts +42 -42
  40. package/src/contract/client-safe.ts +114 -114
  41. package/src/contract/client.ts +16 -16
  42. package/src/contract/define.ts +459 -459
  43. package/src/contract/handler.ts +10 -10
  44. package/src/contract/normalize.test.ts +276 -276
  45. package/src/contract/normalize.ts +404 -404
  46. package/src/contract/registry.test.ts +206 -206
  47. package/src/contract/registry.ts +568 -568
  48. package/src/contract/schema.ts +48 -48
  49. package/src/contract/types.ts +58 -58
  50. package/src/contract/validator.ts +32 -32
  51. package/src/devtools/ai/context-builder.ts +375 -375
  52. package/src/devtools/ai/index.ts +25 -25
  53. package/src/devtools/ai/mcp-connector.ts +465 -465
  54. package/src/devtools/client/catchers/error-catcher.ts +327 -327
  55. package/src/devtools/client/catchers/index.ts +18 -18
  56. package/src/devtools/client/catchers/network-proxy.ts +363 -363
  57. package/src/devtools/client/components/index.ts +39 -39
  58. package/src/devtools/client/components/kitchen-root.tsx +362 -362
  59. package/src/devtools/client/components/mandu-character.tsx +241 -241
  60. package/src/devtools/client/components/overlay.tsx +368 -368
  61. package/src/devtools/client/components/panel/errors-panel.tsx +259 -259
  62. package/src/devtools/client/components/panel/guard-panel.tsx +244 -244
  63. package/src/devtools/client/components/panel/index.ts +32 -32
  64. package/src/devtools/client/components/panel/islands-panel.tsx +304 -304
  65. package/src/devtools/client/components/panel/network-panel.tsx +292 -292
  66. package/src/devtools/client/components/panel/panel-container.tsx +259 -259
  67. package/src/devtools/client/filters/context-filters.ts +282 -282
  68. package/src/devtools/client/filters/index.ts +16 -16
  69. package/src/devtools/client/index.ts +63 -63
  70. package/src/devtools/client/persistence.ts +335 -335
  71. package/src/devtools/client/state-manager.ts +478 -478
  72. package/src/devtools/design-tokens.ts +263 -263
  73. package/src/devtools/hook/create-hook.ts +207 -207
  74. package/src/devtools/hook/index.ts +13 -13
  75. package/src/devtools/index.ts +439 -439
  76. package/src/devtools/init.ts +266 -266
  77. package/src/devtools/protocol.ts +237 -237
  78. package/src/devtools/server/index.ts +17 -17
  79. package/src/devtools/server/source-context.ts +444 -444
  80. package/src/devtools/types.ts +319 -319
  81. package/src/devtools/worker/index.ts +25 -25
  82. package/src/devtools/worker/redaction-worker.ts +222 -222
  83. package/src/devtools/worker/worker-manager.ts +409 -409
  84. package/src/error/classifier.ts +2 -2
  85. package/src/error/domains.ts +265 -265
  86. package/src/error/formatter.ts +32 -32
  87. package/src/error/result.ts +46 -46
  88. package/src/error/stack-analyzer.ts +5 -0
  89. package/src/error/types.ts +6 -6
  90. package/src/errors/extractor.ts +409 -409
  91. package/src/errors/index.ts +19 -19
  92. package/src/filling/auth.ts +308 -308
  93. package/src/filling/context.ts +569 -569
  94. package/src/filling/deps.ts +238 -238
  95. package/src/generator/contract-glue.ts +2 -1
  96. package/src/generator/generate.ts +12 -10
  97. package/src/generator/index.ts +3 -3
  98. package/src/generator/templates.ts +80 -79
  99. package/src/guard/analyzer.ts +360 -360
  100. package/src/guard/ast-analyzer.ts +806 -806
  101. package/src/guard/auto-correct.ts +1 -1
  102. package/src/guard/check.ts +128 -128
  103. package/src/guard/contract-guard.ts +9 -9
  104. package/src/guard/file-type.test.ts +24 -24
  105. package/src/guard/presets/atomic.ts +70 -70
  106. package/src/guard/presets/clean.ts +77 -77
  107. package/src/guard/presets/cqrs.test.ts +35 -14
  108. package/src/guard/presets/fsd.ts +79 -79
  109. package/src/guard/presets/hexagonal.ts +68 -68
  110. package/src/guard/presets/index.ts +291 -291
  111. package/src/guard/reporter.ts +445 -445
  112. package/src/guard/rules.ts +12 -12
  113. package/src/guard/statistics.ts +578 -578
  114. package/src/guard/suggestions.ts +358 -358
  115. package/src/guard/types.ts +348 -348
  116. package/src/guard/validator.ts +834 -834
  117. package/src/guard/watcher.ts +404 -404
  118. package/src/index.ts +1 -0
  119. package/src/intent/index.ts +310 -310
  120. package/src/island/index.ts +304 -304
  121. package/src/logging/index.ts +22 -22
  122. package/src/logging/transports.ts +365 -365
  123. package/src/paths.test.ts +47 -0
  124. package/src/paths.ts +47 -0
  125. package/src/plugins/index.ts +38 -38
  126. package/src/plugins/registry.ts +377 -377
  127. package/src/plugins/types.ts +363 -363
  128. package/src/report/build.ts +1 -1
  129. package/src/report/index.ts +1 -1
  130. package/src/router/fs-patterns.ts +387 -387
  131. package/src/router/fs-routes.ts +344 -401
  132. package/src/router/fs-scanner.ts +497 -497
  133. package/src/router/fs-types.ts +270 -278
  134. package/src/router/index.ts +81 -81
  135. package/src/runtime/boundary.tsx +232 -232
  136. package/src/runtime/compose.ts +222 -222
  137. package/src/runtime/lifecycle.ts +381 -381
  138. package/src/runtime/logger.test.ts +345 -345
  139. package/src/runtime/logger.ts +677 -677
  140. package/src/runtime/router.test.ts +476 -476
  141. package/src/runtime/router.ts +105 -105
  142. package/src/runtime/security.ts +155 -155
  143. package/src/runtime/server.ts +24 -24
  144. package/src/runtime/session-key.ts +328 -328
  145. package/src/runtime/ssr.ts +367 -367
  146. package/src/runtime/streaming-ssr.ts +1245 -1245
  147. package/src/runtime/trace.ts +144 -144
  148. package/src/seo/index.ts +214 -214
  149. package/src/seo/integration/ssr.ts +307 -307
  150. package/src/seo/render/basic.ts +427 -427
  151. package/src/seo/render/index.ts +143 -143
  152. package/src/seo/render/jsonld.ts +539 -539
  153. package/src/seo/render/opengraph.ts +191 -191
  154. package/src/seo/render/robots.ts +116 -116
  155. package/src/seo/render/sitemap.ts +137 -137
  156. package/src/seo/render/twitter.ts +126 -126
  157. package/src/seo/resolve/index.ts +353 -353
  158. package/src/seo/resolve/opengraph.ts +143 -143
  159. package/src/seo/resolve/robots.ts +73 -73
  160. package/src/seo/resolve/title.ts +94 -94
  161. package/src/seo/resolve/twitter.ts +73 -73
  162. package/src/seo/resolve/url.ts +97 -97
  163. package/src/seo/routes/index.ts +290 -290
  164. package/src/seo/types.ts +575 -575
  165. package/src/slot/validator.ts +39 -39
  166. package/src/spec/index.ts +3 -3
  167. package/src/spec/load.ts +76 -76
  168. package/src/spec/lock.ts +56 -56
  169. package/src/utils/bun.ts +8 -8
  170. package/src/utils/lru-cache.ts +75 -75
  171. package/src/utils/safe-io.ts +188 -188
  172. package/src/utils/string-safe.ts +298 -298
  173. package/src/watcher/rules.ts +5 -5
@@ -25,19 +25,19 @@ export interface SlotValidationResult {
25
25
  }
26
26
 
27
27
  // 금지된 import 모듈들
28
- const FORBIDDEN_IMPORTS = [
29
- "fs",
30
- "child_process",
31
- "cluster",
32
- "worker_threads",
33
- "node:fs",
34
- "node:child_process",
35
- "node:cluster",
36
- "node:worker_threads",
37
- ];
38
-
39
- // Slot에서 직접 import를 피해야 하는 모듈
40
- const DISCOURAGED_SLOT_IMPORTS = ["zod"];
28
+ const FORBIDDEN_IMPORTS = [
29
+ "fs",
30
+ "child_process",
31
+ "cluster",
32
+ "worker_threads",
33
+ "node:fs",
34
+ "node:child_process",
35
+ "node:cluster",
36
+ "node:worker_threads",
37
+ ];
38
+
39
+ // Slot에서 직접 import를 피해야 하는 모듈
40
+ const DISCOURAGED_SLOT_IMPORTS = ["zod"];
41
41
 
42
42
  // 필수 패턴들 (더 엄격한 검사)
43
43
  const REQUIRED_PATTERNS = {
@@ -147,9 +147,9 @@ export function validateSlotContent(content: string): SlotValidationResult {
147
147
  const codeWithoutComments = stripComments(content);
148
148
 
149
149
  // 1. 금지된 import 검사
150
- for (let i = 0; i < lines.length; i++) {
151
- const line = lines[i];
152
- for (const forbidden of FORBIDDEN_IMPORTS) {
150
+ for (let i = 0; i < lines.length; i++) {
151
+ const line = lines[i];
152
+ for (const forbidden of FORBIDDEN_IMPORTS) {
153
153
  // import 문에서 금지된 모듈 체크
154
154
  const importPattern = new RegExp(
155
155
  `import\\s+.*from\\s+['"]${forbidden.replace("/", "\\/")}['"]`
@@ -167,29 +167,29 @@ export function validateSlotContent(content: string): SlotValidationResult {
167
167
  suggestion: `'${forbidden}' 대신 Bun의 안전한 API 또는 adapter를 사용하세요`,
168
168
  autoFixable: true,
169
169
  });
170
- }
171
- }
172
-
173
- for (const discouraged of DISCOURAGED_SLOT_IMPORTS) {
174
- const importPattern = new RegExp(
175
- `import\\s+.*from\\s+['"]${discouraged}['"]`
176
- );
177
- const requirePattern = new RegExp(
178
- `require\\s*\\(\\s*['"]${discouraged}['"]\\s*\\)`
179
- );
180
-
181
- if (importPattern.test(line) || requirePattern.test(line)) {
182
- issues.push({
183
- code: "ZOD_DIRECT_IMPORT",
184
- severity: "error",
185
- message: `Slot에서 '${discouraged}' 직접 import 금지`,
186
- line: i + 1,
187
- suggestion: "계약은 spec/contracts/*.contract.ts에 정의하고 ctx.input()으로 검증하세요",
188
- autoFixable: false,
189
- });
190
- }
191
- }
192
- }
170
+ }
171
+ }
172
+
173
+ for (const discouraged of DISCOURAGED_SLOT_IMPORTS) {
174
+ const importPattern = new RegExp(
175
+ `import\\s+.*from\\s+['"]${discouraged}['"]`
176
+ );
177
+ const requirePattern = new RegExp(
178
+ `require\\s*\\(\\s*['"]${discouraged}['"]\\s*\\)`
179
+ );
180
+
181
+ if (importPattern.test(line) || requirePattern.test(line)) {
182
+ issues.push({
183
+ code: "ZOD_DIRECT_IMPORT",
184
+ severity: "error",
185
+ message: `Slot에서 '${discouraged}' 직접 import 금지`,
186
+ line: i + 1,
187
+ suggestion: "계약은 spec/contracts/*.contract.ts에 정의하고 ctx.input()으로 검증하세요",
188
+ autoFixable: false,
189
+ });
190
+ }
191
+ }
192
+ }
193
193
 
194
194
  // 2. Mandu import 검사
195
195
  if (!REQUIRED_PATTERNS.manduImport.test(content)) {
package/src/spec/index.ts CHANGED
@@ -1,3 +1,3 @@
1
- export * from "./schema";
2
- export * from "./load";
3
- export * from "./lock";
1
+ export * from "./schema";
2
+ export * from "./load";
3
+ export * from "./lock";
package/src/spec/load.ts CHANGED
@@ -1,76 +1,76 @@
1
- import { RoutesManifest, type RoutesManifest as RoutesManifestType } from "./schema";
2
- import { ZodError } from "zod";
3
-
4
- export interface LoadResult {
5
- success: boolean;
6
- data?: RoutesManifestType;
7
- errors?: string[];
8
- }
9
-
10
- export function formatZodError(error: ZodError): string[] {
11
- return error.errors.map((e) => {
12
- const path = e.path.length > 0 ? `[${e.path.join(".")}] ` : "";
13
- return `${path}${e.message}`;
14
- });
15
- }
16
-
17
- export async function loadManifest(filePath: string): Promise<LoadResult> {
18
- try {
19
- const file = Bun.file(filePath);
20
- const exists = await file.exists();
21
-
22
- if (!exists) {
23
- return {
24
- success: false,
25
- errors: [`파일을 찾을 수 없습니다: ${filePath}`],
26
- };
27
- }
28
-
29
- const content = await file.text();
30
- let json: unknown;
31
-
32
- try {
33
- json = JSON.parse(content);
34
- } catch {
35
- return {
36
- success: false,
37
- errors: ["JSON 파싱 실패: 올바른 JSON 형식이 아닙니다"],
38
- };
39
- }
40
-
41
- const result = RoutesManifest.safeParse(json);
42
-
43
- if (!result.success) {
44
- return {
45
- success: false,
46
- errors: formatZodError(result.error),
47
- };
48
- }
49
-
50
- return {
51
- success: true,
52
- data: result.data,
53
- };
54
- } catch (error) {
55
- return {
56
- success: false,
57
- errors: [`예상치 못한 오류: ${error instanceof Error ? error.message : String(error)}`],
58
- };
59
- }
60
- }
61
-
62
- export function validateManifest(data: unknown): LoadResult {
63
- const result = RoutesManifest.safeParse(data);
64
-
65
- if (!result.success) {
66
- return {
67
- success: false,
68
- errors: formatZodError(result.error),
69
- };
70
- }
71
-
72
- return {
73
- success: true,
74
- data: result.data,
75
- };
76
- }
1
+ import { RoutesManifest, type RoutesManifest as RoutesManifestType } from "./schema";
2
+ import { ZodError } from "zod";
3
+
4
+ export interface LoadResult {
5
+ success: boolean;
6
+ data?: RoutesManifestType;
7
+ errors?: string[];
8
+ }
9
+
10
+ export function formatZodError(error: ZodError): string[] {
11
+ return error.errors.map((e) => {
12
+ const path = e.path.length > 0 ? `[${e.path.join(".")}] ` : "";
13
+ return `${path}${e.message}`;
14
+ });
15
+ }
16
+
17
+ export async function loadManifest(filePath: string): Promise<LoadResult> {
18
+ try {
19
+ const file = Bun.file(filePath);
20
+ const exists = await file.exists();
21
+
22
+ if (!exists) {
23
+ return {
24
+ success: false,
25
+ errors: [`파일을 찾을 수 없습니다: ${filePath}`],
26
+ };
27
+ }
28
+
29
+ const content = await file.text();
30
+ let json: unknown;
31
+
32
+ try {
33
+ json = JSON.parse(content);
34
+ } catch {
35
+ return {
36
+ success: false,
37
+ errors: ["JSON 파싱 실패: 올바른 JSON 형식이 아닙니다"],
38
+ };
39
+ }
40
+
41
+ const result = RoutesManifest.safeParse(json);
42
+
43
+ if (!result.success) {
44
+ return {
45
+ success: false,
46
+ errors: formatZodError(result.error),
47
+ };
48
+ }
49
+
50
+ return {
51
+ success: true,
52
+ data: result.data,
53
+ };
54
+ } catch (error) {
55
+ return {
56
+ success: false,
57
+ errors: [`예상치 못한 오류: ${error instanceof Error ? error.message : String(error)}`],
58
+ };
59
+ }
60
+ }
61
+
62
+ export function validateManifest(data: unknown): LoadResult {
63
+ const result = RoutesManifest.safeParse(data);
64
+
65
+ if (!result.success) {
66
+ return {
67
+ success: false,
68
+ errors: formatZodError(result.error),
69
+ };
70
+ }
71
+
72
+ return {
73
+ success: true,
74
+ data: result.data,
75
+ };
76
+ }
package/src/spec/lock.ts CHANGED
@@ -1,56 +1,56 @@
1
- import { createHash } from "crypto";
2
- import type { RoutesManifest } from "./schema";
3
-
4
- export interface SpecLock {
5
- routesHash: string;
6
- updatedAt: string;
7
- }
8
-
9
- export function computeHash(manifest: RoutesManifest): string {
10
- const content = JSON.stringify(manifest, null, 2);
11
- return createHash("sha256").update(content).digest("hex");
12
- }
13
-
14
- export async function readLock(lockPath: string): Promise<SpecLock | null> {
15
- try {
16
- const file = Bun.file(lockPath);
17
- const exists = await file.exists();
18
-
19
- if (!exists) {
20
- return null;
21
- }
22
-
23
- const content = await file.text();
24
- return JSON.parse(content) as SpecLock;
25
- } catch {
26
- return null;
27
- }
28
- }
29
-
30
- export async function writeLock(lockPath: string, manifest: RoutesManifest): Promise<SpecLock> {
31
- const lock: SpecLock = {
32
- routesHash: computeHash(manifest),
33
- updatedAt: new Date().toISOString(),
34
- };
35
-
36
- await Bun.write(lockPath, JSON.stringify(lock, null, 2));
37
- return lock;
38
- }
39
-
40
- export async function verifyLock(
41
- lockPath: string,
42
- manifest: RoutesManifest
43
- ): Promise<{ valid: boolean; currentHash: string; lockHash: string | null }> {
44
- const currentHash = computeHash(manifest);
45
- const lock = await readLock(lockPath);
46
-
47
- if (!lock) {
48
- return { valid: false, currentHash, lockHash: null };
49
- }
50
-
51
- return {
52
- valid: lock.routesHash === currentHash,
53
- currentHash,
54
- lockHash: lock.routesHash,
55
- };
56
- }
1
+ import { createHash } from "crypto";
2
+ import type { RoutesManifest } from "./schema";
3
+
4
+ export interface SpecLock {
5
+ routesHash: string;
6
+ updatedAt: string;
7
+ }
8
+
9
+ export function computeHash(manifest: RoutesManifest): string {
10
+ const content = JSON.stringify(manifest, null, 2);
11
+ return createHash("sha256").update(content).digest("hex");
12
+ }
13
+
14
+ export async function readLock(lockPath: string): Promise<SpecLock | null> {
15
+ try {
16
+ const file = Bun.file(lockPath);
17
+ const exists = await file.exists();
18
+
19
+ if (!exists) {
20
+ return null;
21
+ }
22
+
23
+ const content = await file.text();
24
+ return JSON.parse(content) as SpecLock;
25
+ } catch {
26
+ return null;
27
+ }
28
+ }
29
+
30
+ export async function writeLock(lockPath: string, manifest: RoutesManifest): Promise<SpecLock> {
31
+ const lock: SpecLock = {
32
+ routesHash: computeHash(manifest),
33
+ updatedAt: new Date().toISOString(),
34
+ };
35
+
36
+ await Bun.write(lockPath, JSON.stringify(lock, null, 2));
37
+ return lock;
38
+ }
39
+
40
+ export async function verifyLock(
41
+ lockPath: string,
42
+ manifest: RoutesManifest
43
+ ): Promise<{ valid: boolean; currentHash: string; lockHash: string | null }> {
44
+ const currentHash = computeHash(manifest);
45
+ const lock = await readLock(lockPath);
46
+
47
+ if (!lock) {
48
+ return { valid: false, currentHash, lockHash: null };
49
+ }
50
+
51
+ return {
52
+ valid: lock.routesHash === currentHash,
53
+ currentHash,
54
+ lockHash: lock.routesHash,
55
+ };
56
+ }
package/src/utils/bun.ts CHANGED
@@ -1,8 +1,8 @@
1
- export async function readJsonFile(filePath: string): Promise<unknown> {
2
- try {
3
- return await Bun.file(filePath).json();
4
- } catch (error) {
5
- const message = error instanceof Error ? error.message : String(error);
6
- throw new Error(`Failed to parse JSON in ${filePath}: ${message}`);
7
- }
8
- }
1
+ export async function readJsonFile(filePath: string): Promise<unknown> {
2
+ try {
3
+ return await Bun.file(filePath).json();
4
+ } catch (error) {
5
+ const message = error instanceof Error ? error.message : String(error);
6
+ throw new Error(`Failed to parse JSON in ${filePath}: ${message}`);
7
+ }
8
+ }
@@ -1,75 +1,75 @@
1
- /**
2
- * 간단한 LRU (Least Recently Used) 캐시 구현
3
- */
4
- export class LRUCache<K, V> {
5
- private cache: Map<K, V>;
6
- private readonly maxSize: number;
7
- private _hits = 0;
8
- private _misses = 0;
9
-
10
- constructor(maxSize: number = 100) {
11
- this.cache = new Map();
12
- this.maxSize = maxSize;
13
- }
14
-
15
- get(key: K): V | undefined {
16
- const value = this.cache.get(key);
17
- if (value !== undefined) {
18
- this.cache.delete(key);
19
- this.cache.set(key, value);
20
- }
21
- return value;
22
- }
23
-
24
- getWithStats(key: K): V | undefined {
25
- const value = this.get(key);
26
- if (value !== undefined) {
27
- this._hits++;
28
- } else {
29
- this._misses++;
30
- }
31
- return value;
32
- }
33
-
34
- set(key: K, value: V): void {
35
- if (this.cache.has(key)) {
36
- this.cache.delete(key);
37
- } else if (this.cache.size >= this.maxSize) {
38
- const firstKey = this.cache.keys().next().value;
39
- if (firstKey !== undefined) {
40
- this.cache.delete(firstKey);
41
- }
42
- }
43
- this.cache.set(key, value);
44
- }
45
-
46
- has(key: K): boolean {
47
- return this.cache.has(key);
48
- }
49
-
50
- delete(key: K): boolean {
51
- return this.cache.delete(key);
52
- }
53
-
54
- clear(): void {
55
- this.cache.clear();
56
- }
57
-
58
- get size(): number {
59
- return this.cache.size;
60
- }
61
-
62
- getStats(): { hits: number; misses: number; hitRate: number } {
63
- const total = this._hits + this._misses;
64
- return {
65
- hits: this._hits,
66
- misses: this._misses,
67
- hitRate: total > 0 ? this._hits / total : 0,
68
- };
69
- }
70
-
71
- resetStats(): void {
72
- this._hits = 0;
73
- this._misses = 0;
74
- }
75
- }
1
+ /**
2
+ * 간단한 LRU (Least Recently Used) 캐시 구현
3
+ */
4
+ export class LRUCache<K, V> {
5
+ private cache: Map<K, V>;
6
+ private readonly maxSize: number;
7
+ private _hits = 0;
8
+ private _misses = 0;
9
+
10
+ constructor(maxSize: number = 100) {
11
+ this.cache = new Map();
12
+ this.maxSize = maxSize;
13
+ }
14
+
15
+ get(key: K): V | undefined {
16
+ const value = this.cache.get(key);
17
+ if (value !== undefined) {
18
+ this.cache.delete(key);
19
+ this.cache.set(key, value);
20
+ }
21
+ return value;
22
+ }
23
+
24
+ getWithStats(key: K): V | undefined {
25
+ const value = this.get(key);
26
+ if (value !== undefined) {
27
+ this._hits++;
28
+ } else {
29
+ this._misses++;
30
+ }
31
+ return value;
32
+ }
33
+
34
+ set(key: K, value: V): void {
35
+ if (this.cache.has(key)) {
36
+ this.cache.delete(key);
37
+ } else if (this.cache.size >= this.maxSize) {
38
+ const firstKey = this.cache.keys().next().value;
39
+ if (firstKey !== undefined) {
40
+ this.cache.delete(firstKey);
41
+ }
42
+ }
43
+ this.cache.set(key, value);
44
+ }
45
+
46
+ has(key: K): boolean {
47
+ return this.cache.has(key);
48
+ }
49
+
50
+ delete(key: K): boolean {
51
+ return this.cache.delete(key);
52
+ }
53
+
54
+ clear(): void {
55
+ this.cache.clear();
56
+ }
57
+
58
+ get size(): number {
59
+ return this.cache.size;
60
+ }
61
+
62
+ getStats(): { hits: number; misses: number; hitRate: number } {
63
+ const total = this._hits + this._misses;
64
+ return {
65
+ hits: this._hits,
66
+ misses: this._misses,
67
+ hitRate: total > 0 ? this._hits / total : 0,
68
+ };
69
+ }
70
+
71
+ resetStats(): void {
72
+ this._hits = 0;
73
+ this._misses = 0;
74
+ }
75
+ }