@devskeo/ward-agent 1.0.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 (105) hide show
  1. package/dist/cli/config.d.ts +2 -0
  2. package/dist/cli/config.d.ts.map +1 -0
  3. package/dist/cli/config.js +30 -0
  4. package/dist/cli/config.js.map +1 -0
  5. package/dist/cli/pipe.d.ts +2 -0
  6. package/dist/cli/pipe.d.ts.map +1 -0
  7. package/dist/cli/pipe.js +53 -0
  8. package/dist/cli/pipe.js.map +1 -0
  9. package/dist/cli/service.d.ts +10 -0
  10. package/dist/cli/service.d.ts.map +1 -0
  11. package/dist/cli/service.js +134 -0
  12. package/dist/cli/service.js.map +1 -0
  13. package/dist/cli/start.d.ts +6 -0
  14. package/dist/cli/start.d.ts.map +1 -0
  15. package/dist/cli/start.js +160 -0
  16. package/dist/cli/start.js.map +1 -0
  17. package/dist/cli/status.d.ts +2 -0
  18. package/dist/cli/status.d.ts.map +1 -0
  19. package/dist/cli/status.js +56 -0
  20. package/dist/cli/status.js.map +1 -0
  21. package/dist/cli/stop.d.ts +2 -0
  22. package/dist/cli/stop.d.ts.map +1 -0
  23. package/dist/cli/stop.js +106 -0
  24. package/dist/cli/stop.js.map +1 -0
  25. package/dist/cli/systemd.d.ts +3 -0
  26. package/dist/cli/systemd.d.ts.map +1 -0
  27. package/dist/cli/systemd.js +84 -0
  28. package/dist/cli/systemd.js.map +1 -0
  29. package/dist/config/AgentConfig.d.ts +30 -0
  30. package/dist/config/AgentConfig.d.ts.map +1 -0
  31. package/dist/config/AgentConfig.js +155 -0
  32. package/dist/config/AgentConfig.js.map +1 -0
  33. package/dist/config/ServiceConfig.d.ts +30 -0
  34. package/dist/config/ServiceConfig.d.ts.map +1 -0
  35. package/dist/config/ServiceConfig.js +4 -0
  36. package/dist/config/ServiceConfig.js.map +1 -0
  37. package/dist/daemon.d.ts +2 -0
  38. package/dist/daemon.d.ts.map +1 -0
  39. package/dist/daemon.js +300 -0
  40. package/dist/daemon.js.map +1 -0
  41. package/dist/index.d.ts +3 -0
  42. package/dist/index.d.ts.map +1 -0
  43. package/dist/index.js +94 -0
  44. package/dist/index.js.map +1 -0
  45. package/dist/logs/LogForwarder.d.ts +22 -0
  46. package/dist/logs/LogForwarder.d.ts.map +1 -0
  47. package/dist/logs/LogForwarder.js +83 -0
  48. package/dist/logs/LogForwarder.js.map +1 -0
  49. package/dist/logs/LogWatcher.d.ts +15 -0
  50. package/dist/logs/LogWatcher.d.ts.map +1 -0
  51. package/dist/logs/LogWatcher.js +111 -0
  52. package/dist/logs/LogWatcher.js.map +1 -0
  53. package/dist/logs/ServiceWatcher.d.ts +32 -0
  54. package/dist/logs/ServiceWatcher.d.ts.map +1 -0
  55. package/dist/logs/ServiceWatcher.js +294 -0
  56. package/dist/logs/ServiceWatcher.js.map +1 -0
  57. package/dist/metrics/CpuCollector.d.ts +9 -0
  58. package/dist/metrics/CpuCollector.d.ts.map +1 -0
  59. package/dist/metrics/CpuCollector.js +24 -0
  60. package/dist/metrics/CpuCollector.js.map +1 -0
  61. package/dist/metrics/DiskCollector.d.ts +11 -0
  62. package/dist/metrics/DiskCollector.d.ts.map +1 -0
  63. package/dist/metrics/DiskCollector.js +51 -0
  64. package/dist/metrics/DiskCollector.js.map +1 -0
  65. package/dist/metrics/IpCollector.d.ts +13 -0
  66. package/dist/metrics/IpCollector.d.ts.map +1 -0
  67. package/dist/metrics/IpCollector.js +34 -0
  68. package/dist/metrics/IpCollector.js.map +1 -0
  69. package/dist/metrics/MemoryCollector.d.ts +12 -0
  70. package/dist/metrics/MemoryCollector.d.ts.map +1 -0
  71. package/dist/metrics/MemoryCollector.js +27 -0
  72. package/dist/metrics/MemoryCollector.js.map +1 -0
  73. package/dist/metrics/NetworkCollector.d.ts +9 -0
  74. package/dist/metrics/NetworkCollector.d.ts.map +1 -0
  75. package/dist/metrics/NetworkCollector.js +24 -0
  76. package/dist/metrics/NetworkCollector.js.map +1 -0
  77. package/dist/metrics/ProcessCollector.d.ts +16 -0
  78. package/dist/metrics/ProcessCollector.d.ts.map +1 -0
  79. package/dist/metrics/ProcessCollector.js +34 -0
  80. package/dist/metrics/ProcessCollector.js.map +1 -0
  81. package/dist/start-dev.d.ts +2 -0
  82. package/dist/start-dev.d.ts.map +1 -0
  83. package/dist/start-dev.js +205 -0
  84. package/dist/start-dev.js.map +1 -0
  85. package/dist/start-self.d.ts +2 -0
  86. package/dist/start-self.d.ts.map +1 -0
  87. package/dist/start-self.js +271 -0
  88. package/dist/start-self.js.map +1 -0
  89. package/dist/transport/HttpClient.d.ts +53 -0
  90. package/dist/transport/HttpClient.d.ts.map +1 -0
  91. package/dist/transport/HttpClient.js +172 -0
  92. package/dist/transport/HttpClient.js.map +1 -0
  93. package/dist/transport/Queue.d.ts +29 -0
  94. package/dist/transport/Queue.d.ts.map +1 -0
  95. package/dist/transport/Queue.js +74 -0
  96. package/dist/transport/Queue.js.map +1 -0
  97. package/dist/transport/ReconnectManager.d.ts +14 -0
  98. package/dist/transport/ReconnectManager.d.ts.map +1 -0
  99. package/dist/transport/ReconnectManager.js +59 -0
  100. package/dist/transport/ReconnectManager.js.map +1 -0
  101. package/dist/types/index.d.ts +35 -0
  102. package/dist/types/index.d.ts.map +1 -0
  103. package/dist/types/index.js +3 -0
  104. package/dist/types/index.js.map +1 -0
  105. package/package.json +41 -0
@@ -0,0 +1,172 @@
1
+ "use strict";
2
+ // HTTP 전송 클라이언트
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.HttpClient = exports.SendErrorType = void 0;
5
+ var SendErrorType;
6
+ (function (SendErrorType) {
7
+ SendErrorType["CONNECTION_REFUSED"] = "CONNECTION_REFUSED";
8
+ SendErrorType["TIMEOUT"] = "TIMEOUT";
9
+ SendErrorType["HTTP_ERROR"] = "HTTP_ERROR";
10
+ SendErrorType["UNKNOWN"] = "UNKNOWN";
11
+ })(SendErrorType || (exports.SendErrorType = SendErrorType = {}));
12
+ // Ward 서버로 데이터를 전송하는 HTTP 클라이언트
13
+ class HttpClient {
14
+ serverUrl;
15
+ serverId;
16
+ timeoutMs;
17
+ constructor(options) {
18
+ this.serverUrl = options.serverUrl.replace(/\/$/, ''); // 끝 슬래시 제거
19
+ this.serverId = options.serverId;
20
+ this.timeoutMs = options.timeoutMs ?? 10000; // 기본 10초 타임아웃
21
+ }
22
+ // 에러를 SendErrorType으로 분류
23
+ classifyError(error) {
24
+ if (error instanceof Error) {
25
+ if (error.name === 'AbortError') {
26
+ return { error: '요청 타임아웃', errorType: SendErrorType.TIMEOUT };
27
+ }
28
+ const nodeError = error;
29
+ if (nodeError.code === 'ECONNREFUSED' || nodeError.code === 'ENOTFOUND') {
30
+ return { error: error.message, errorType: SendErrorType.CONNECTION_REFUSED };
31
+ }
32
+ return { error: error.message, errorType: SendErrorType.UNKNOWN };
33
+ }
34
+ return { error: '알 수 없는 오류', errorType: SendErrorType.UNKNOWN };
35
+ }
36
+ // 공통 POST 요청 메서드 (x-ward-server-id 헤더 포함)
37
+ async post(path, body) {
38
+ const url = `${this.serverUrl}${path}`;
39
+ const controller = new AbortController();
40
+ const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
41
+ try {
42
+ const response = await fetch(url, {
43
+ method: 'POST',
44
+ headers: {
45
+ 'Content-Type': 'application/json',
46
+ 'x-ward-server-id': this.serverId,
47
+ },
48
+ body: JSON.stringify(body),
49
+ signal: controller.signal,
50
+ });
51
+ clearTimeout(timeoutId);
52
+ if (response.ok) {
53
+ return { success: true, statusCode: response.status };
54
+ }
55
+ else {
56
+ return {
57
+ success: false,
58
+ statusCode: response.status,
59
+ error: `HTTP 오류: ${response.status} ${response.statusText}`,
60
+ errorType: SendErrorType.HTTP_ERROR,
61
+ };
62
+ }
63
+ }
64
+ catch (error) {
65
+ clearTimeout(timeoutId);
66
+ const classified = this.classifyError(error);
67
+ return { success: false, ...classified };
68
+ }
69
+ }
70
+ // 서버 등록 (인증 헤더 없이)
71
+ async register(hostname, groupName, osInfo) {
72
+ const url = `${this.serverUrl}/api/agent/register`;
73
+ const controller = new AbortController();
74
+ const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
75
+ try {
76
+ const response = await fetch(url, {
77
+ method: 'POST',
78
+ headers: { 'Content-Type': 'application/json' },
79
+ body: JSON.stringify({ hostname, groupName, ...osInfo }),
80
+ signal: controller.signal,
81
+ });
82
+ clearTimeout(timeoutId);
83
+ if (!response.ok) {
84
+ throw new Error(`HTTP 오류: ${response.status} ${response.statusText}`);
85
+ }
86
+ const data = await response.json();
87
+ return data;
88
+ }
89
+ catch (error) {
90
+ clearTimeout(timeoutId);
91
+ throw error;
92
+ }
93
+ }
94
+ // 서버 등록 해제
95
+ async unregister() {
96
+ const url = `${this.serverUrl}/api/agent/unregister`;
97
+ const controller = new AbortController();
98
+ const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
99
+ try {
100
+ const response = await fetch(url, {
101
+ method: 'DELETE',
102
+ headers: {
103
+ 'Content-Type': 'application/json',
104
+ 'x-ward-server-id': this.serverId,
105
+ },
106
+ signal: controller.signal,
107
+ });
108
+ clearTimeout(timeoutId);
109
+ if (response.ok) {
110
+ return { success: true, statusCode: response.status };
111
+ }
112
+ else {
113
+ return {
114
+ success: false,
115
+ statusCode: response.status,
116
+ error: `HTTP 오류: ${response.status} ${response.statusText}`,
117
+ errorType: SendErrorType.HTTP_ERROR,
118
+ };
119
+ }
120
+ }
121
+ catch (error) {
122
+ clearTimeout(timeoutId);
123
+ const classified = this.classifyError(error);
124
+ return { success: false, ...classified };
125
+ }
126
+ }
127
+ // 메트릭 전송
128
+ async sendMetrics(metrics) {
129
+ return this.post('/api/agent/metrics', metrics);
130
+ }
131
+ // Heartbeat 전송 (응답 body의 commands 포함 반환)
132
+ async sendHeartbeat(data) {
133
+ const url = `${this.serverUrl}/api/agent/heartbeat`;
134
+ const controller = new AbortController();
135
+ const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
136
+ try {
137
+ const response = await fetch(url, {
138
+ method: 'POST',
139
+ headers: {
140
+ 'Content-Type': 'application/json',
141
+ 'x-ward-server-id': this.serverId,
142
+ },
143
+ body: JSON.stringify(data),
144
+ signal: controller.signal,
145
+ });
146
+ clearTimeout(timeoutId);
147
+ if (response.ok) {
148
+ const body = await response.json();
149
+ return { success: true, statusCode: response.status, commands: body.commands };
150
+ }
151
+ else {
152
+ return {
153
+ success: false,
154
+ statusCode: response.status,
155
+ error: `HTTP 오류: ${response.status} ${response.statusText}`,
156
+ errorType: SendErrorType.HTTP_ERROR,
157
+ };
158
+ }
159
+ }
160
+ catch (error) {
161
+ clearTimeout(timeoutId);
162
+ const classified = this.classifyError(error);
163
+ return { success: false, ...classified };
164
+ }
165
+ }
166
+ // 서비스 목록 동기화
167
+ async syncServices(services) {
168
+ return this.post('/api/agent/services/sync', { services });
169
+ }
170
+ }
171
+ exports.HttpClient = HttpClient;
172
+ //# sourceMappingURL=HttpClient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"HttpClient.js","sourceRoot":"","sources":["../../src/transport/HttpClient.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ export interface QueueItem {
2
+ id: string;
3
+ path: string;
4
+ data: unknown;
5
+ createdAt: number;
6
+ retryCount: number;
7
+ }
8
+ export interface QueueOptions {
9
+ maxSize?: number;
10
+ maxRetries?: number;
11
+ maxAgeMs?: number;
12
+ }
13
+ export declare class Queue {
14
+ private items;
15
+ private readonly maxSize;
16
+ private readonly maxRetries;
17
+ private readonly maxAgeMs;
18
+ private idCounter;
19
+ constructor(options?: QueueOptions);
20
+ enqueue(path: string, data: unknown): QueueItem | null;
21
+ dequeue(): QueueItem | null;
22
+ dequeueAll(): QueueItem[];
23
+ requeueItem(item: QueueItem): boolean;
24
+ private evictExpired;
25
+ get size(): number;
26
+ get isEmpty(): boolean;
27
+ clear(): void;
28
+ }
29
+ //# sourceMappingURL=Queue.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../src/transport/Queue.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAGD,qBAAa,KAAK;IAChB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,SAAS,CAAK;gBAEV,OAAO,GAAE,YAAiB;IAOtC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI;IAmBtD,OAAO,IAAI,SAAS,GAAG,IAAI;IAQ3B,UAAU,IAAI,SAAS,EAAE;IAQzB,WAAW,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IAYrC,OAAO,CAAC,YAAY;IAQpB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAGD,IAAI,OAAO,IAAI,OAAO,CAErB;IAGD,KAAK,IAAI,IAAI;CAGd"}
@@ -0,0 +1,74 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.Queue = void 0;
4
+ // 메트릭 전송 실패 시 로컬 메모리 큐에 버퍼링
5
+ class Queue {
6
+ items = [];
7
+ maxSize;
8
+ maxRetries;
9
+ maxAgeMs;
10
+ idCounter = 0;
11
+ constructor(options = {}) {
12
+ this.maxSize = options.maxSize ?? 1000;
13
+ this.maxRetries = options.maxRetries ?? 3;
14
+ this.maxAgeMs = options.maxAgeMs ?? 3600000; // 1시간
15
+ }
16
+ // 큐에 아이템 추가
17
+ enqueue(path, data) {
18
+ // 최대 크기 초과 시 가장 오래된 항목 제거
19
+ if (this.items.length >= this.maxSize) {
20
+ this.items.shift();
21
+ }
22
+ const item = {
23
+ id: `queue-${++this.idCounter}-${Date.now()}`,
24
+ path,
25
+ data,
26
+ createdAt: Date.now(),
27
+ retryCount: 0,
28
+ };
29
+ this.items.push(item);
30
+ return item;
31
+ }
32
+ // 큐에서 전송 가능한 아이템 조회 (오래된 항목 먼저)
33
+ dequeue() {
34
+ this.evictExpired();
35
+ const item = this.items.shift();
36
+ return item ?? null;
37
+ }
38
+ // 여러 아이템 일괄 조회
39
+ dequeueAll() {
40
+ this.evictExpired();
41
+ const items = [...this.items];
42
+ this.items = [];
43
+ return items;
44
+ }
45
+ // 재시도 횟수 초과 시 큐에서 제거, 아직 가능하면 다시 추가
46
+ requeueItem(item) {
47
+ if (item.retryCount >= this.maxRetries) {
48
+ // 최대 재시도 횟수 초과 - 폐기
49
+ return false;
50
+ }
51
+ item.retryCount++;
52
+ this.items.push(item);
53
+ return true;
54
+ }
55
+ // 만료된 아이템 제거
56
+ evictExpired() {
57
+ const now = Date.now();
58
+ this.items = this.items.filter((item) => now - item.createdAt < this.maxAgeMs);
59
+ }
60
+ // 큐 크기 조회
61
+ get size() {
62
+ return this.items.length;
63
+ }
64
+ // 큐가 비어있는지 확인
65
+ get isEmpty() {
66
+ return this.items.length === 0;
67
+ }
68
+ // 큐 전체 비우기
69
+ clear() {
70
+ this.items = [];
71
+ }
72
+ }
73
+ exports.Queue = Queue;
74
+ //# sourceMappingURL=Queue.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Queue.js","sourceRoot":"","sources":["../../src/transport/Queue.ts"],"names":[],"mappings":";;;AAeA,4BAA4B;AAC5B,MAAa,KAAK;IACR,KAAK,GAAgB,EAAE,CAAC;IACf,OAAO,CAAS;IAChB,UAAU,CAAS;IACnB,QAAQ,CAAS;IAC1B,SAAS,GAAG,CAAC,CAAC;IAEtB,YAAY,UAAwB,EAAE;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC;QACvC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,CAAC,MAAM;IACrD,CAAC;IAED,YAAY;IACZ,OAAO,CAAC,IAAY,EAAE,IAAa;QACjC,0BAA0B;QAC1B,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACtC,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;QAED,MAAM,IAAI,GAAc;YACtB,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;YAC7C,IAAI;YACJ,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,UAAU,EAAE,CAAC;SACd,CAAC;QAEF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gCAAgC;IAChC,OAAO;QACL,IAAI,CAAC,YAAY,EAAE,CAAC;QAEpB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,OAAO,IAAI,IAAI,IAAI,CAAC;IACtB,CAAC;IAED,eAAe;IACf,UAAU;QACR,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oCAAoC;IACpC,WAAW,CAAC,IAAe;QACzB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,oBAAoB;YACpB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa;IACL,YAAY;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAC5B,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAC/C,CAAC;IACJ,CAAC;IAED,UAAU;IACV,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,cAAc;IACd,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,WAAW;IACX,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClB,CAAC;CACF;AAlFD,sBAkFC"}
@@ -0,0 +1,14 @@
1
+ import { SendResult } from './HttpClient.js';
2
+ export declare class ReconnectManager {
3
+ private isServerUp;
4
+ private retryDelayMs;
5
+ private readonly maxRetryDelayMs;
6
+ private reconnectTimer;
7
+ private onReconnect;
8
+ constructor(onReconnect: () => Promise<void>);
9
+ reportResult(result: SendResult): void;
10
+ private scheduleReconnect;
11
+ get serverAvailable(): boolean;
12
+ destroy(): void;
13
+ }
14
+ //# sourceMappingURL=ReconnectManager.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReconnectManager.d.ts","sourceRoot":"","sources":["../../src/transport/ReconnectManager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAiB,MAAM,iBAAiB,CAAC;AAE5D,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,WAAW,CAAsB;gBAE7B,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC;IAK5C,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAuBtC,OAAO,CAAC,iBAAiB;IAWzB,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,IAAI,IAAI;CAMhB"}
@@ -0,0 +1,59 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.ReconnectManager = void 0;
4
+ // 서버 연결 상태 관리 + exponential backoff 재연결
5
+ const HttpClient_js_1 = require("./HttpClient.js");
6
+ class ReconnectManager {
7
+ isServerUp = true;
8
+ retryDelayMs = 1000;
9
+ maxRetryDelayMs = 5 * 60 * 1000; // 최대 5분
10
+ reconnectTimer = null;
11
+ onReconnect;
12
+ constructor(onReconnect) {
13
+ this.onReconnect = onReconnect;
14
+ }
15
+ // 전송 결과를 보고받아 상태 업데이트
16
+ reportResult(result) {
17
+ if (result.success) {
18
+ if (!this.isServerUp) {
19
+ console.log('Ward 서버 연결이 복구되었습니다.');
20
+ }
21
+ this.isServerUp = true;
22
+ this.retryDelayMs = 1000; // 성공 시 backoff 리셋
23
+ if (this.reconnectTimer) {
24
+ clearTimeout(this.reconnectTimer);
25
+ this.reconnectTimer = null;
26
+ }
27
+ }
28
+ else if (result.errorType === HttpClient_js_1.SendErrorType.CONNECTION_REFUSED ||
29
+ result.errorType === HttpClient_js_1.SendErrorType.TIMEOUT) {
30
+ if (this.isServerUp) {
31
+ console.warn(`Ward 서버 연결 끊김. ${this.retryDelayMs / 1000}초 후 재시도...`);
32
+ this.isServerUp = false;
33
+ }
34
+ this.scheduleReconnect();
35
+ }
36
+ }
37
+ scheduleReconnect() {
38
+ if (this.reconnectTimer)
39
+ return;
40
+ this.reconnectTimer = setTimeout(async () => {
41
+ this.reconnectTimer = null;
42
+ console.log('Ward 서버 재연결 시도 중...');
43
+ await this.onReconnect().catch(() => { });
44
+ // 실패 시 다음 backoff 간격으로 재시도
45
+ this.retryDelayMs = Math.min(this.retryDelayMs * 2, this.maxRetryDelayMs);
46
+ }, this.retryDelayMs);
47
+ }
48
+ get serverAvailable() {
49
+ return this.isServerUp;
50
+ }
51
+ destroy() {
52
+ if (this.reconnectTimer) {
53
+ clearTimeout(this.reconnectTimer);
54
+ this.reconnectTimer = null;
55
+ }
56
+ }
57
+ }
58
+ exports.ReconnectManager = ReconnectManager;
59
+ //# sourceMappingURL=ReconnectManager.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ReconnectManager.js","sourceRoot":"","sources":["../../src/transport/ReconnectManager.ts"],"names":[],"mappings":";;;AAAA,wCAAwC;AACxC,mDAA4D;AAE5D,MAAa,gBAAgB;IACnB,UAAU,GAAG,IAAI,CAAC;IAClB,YAAY,GAAG,IAAI,CAAC;IACX,eAAe,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,QAAQ;IAClD,cAAc,GAAyC,IAAI,CAAC;IAC5D,WAAW,CAAsB;IAEzC,YAAY,WAAgC;QAC1C,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACjC,CAAC;IAED,sBAAsB;IACtB,YAAY,CAAC,MAAkB;QAC7B,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBACrB,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YACtC,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,kBAAkB;YAC5C,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBAClC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC7B,CAAC;QACH,CAAC;aAAM,IACL,MAAM,CAAC,SAAS,KAAK,6BAAa,CAAC,kBAAkB;YACrD,MAAM,CAAC,SAAS,KAAK,6BAAa,CAAC,OAAO,EAC1C,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,OAAO,CAAC,IAAI,CAAC,kBAAkB,IAAI,CAAC,YAAY,GAAG,IAAI,YAAY,CAAC,CAAC;gBACrE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,CAAC;IACH,CAAC;IAEO,iBAAiB;QACvB,IAAI,IAAI,CAAC,cAAc;YAAE,OAAO;QAChC,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;YAC1C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;YACnC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACzC,2BAA2B;YAC3B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAC5E,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAClC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;CACF;AAxDD,4CAwDC"}
@@ -0,0 +1,35 @@
1
+ export interface LogEntry {
2
+ source: string;
3
+ level: string;
4
+ message: string;
5
+ loggedAt: string;
6
+ }
7
+ export interface MetricsPayload {
8
+ collectedAt: string;
9
+ cpu: {
10
+ usage: number;
11
+ loadAvg: number[];
12
+ };
13
+ memory: {
14
+ total: number;
15
+ used: number;
16
+ free: number;
17
+ };
18
+ disk: Record<string, {
19
+ total: number;
20
+ used: number;
21
+ free: number;
22
+ }>;
23
+ network: Record<string, {
24
+ rx: number;
25
+ tx: number;
26
+ }>;
27
+ processes: Array<{
28
+ pid: number;
29
+ name: string;
30
+ cpu: number;
31
+ memory: number;
32
+ status: string;
33
+ }>;
34
+ }
35
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAC1C,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,SAAS,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9F"}
@@ -0,0 +1,3 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}
package/package.json ADDED
@@ -0,0 +1,41 @@
1
+ {
2
+ "name": "@devskeo/ward-agent",
3
+ "version": "1.0.0",
4
+ "license": "MIT",
5
+ "description": "Ward 서버 모니터링 에이전트",
6
+ "main": "dist/index.js",
7
+ "bin": {
8
+ "ward": "dist/index.js"
9
+ },
10
+ "files": [
11
+ "dist"
12
+ ],
13
+ "publishConfig": {
14
+ "access": "public"
15
+ },
16
+ "scripts": {
17
+ "dev": "tsx watch src/index.ts",
18
+ "dev:monitor": "tsx watch src/start-dev.ts",
19
+ "build": "tsc -p tsconfig.json",
20
+ "start": "node dist/index.js",
21
+ "start:self": "node dist/start-self.js",
22
+ "test": "vitest run",
23
+ "test:watch": "vitest",
24
+ "test:coverage": "vitest run --coverage",
25
+ "lint": "eslint src"
26
+ },
27
+ "dependencies": {
28
+ "commander": "^12.1.0",
29
+ "js-yaml": "^4.1.1",
30
+ "pidusage": "^4.0.1",
31
+ "systeminformation": "^5.31.4"
32
+ },
33
+ "devDependencies": {
34
+ "@types/js-yaml": "^4.0.9",
35
+ "@types/node": "^22.19.15",
36
+ "@types/pidusage": "^2.0.5",
37
+ "@vitest/coverage-v8": "^2.1.9",
38
+ "tsx": "^4.21.0",
39
+ "vitest": "^2.1.9"
40
+ }
41
+ }