@withwiz/toolkit 0.2.2 → 0.2.4

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 (46) hide show
  1. package/dist/auth/core/jwt/index.js +1 -1
  2. package/dist/auth/index.js +20 -20
  3. package/dist/{chunk-H5I5GWAA.js → chunk-6DD3MUDZ.js} +2 -2
  4. package/dist/{chunk-2KAPUVIS.js → chunk-7JWIX5BS.js} +1 -1
  5. package/dist/{chunk-N4YGR5WH.js → chunk-HCF3C3AQ.js} +11 -10
  6. package/dist/{chunk-3DZA6AGS.js → chunk-IJCVFLEY.js} +11 -4
  7. package/dist/{chunk-KXAWBFJN.js → chunk-IYXMGIEP.js} +11 -10
  8. package/dist/{chunk-MLGO3HLS.js → chunk-KXXROUA5.js} +20 -5
  9. package/dist/{chunk-XPASCCUA.js → chunk-M4VXPTKV.js} +2 -2
  10. package/dist/{chunk-TMVS4F7E.js → chunk-QYIUGQ5Q.js} +32 -7
  11. package/dist/{chunk-POKGHK3L.js → chunk-S54PFAEU.js} +2 -2
  12. package/dist/{chunk-Y3OTJH2S.js → chunk-SNVGJPPX.js} +36 -13
  13. package/dist/{chunk-T3LJYAMO.js → chunk-UT4J7NPS.js} +1 -1
  14. package/dist/{chunk-UXQRU3EM.js → chunk-V4KAPU2S.js} +3 -3
  15. package/dist/{chunk-GPBOMJSZ.js → chunk-WDRDGFHO.js} +74 -16
  16. package/dist/{chunk-SLG26KHZ.js → chunk-WTRBW2UY.js} +3 -3
  17. package/dist/{chunk-EEUBKZV4.js → chunk-Y2JYA2AR.js} +2 -2
  18. package/dist/constants/error-codes.d.ts +19 -12
  19. package/dist/constants/error-codes.js +3 -1
  20. package/dist/constants/index.js +3 -1
  21. package/dist/error/app-error.d.ts +1 -0
  22. package/dist/error/app-error.js +2 -2
  23. package/dist/error/error-display.d.ts +1 -1
  24. package/dist/error/error-display.js +7 -3
  25. package/dist/error/error-handler.d.ts +51 -12
  26. package/dist/error/error-handler.js +6 -3
  27. package/dist/error/friendly-messages-v2.js +5 -5
  28. package/dist/error/friendly-messages.d.ts +3 -0
  29. package/dist/error/friendly-messages.js +113 -5
  30. package/dist/error/index.js +22 -20
  31. package/dist/error/messages/en.js +1 -1
  32. package/dist/error/messages/index.js +3 -3
  33. package/dist/error/messages/ko.js +1 -1
  34. package/dist/middleware/auth.js +4 -4
  35. package/dist/middleware/error-handler.js +8 -6
  36. package/dist/middleware/index.js +11 -10
  37. package/dist/middleware/rate-limit.js +3 -3
  38. package/dist/middleware/wrappers.js +11 -10
  39. package/dist/storage/r2-storage.js +7 -3
  40. package/dist/utils/api-helpers.js +2 -2
  41. package/dist/utils/error-processor.js +3 -3
  42. package/dist/utils/index.js +4 -4
  43. package/dist/utils/input-validation.js +4 -4
  44. package/dist/utils/optimistic-lock.js +2 -2
  45. package/package.json +2 -1
  46. package/dist/chunk-2DVWSDST.js +0 -119
@@ -4,7 +4,7 @@ import {
4
4
  withCustomApi,
5
5
  withOptionalAuthApi,
6
6
  withPublicApi
7
- } from "../chunk-SLG26KHZ.js";
7
+ } from "../chunk-WTRBW2UY.js";
8
8
  import {
9
9
  MiddlewareChain
10
10
  } from "../chunk-4ODT3Q4A.js";
@@ -12,7 +12,7 @@ import {
12
12
  createRateLimitMiddleware,
13
13
  rateLimitMiddleware,
14
14
  setRateLimitAdapter
15
- } from "../chunk-H5I5GWAA.js";
15
+ } from "../chunk-6DD3MUDZ.js";
16
16
  import {
17
17
  responseLoggerMiddleware
18
18
  } from "../chunk-KAWVMIRJ.js";
@@ -26,24 +26,25 @@ import {
26
26
  initializeAuthMiddleware,
27
27
  optionalAuthMiddleware,
28
28
  setAccessTokenBlacklistChecker
29
- } from "../chunk-UXQRU3EM.js";
29
+ } from "../chunk-V4KAPU2S.js";
30
30
  import {
31
31
  corsMiddleware,
32
32
  validateCorsConfiguration
33
33
  } from "../chunk-FOKAATUQ.js";
34
34
  import {
35
35
  errorHandlerMiddleware
36
- } from "../chunk-TMVS4F7E.js";
36
+ } from "../chunk-QYIUGQ5Q.js";
37
37
  import {
38
38
  initRequestMiddleware
39
39
  } from "../chunk-62Q7DN5G.js";
40
40
  import "../chunk-XHZ5L4FO.js";
41
- import "../chunk-EEUBKZV4.js";
42
- import "../chunk-N4YGR5WH.js";
43
- import "../chunk-KXAWBFJN.js";
44
- import "../chunk-MLGO3HLS.js";
45
- import "../chunk-Y3OTJH2S.js";
46
- import "../chunk-T3LJYAMO.js";
41
+ import "../chunk-WDRDGFHO.js";
42
+ import "../chunk-Y2JYA2AR.js";
43
+ import "../chunk-HCF3C3AQ.js";
44
+ import "../chunk-IYXMGIEP.js";
45
+ import "../chunk-KXXROUA5.js";
46
+ import "../chunk-SNVGJPPX.js";
47
+ import "../chunk-UT4J7NPS.js";
47
48
  import "../chunk-AIH3F7JV.js";
48
49
  import "../chunk-EZR55KV2.js";
49
50
  import "../chunk-ORMEWXMH.js";
@@ -2,9 +2,9 @@ import {
2
2
  createRateLimitMiddleware,
3
3
  rateLimitMiddleware,
4
4
  setRateLimitAdapter
5
- } from "../chunk-H5I5GWAA.js";
6
- import "../chunk-MLGO3HLS.js";
7
- import "../chunk-Y3OTJH2S.js";
5
+ } from "../chunk-6DD3MUDZ.js";
6
+ import "../chunk-KXXROUA5.js";
7
+ import "../chunk-SNVGJPPX.js";
8
8
  import "../chunk-EZR55KV2.js";
9
9
  import "../chunk-ORMEWXMH.js";
10
10
  export {
@@ -4,22 +4,23 @@ import {
4
4
  withCustomApi,
5
5
  withOptionalAuthApi,
6
6
  withPublicApi
7
- } from "../chunk-SLG26KHZ.js";
7
+ } from "../chunk-WTRBW2UY.js";
8
8
  import "../chunk-4ODT3Q4A.js";
9
- import "../chunk-H5I5GWAA.js";
9
+ import "../chunk-6DD3MUDZ.js";
10
10
  import "../chunk-KAWVMIRJ.js";
11
11
  import "../chunk-WSQMXMTL.js";
12
- import "../chunk-UXQRU3EM.js";
12
+ import "../chunk-V4KAPU2S.js";
13
13
  import "../chunk-FOKAATUQ.js";
14
- import "../chunk-TMVS4F7E.js";
14
+ import "../chunk-QYIUGQ5Q.js";
15
15
  import "../chunk-62Q7DN5G.js";
16
16
  import "../chunk-XHZ5L4FO.js";
17
- import "../chunk-EEUBKZV4.js";
18
- import "../chunk-N4YGR5WH.js";
19
- import "../chunk-KXAWBFJN.js";
20
- import "../chunk-MLGO3HLS.js";
21
- import "../chunk-Y3OTJH2S.js";
22
- import "../chunk-T3LJYAMO.js";
17
+ import "../chunk-WDRDGFHO.js";
18
+ import "../chunk-Y2JYA2AR.js";
19
+ import "../chunk-HCF3C3AQ.js";
20
+ import "../chunk-IYXMGIEP.js";
21
+ import "../chunk-KXXROUA5.js";
22
+ import "../chunk-SNVGJPPX.js";
23
+ import "../chunk-UT4J7NPS.js";
23
24
  import "../chunk-AIH3F7JV.js";
24
25
  import "../chunk-EZR55KV2.js";
25
26
  import "../chunk-ORMEWXMH.js";
@@ -1,3 +1,7 @@
1
+ import {
2
+ AppError
3
+ } from "../chunk-KXXROUA5.js";
4
+ import "../chunk-SNVGJPPX.js";
1
5
  import "../chunk-ORMEWXMH.js";
2
6
 
3
7
  // src/storage/r2-storage.ts
@@ -44,7 +48,7 @@ async function uploadToR2(key, body, contentType) {
44
48
  const client = getClient();
45
49
  const config = getConfig();
46
50
  if (!client || !config) {
47
- throw new Error("R2 storage is not configured");
51
+ throw AppError.serviceUnavailable("R2 storage is not configured");
48
52
  }
49
53
  await client.send(
50
54
  new PutObjectCommand({
@@ -65,7 +69,7 @@ async function deleteFromR2(key) {
65
69
  const client = getClient();
66
70
  const config = getConfig();
67
71
  if (!client || !config) {
68
- throw new Error("R2 storage is not configured");
72
+ throw AppError.serviceUnavailable("R2 storage is not configured");
69
73
  }
70
74
  await client.send(
71
75
  new DeleteObjectCommand({
@@ -78,7 +82,7 @@ async function getFromR2(key) {
78
82
  const client = getClient();
79
83
  const config = getConfig();
80
84
  if (!client || !config) {
81
- throw new Error("R2 storage is not configured");
85
+ throw AppError.serviceUnavailable("R2 storage is not configured");
82
86
  }
83
87
  try {
84
88
  const response = await client.send(
@@ -11,8 +11,8 @@ import {
11
11
  parseSort,
12
12
  requireAdmin,
13
13
  validateAndParse
14
- } from "../chunk-2KAPUVIS.js";
15
- import "../chunk-Y3OTJH2S.js";
14
+ } from "../chunk-7JWIX5BS.js";
15
+ import "../chunk-SNVGJPPX.js";
16
16
  import "../chunk-ORMEWXMH.js";
17
17
  export {
18
18
  createPaginatedResponse,
@@ -12,9 +12,9 @@ import {
12
12
  throwUnauthorizedError,
13
13
  throwValidationError,
14
14
  withErrorHandling
15
- } from "../chunk-XPASCCUA.js";
16
- import "../chunk-MLGO3HLS.js";
17
- import "../chunk-Y3OTJH2S.js";
15
+ } from "../chunk-M4VXPTKV.js";
16
+ import "../chunk-KXXROUA5.js";
17
+ import "../chunk-SNVGJPPX.js";
18
18
  import "../chunk-EZR55KV2.js";
19
19
  import "../chunk-ORMEWXMH.js";
20
20
  export {
@@ -66,7 +66,7 @@ import {
66
66
  throwUnauthorizedError,
67
67
  throwValidationError,
68
68
  withErrorHandling
69
- } from "../chunk-XPASCCUA.js";
69
+ } from "../chunk-M4VXPTKV.js";
70
70
  import {
71
71
  createPaginatedResponse,
72
72
  getReferer,
@@ -80,9 +80,9 @@ import {
80
80
  parseSort,
81
81
  requireAdmin,
82
82
  validateAndParse
83
- } from "../chunk-2KAPUVIS.js";
84
- import "../chunk-MLGO3HLS.js";
85
- import "../chunk-Y3OTJH2S.js";
83
+ } from "../chunk-7JWIX5BS.js";
84
+ import "../chunk-KXXROUA5.js";
85
+ import "../chunk-SNVGJPPX.js";
86
86
  import "../chunk-EZR55KV2.js";
87
87
  import "../chunk-ORMEWXMH.js";
88
88
  export {
@@ -74,7 +74,7 @@ function escapeHTML(input) {
74
74
  if (typeof input !== "string") {
75
75
  return "";
76
76
  }
77
- return input.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#x27;").replace(/\//g, "&#x2F;");
77
+ return input.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#x27;");
78
78
  }
79
79
  function detectXSS(input) {
80
80
  if (typeof input !== "string") {
@@ -149,14 +149,14 @@ function sanitizeInput(input, options = {}) {
149
149
  if (trim) {
150
150
  sanitized = sanitized.trim();
151
151
  }
152
- if (sanitized.length > maxLength) {
153
- sanitized = sanitized.substring(0, maxLength);
154
- }
155
152
  if (!allowHTML) {
156
153
  sanitized = escapeHTML(sanitized);
157
154
  }
158
155
  sanitized = sanitized.replace(/\0/g, "");
159
156
  sanitized = sanitized.replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, "");
157
+ if (sanitized.length > maxLength) {
158
+ sanitized = sanitized.substring(0, maxLength);
159
+ }
160
160
  return sanitized;
161
161
  }
162
162
  function validateFilename(filename) {
@@ -1,7 +1,7 @@
1
1
  import {
2
2
  AppError
3
- } from "../chunk-MLGO3HLS.js";
4
- import "../chunk-Y3OTJH2S.js";
3
+ } from "../chunk-KXXROUA5.js";
4
+ import "../chunk-SNVGJPPX.js";
5
5
  import "../chunk-ORMEWXMH.js";
6
6
 
7
7
  // src/utils/optimistic-lock.ts
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@withwiz/toolkit",
3
- "version": "0.2.2",
3
+ "version": "0.2.4",
4
4
  "description": "Shared utility library for withwiz projects",
5
5
  "license": "MIT",
6
6
  "private": false,
@@ -41,6 +41,7 @@
41
41
  "./error/app-error": "./dist/error/app-error.js",
42
42
  "./error/error-handler": "./dist/error/error-handler.js",
43
43
  "./error/error-display": "./dist/error/error-display.js",
44
+ "./error/messages": "./dist/error/messages/index.js",
44
45
  "./geolocation": "./dist/geolocation/index.js",
45
46
  "./geolocation/batch-processor": "./dist/geolocation/batch-processor.js",
46
47
  "./geolocation/providers": "./dist/geolocation/providers/index.js",
@@ -1,119 +0,0 @@
1
- import {
2
- getErrorCategory
3
- } from "./chunk-Y3OTJH2S.js";
4
-
5
- // src/error/friendly-messages.ts
6
- var koMessages = {
7
- // 검증 (400xx)
8
- 40001: { title: "\uC785\uB825 \uC815\uBCF4\uB97C \uD655\uC778\uD574 \uC8FC\uC138\uC694", description: "\uC785\uB825\uD558\uC2E0 \uC815\uBCF4 \uC911 \uC77C\uBD80\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uC785\uB825 \uB0B4\uC6A9\uC744 \uB2E4\uC2DC \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
9
- 40002: { title: "\uC694\uCCAD\uC744 \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC5B4\uC694", description: "\uC694\uCCAD \uD615\uC2DD\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uD398\uC774\uC9C0\uB97C \uC0C8\uB85C\uACE0\uCE68\uD574 \uC8FC\uC138\uC694." },
10
- 40003: { title: "\uC785\uB825\uAC12\uC774 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC544\uC694", description: "\uD5C8\uC6A9\uB418\uC9C0 \uC54A\uB294 \uD615\uC2DD\uC785\uB2C8\uB2E4.", action: "\uC62C\uBC14\uB978 \uD615\uC2DD\uC73C\uB85C \uC785\uB825\uD574 \uC8FC\uC138\uC694." },
11
- 40004: { title: "\uD544\uC218 \uC815\uBCF4\uAC00 \uBE60\uC84C\uC5B4\uC694", description: "\uD544\uC218 \uD56D\uBAA9\uC774 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.", action: "\uBAA8\uB4E0 \uD544\uC218 \uD56D\uBAA9\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694." },
12
- 40005: { title: "URL \uD615\uC2DD\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694", description: "https://\uB85C \uC2DC\uC791\uD558\uB294 URL\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694.", action: "\uC608: https://example.com" },
13
- 40006: { title: "\uC774\uBA54\uC77C \uD615\uC2DD\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694", description: "\uC62C\uBC14\uB978 \uC774\uBA54\uC77C \uC8FC\uC18C\uAC00 \uC544\uB2D9\uB2C8\uB2E4.", action: "\uC608: user@example.com" },
14
- 40007: { title: "\uB354 \uC548\uC804\uD55C \uBE44\uBC00\uBC88\uD638\uAC00 \uD544\uC694\uD574\uC694", description: "8\uC790 \uC774\uC0C1, \uC601\uBB38/\uC22B\uC790/\uD2B9\uC218\uBB38\uC790 \uD3EC\uD568", action: "\uB354 \uBCF5\uC7A1\uD55C \uBE44\uBC00\uBC88\uD638\uB97C \uC124\uC815\uD574 \uC8FC\uC138\uC694." },
15
- 40008: { title: "\uBCC4\uCE6D \uD615\uC2DD\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694", description: "\uC601\uBB38, \uC22B\uC790, \uD558\uC774\uD508(-)\uB9CC \uC0AC\uC6A9 \uAC00\uB2A5", action: "\uC608: my-link-123" },
16
- // 인증 (401xx)
17
- 40101: { title: "\uB85C\uADF8\uC778\uC774 \uD544\uC694\uD574\uC694", description: "\uC774 \uAE30\uB2A5\uC740 \uB85C\uADF8\uC778\uC774 \uD544\uC694\uD569\uB2C8\uB2E4.", action: "\uB85C\uADF8\uC778 \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
18
- 40102: { title: "\uC778\uC99D \uC815\uBCF4\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC544\uC694", description: "\uB85C\uADF8\uC778 \uC0C1\uD0DC\uAC00 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uB85C\uADF8\uC778\uD574 \uC8FC\uC138\uC694." },
19
- 40103: { title: "\uB85C\uADF8\uC778\uC774 \uB9CC\uB8CC\uB418\uC5C8\uC5B4\uC694", description: "\uBCF4\uC548\uC744 \uC704\uD574 \uC138\uC158\uC774 \uB9CC\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uB85C\uADF8\uC778\uD574 \uC8FC\uC138\uC694." },
20
- 40106: { title: "\uB85C\uADF8\uC778\uC5D0 \uC2E4\uD328\uD588\uC5B4\uC694", description: "\uC774\uBA54\uC77C \uB610\uB294 \uBE44\uBC00\uBC88\uD638\uAC00 \uC77C\uCE58\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
21
- 40107: { title: "\uC138\uC158\uC774 \uC885\uB8CC\uB418\uC5C8\uC5B4\uC694", description: "\uC790\uB3D9 \uB85C\uADF8\uC544\uC6C3\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uB85C\uADF8\uC778\uD574 \uC8FC\uC138\uC694." },
22
- // 권한 (403xx)
23
- 40304: { title: "\uC811\uADFC \uAD8C\uD55C\uC774 \uC5C6\uC5B4\uC694", description: "\uC774 \uAE30\uB2A5\uC5D0 \uB300\uD55C \uAD8C\uD55C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4.", action: "\uAD00\uB9AC\uC790\uC5D0\uAC8C \uBB38\uC758\uD574 \uC8FC\uC138\uC694." },
24
- 40305: { title: "\uC774\uBA54\uC77C \uC778\uC99D\uC774 \uD544\uC694\uD574\uC694", description: "\uC774\uBA54\uC77C \uC778\uC99D\uC744 \uBA3C\uC800 \uC644\uB8CC\uD574 \uC8FC\uC138\uC694.", action: "\uBA54\uC77C\uD568\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
25
- 40308: { title: "\uACC4\uC815\uC774 \uBE44\uD65C\uC131\uD654\uB418\uC5C8\uC5B4\uC694", description: "\uC11C\uBE44\uC2A4\uB97C \uC774\uC6A9\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.", action: "\uACE0\uAC1D\uC13C\uD130\uB85C \uBB38\uC758\uD574 \uC8FC\uC138\uC694." },
26
- 40309: { title: "\uACC4\uC815\uC774 \uC7A0\uAE08\uB418\uC5C8\uC5B4\uC694", description: "\uB85C\uADF8\uC778 \uC2E4\uD328\uB85C \uACC4\uC815\uC774 \uC7A0\uACBC\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
27
- // 리소스 (404xx)
28
- 40401: { title: "\uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uC694\uCCAD\uD558\uC2E0 \uD56D\uBAA9\uC774 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uC8FC\uC18C\uB97C \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
29
- 40402: { title: "\uC0AC\uC6A9\uC790\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uD574\uB2F9 \uC0AC\uC6A9\uC790\uAC00 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." },
30
- 40403: { title: "\uB9C1\uD06C\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uB2E8\uCD95 \uB9C1\uD06C\uAC00 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uB9C1\uD06C \uC8FC\uC18C\uB97C \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
31
- 40408: { title: "\uD0DC\uADF8\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uD0DC\uADF8\uAC00 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." },
32
- 40409: { title: "\uC990\uACA8\uCC3E\uAE30\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uD56D\uBAA9\uC774 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." },
33
- 40410: { title: "\uADF8\uB8F9\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC5B4\uC694", description: "\uADF8\uB8F9\uC774 \uC874\uC7AC\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4." },
34
- // 충돌 (409xx)
35
- 40904: { title: "\uCDA9\uB3CC\uC774 \uBC1C\uC0DD\uD588\uC5B4\uC694", description: "\uAE30\uC874 \uB370\uC774\uD130\uC640 \uCDA9\uB3CC\uD569\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
36
- 40905: { title: "\uC774\uBBF8 \uC874\uC7AC\uD574\uC694", description: "\uB3D9\uC77C\uD55C \uD56D\uBAA9\uC774 \uC788\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uB978 \uAC12\uC744 \uC0AC\uC6A9\uD574 \uC8FC\uC138\uC694." },
37
- 40906: { title: "\uC774\uBBF8 \uB4F1\uB85D\uB41C \uC774\uBA54\uC77C\uC774\uC5D0\uC694", description: "\uB2E4\uB978 \uACC4\uC815\uC5D0\uC11C \uC0AC\uC6A9 \uC911\uC785\uB2C8\uB2E4.", action: "\uB2E4\uB978 \uC774\uBA54\uC77C\uC744 \uC0AC\uC6A9\uD574 \uC8FC\uC138\uC694." },
38
- 40907: { title: "\uC774\uBBF8 \uC0AC\uC6A9 \uC911\uC778 \uBCC4\uCE6D\uC774\uC5D0\uC694", description: "\uB2E4\uB978 \uB9C1\uD06C\uC5D0\uC11C \uC0AC\uC6A9 \uC911\uC785\uB2C8\uB2E4.", action: "\uB2E4\uB978 \uBCC4\uCE6D\uC744 \uC785\uB825\uD574 \uC8FC\uC138\uC694." },
39
- // 비즈니스 (422xx)
40
- 42201: { title: "\uCC98\uB9AC\uD560 \uC218 \uC5C6\uC5B4\uC694", description: "\uD604\uC7AC \uC0C1\uD0DC\uC5D0\uC11C \uCC98\uB9AC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.", action: "\uC870\uAC74\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
41
- 42202: { title: "\uC9C0\uAE08\uC740 \uD560 \uC218 \uC5C6\uB294 \uC791\uC5C5\uC774\uC5D0\uC694", description: "\uD604\uC7AC \uC0C1\uD0DC\uC5D0\uC11C \uBD88\uAC00\uB2A5\uD569\uB2C8\uB2E4." },
42
- 42203: { title: "\uC0AC\uC6A9\uB7C9\uC744 \uCD08\uACFC\uD588\uC5B4\uC694", description: "\uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.", action: "\uD50C\uB79C \uC5C5\uADF8\uB808\uC774\uB4DC\uB97C \uACE0\uB824\uD574 \uC8FC\uC138\uC694." },
43
- 42204: { title: "\uB9CC\uB8CC\uB41C \uB9C1\uD06C\uC608\uC694", description: "\uC720\uD6A8 \uAE30\uAC04\uC774 \uC9C0\uB0AC\uC2B5\uB2C8\uB2E4.", action: "\uC0C8 \uB9C1\uD06C\uB97C \uC0DD\uC131\uD574 \uC8FC\uC138\uC694." },
44
- 42205: { title: "\uBE44\uD65C\uC131\uD654\uB41C \uB9C1\uD06C\uC608\uC694", description: "\uC0AC\uC6A9\uC774 \uC911\uC9C0\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uC18C\uC720\uC790\uC5D0\uAC8C \uBB38\uC758\uD574 \uC8FC\uC138\uC694." },
45
- 42206: { title: "\uBE44\uBC00\uBC88\uD638\uAC00 \uD544\uC694\uD574\uC694", description: "\uBE44\uBC00\uBC88\uD638\uB97C \uC785\uB825\uD574\uC57C \uD569\uB2C8\uB2E4.", action: "\uBE44\uBC00\uBC88\uD638\uB97C \uC785\uB825\uD574 \uC8FC\uC138\uC694." },
46
- 42207: { title: "\uBE44\uBC00\uBC88\uD638\uAC00 \uD2C0\uB838\uC5B4\uC694", description: "\uBE44\uBC00\uBC88\uD638\uAC00 \uC62C\uBC14\uB974\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
47
- 42208: { title: "\uC0AC\uC6A9\uD560 \uC218 \uC5C6\uB294 \uBCC4\uCE6D\uC774\uC5D0\uC694", description: "\uC2DC\uC2A4\uD15C \uC608\uC57D\uC5B4\uC785\uB2C8\uB2E4.", action: "\uB2E4\uB978 \uBCC4\uCE6D\uC744 \uC120\uD0DD\uD574 \uC8FC\uC138\uC694." },
48
- 42209: { title: "\uC774\uBBF8 \uC990\uACA8\uCC3E\uAE30\uC5D0 \uC788\uC5B4\uC694", description: "\uC774\uBBF8 \uCD94\uAC00\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4." },
49
- 42210: { title: "\uC0AD\uC81C\uD560 \uC218 \uC5C6\uC5B4\uC694", description: "\uBCF8\uC778 \uAD00\uB9AC\uC790 \uACC4\uC815\uC740 \uC0AD\uC81C \uBD88\uAC00\uD569\uB2C8\uB2E4." },
50
- 42211: { title: "\uD30C\uC77C\uC774 \uB108\uBB34 \uCEE4\uC694", description: "\uCD5C\uB300 \uD06C\uAE30\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.", action: "\uC791\uC740 \uD30C\uC77C\uC744 \uC120\uD0DD\uD574 \uC8FC\uC138\uC694." },
51
- 42212: { title: "\uC9C0\uC6D0\uD558\uC9C0 \uC54A\uB294 \uD30C\uC77C \uD615\uC2DD\uC774\uC5D0\uC694", description: "\uC5C5\uB85C\uB4DC\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4.", action: "\uC9C0\uC6D0 \uD615\uC2DD\uC744 \uD655\uC778\uD574 \uC8FC\uC138\uC694." },
52
- // Rate Limit (429xx)
53
- 42901: { title: "\uC7A0\uC2DC \uC26C\uC5B4\uAC00\uC138\uC694", description: "\uC694\uCCAD\uC774 \uB108\uBB34 \uB9CE\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
54
- 42902: { title: "\uC624\uB298 \uC0AC\uC6A9\uB7C9\uC744 \uBAA8\uB450 \uC0AC\uC6A9\uD588\uC5B4\uC694", description: "\uC77C\uC77C \uD55C\uB3C4\uC5D0 \uB3C4\uB2EC\uD588\uC2B5\uB2C8\uB2E4.", action: "\uB0B4\uC77C \uB2E4\uC2DC \uC774\uC6A9\uD574 \uC8FC\uC138\uC694." },
55
- 42903: { title: "API \uD560\uB2F9\uB7C9\uC744 \uCD08\uACFC\uD588\uC5B4\uC694", description: "API \uD55C\uB3C4\uB97C \uCD08\uACFC\uD588\uC2B5\uB2C8\uB2E4.", action: "\uD50C\uB79C \uC5C5\uADF8\uB808\uC774\uB4DC\uB97C \uACE0\uB824\uD574 \uC8FC\uC138\uC694." },
56
- // 서버 (500xx)
57
- 50001: { title: "\uBB38\uC81C\uAC00 \uBC1C\uC0DD\uD588\uC5B4\uC694", description: "\uC11C\uBC84 \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
58
- 50002: { title: "\uC77C\uC2DC\uC801\uC778 \uC624\uB958\uC608\uC694", description: "\uACE7 \uBCF5\uAD6C\uB429\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
59
- 50003: { title: "\uB370\uC774\uD130 \uCC98\uB9AC \uC624\uB958\uC608\uC694", description: "\uB370\uC774\uD130 \uCC98\uB9AC \uC911 \uBB38\uC81C\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
60
- 50006: { title: "\uC774\uBA54\uC77C\uC744 \uBCF4\uB0B4\uC9C0 \uBABB\uD588\uC5B4\uC694", description: "\uC774\uBA54\uC77C \uC804\uC1A1\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
61
- 50007: { title: "\uC77C\uC2DC\uC801\uC778 \uC624\uB958\uC608\uC694", description: "\uCE90\uC2DC \uCC98\uB9AC \uC911 \uBB38\uC81C\uAC00 \uC788\uC2B5\uB2C8\uB2E4.", action: "\uD398\uC774\uC9C0\uB97C \uC0C8\uB85C\uACE0\uCE68\uD574 \uC8FC\uC138\uC694." },
62
- 50008: { title: "\uD30C\uC77C \uC5C5\uB85C\uB4DC\uC5D0 \uC2E4\uD328\uD588\uC5B4\uC694", description: "\uD30C\uC77C \uC800\uC7A5 \uC911 \uBB38\uC81C\uAC00 \uC788\uC2B5\uB2C8\uB2E4.", action: "\uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
63
- // 서비스 불가 (503xx)
64
- 50304: { title: "\uC678\uBD80 \uC11C\uBE44\uC2A4 \uC5F0\uACB0 \uC2E4\uD328", description: "\uC678\uBD80 \uC11C\uBE44\uC2A4\uAC00 \uC751\uB2F5\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
65
- 50305: { title: "\uC11C\uBE44\uC2A4 \uC810\uAC80 \uC911\uC774\uC5D0\uC694", description: "\uC810\uAC80 \uC911\uC785\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uBC29\uBB38\uD574 \uC8FC\uC138\uC694." },
66
- // 보안 (403xx - 71~79)
67
- 40371: { title: "\uC811\uADFC\uC774 \uCC28\uB2E8\uB418\uC5C8\uC5B4\uC694", description: "\uBCF4\uC548 \uC815\uCC45\uC73C\uB85C \uCC28\uB2E8\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uC815\uC0C1\uC801\uC778 \uBC29\uBC95\uC73C\uB85C \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
68
- 40372: { title: "\uBCF4\uC548 \uAC80\uC99D \uC2E4\uD328", description: "\uBCF4\uC548 \uD1A0\uD070\uC774 \uB9CC\uB8CC\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uD398\uC774\uC9C0\uB97C \uC0C8\uB85C\uACE0\uCE68\uD574 \uC8FC\uC138\uC694." },
69
- 40373: { title: "\uC0AC\uC6A9\uD560 \uC218 \uC5C6\uB294 URL\uC774\uC5D0\uC694", description: "\uBCF4\uC548\uC0C1 \uCC28\uB2E8\uB41C URL\uC785\uB2C8\uB2E4.", action: "\uB2E4\uB978 URL\uC744 \uC0AC\uC6A9\uD574 \uC8FC\uC138\uC694." },
70
- 40374: { title: "\uBE44\uC815\uC0C1 \uD65C\uB3D9 \uAC10\uC9C0", description: "\uC77C\uC2DC\uC801\uC73C\uB85C \uC81C\uD55C\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uACE0\uAC1D\uC13C\uD130\uB85C \uBB38\uC758\uD574 \uC8FC\uC138\uC694." },
71
- 40375: { title: "IP\uAC00 \uCC28\uB2E8\uB418\uC5C8\uC5B4\uC694", description: "\uBCF4\uC548 \uC815\uCC45\uC5D0 \uC758\uD574 \uCC28\uB2E8\uB418\uC5C8\uC2B5\uB2C8\uB2E4.", action: "\uACE0\uAC1D\uC13C\uD130\uB85C \uBB38\uC758\uD574 \uC8FC\uC138\uC694." },
72
- 40376: { title: "CORS \uC815\uCC45 \uC704\uBC18\uC774\uC5D0\uC694", description: "\uD5C8\uC6A9\uB418\uC9C0 \uC54A\uC740 \uCD9C\uCC98\uC5D0\uC11C\uC758 \uC694\uCCAD\uC785\uB2C8\uB2E4.", action: "\uC62C\uBC14\uB978 \uC8FC\uC18C\uB85C \uC811\uC18D\uD574 \uC8FC\uC138\uC694." }
73
- };
74
- var defaultMessages = {
75
- ko: { title: "\uBB38\uC81C\uAC00 \uBC1C\uC0DD\uD588\uC5B4\uC694", description: "\uC608\uC0C1\uCE58 \uBABB\uD55C \uC624\uB958\uAC00 \uBC1C\uC0DD\uD588\uC2B5\uB2C8\uB2E4.", action: "\uC7A0\uC2DC \uD6C4 \uB2E4\uC2DC \uC2DC\uB3C4\uD574 \uC8FC\uC138\uC694." },
76
- en: { title: "Something went wrong", description: "An unexpected error occurred.", action: "Please try again later." }
77
- };
78
- var categoryIcons = {
79
- validation: "\u26A0\uFE0F",
80
- auth: "\u{1F510}",
81
- permission: "\u{1F6AB}",
82
- resource: "\u{1F50D}",
83
- conflict: "\u26A1",
84
- business: "\u{1F4CB}",
85
- rateLimit: "\u23F1\uFE0F",
86
- server: "\u{1F527}",
87
- security: "\u{1F6E1}\uFE0F",
88
- unknown: "\u274C"
89
- };
90
- var categorySeverity = {
91
- validation: "warning",
92
- auth: "warning",
93
- permission: "warning",
94
- resource: "info",
95
- conflict: "warning",
96
- business: "warning",
97
- rateLimit: "warning",
98
- server: "error",
99
- security: "critical",
100
- unknown: "error"
101
- };
102
- function getFriendlyMessage(code, locale = "ko") {
103
- return koMessages[code] || defaultMessages[locale];
104
- }
105
- function getErrorDisplayInfo(code, locale = "ko") {
106
- const message = getFriendlyMessage(code, locale);
107
- const category = getErrorCategory(code);
108
- return { code, title: message.title, description: message.description, action: message.action, icon: categoryIcons[category], severity: categorySeverity[category] };
109
- }
110
- function formatFriendlyError(code, locale = "ko") {
111
- const { title, description } = getFriendlyMessage(code, locale);
112
- return `${title} - ${description} [${code}]`;
113
- }
114
-
115
- export {
116
- getFriendlyMessage,
117
- getErrorDisplayInfo,
118
- formatFriendlyError
119
- };