@spfn/core 0.3.0-beta.4 → 0.3.0-beta.5

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.
@@ -1,4 +1,4 @@
1
- import { format } from 'util';
1
+ import { logger } from '@spfn/core/logger';
2
2
 
3
3
  var __defProp = Object.defineProperty;
4
4
  var __export = (target, all) => {
@@ -114,386 +114,6 @@ __export(http_errors_exports, {
114
114
  UnsupportedMediaTypeError: () => UnsupportedMediaTypeError,
115
115
  ValidationError: () => ValidationError
116
116
  });
117
-
118
- // src/logger/types.ts
119
- var LOG_LEVEL_PRIORITY = {
120
- debug: 0,
121
- info: 1,
122
- warn: 2,
123
- error: 3,
124
- fatal: 4
125
- };
126
-
127
- // src/logger/formatters.ts
128
- var SENSITIVE_KEYS = [
129
- "password",
130
- "passwd",
131
- "pwd",
132
- "secret",
133
- "token",
134
- "apikey",
135
- "api_key",
136
- "accesstoken",
137
- "access_token",
138
- "refreshtoken",
139
- "refresh_token",
140
- "authorization",
141
- "auth",
142
- "cookie",
143
- "session",
144
- "sessionid",
145
- "session_id",
146
- "privatekey",
147
- "private_key",
148
- "creditcard",
149
- "credit_card",
150
- "cardnumber",
151
- "card_number",
152
- "cvv",
153
- "ssn",
154
- "pin"
155
- ];
156
- var MASKED_VALUE = "***MASKED***";
157
- function isSensitiveKey(key) {
158
- const lowerKey = key.toLowerCase();
159
- return SENSITIVE_KEYS.some((sensitive) => lowerKey.includes(sensitive));
160
- }
161
- function maskSensitiveData(data, seen = /* @__PURE__ */ new WeakSet()) {
162
- if (data === null || data === void 0) {
163
- return data;
164
- }
165
- if (typeof data !== "object") {
166
- return data;
167
- }
168
- if (seen.has(data)) {
169
- return "[Circular]";
170
- }
171
- seen.add(data);
172
- if (Array.isArray(data)) {
173
- return data.map((item) => maskSensitiveData(item, seen));
174
- }
175
- const masked = {};
176
- for (const [key, value] of Object.entries(data)) {
177
- if (isSensitiveKey(key)) {
178
- masked[key] = MASKED_VALUE;
179
- } else if (typeof value === "object" && value !== null) {
180
- masked[key] = maskSensitiveData(value, seen);
181
- } else {
182
- masked[key] = value;
183
- }
184
- }
185
- return masked;
186
- }
187
- var COLORS = {
188
- reset: "\x1B[0m",
189
- bright: "\x1B[1m",
190
- dim: "\x1B[2m",
191
- // 로그 레벨 컬러
192
- debug: "\x1B[36m",
193
- // cyan
194
- info: "\x1B[32m",
195
- // green
196
- warn: "\x1B[33m",
197
- // yellow
198
- error: "\x1B[31m",
199
- // red
200
- fatal: "\x1B[35m",
201
- // magenta
202
- // 추가 컬러
203
- gray: "\x1B[90m"
204
- };
205
- function formatTimestampHuman(date) {
206
- const year = date.getFullYear();
207
- const month = String(date.getMonth() + 1).padStart(2, "0");
208
- const day = String(date.getDate()).padStart(2, "0");
209
- const hours = String(date.getHours()).padStart(2, "0");
210
- const minutes = String(date.getMinutes()).padStart(2, "0");
211
- const seconds = String(date.getSeconds()).padStart(2, "0");
212
- const ms = String(date.getMilliseconds()).padStart(3, "0");
213
- return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}.${ms}`;
214
- }
215
- function formatError(error) {
216
- const lines = [];
217
- lines.push(`${error.name}: ${error.message}`);
218
- if (error.stack) {
219
- const stackLines = error.stack.split("\n").slice(1);
220
- lines.push(...stackLines);
221
- }
222
- if (error.cause instanceof Error) {
223
- lines.push(`Caused by: ${formatError(error.cause)}`);
224
- } else if (error.cause !== void 0) {
225
- lines.push(`Caused by: ${String(error.cause)}`);
226
- }
227
- return lines.join("\n");
228
- }
229
- function formatConsole(metadata, colorize = true) {
230
- const parts = [];
231
- const timestamp = formatTimestampHuman(metadata.timestamp);
232
- if (colorize) {
233
- parts.push(`${COLORS.gray}[${timestamp}]${COLORS.reset}`);
234
- } else {
235
- parts.push(`[${timestamp}]`);
236
- }
237
- const pid = process.pid;
238
- if (colorize) {
239
- parts.push(`${COLORS.dim}[pid=${pid}]${COLORS.reset}`);
240
- } else {
241
- parts.push(`[pid=${pid}]`);
242
- }
243
- if (metadata.module) {
244
- if (colorize) {
245
- parts.push(`${COLORS.dim}[module=${metadata.module}]${COLORS.reset}`);
246
- } else {
247
- parts.push(`[module=${metadata.module}]`);
248
- }
249
- }
250
- if (metadata.context && Object.keys(metadata.context).length > 0) {
251
- Object.entries(metadata.context).forEach(([key, value]) => {
252
- let valueStr;
253
- if (typeof value === "string") {
254
- valueStr = value;
255
- } else if (typeof value === "object" && value !== null) {
256
- try {
257
- valueStr = JSON.stringify(value);
258
- } catch (error) {
259
- valueStr = "[circular]";
260
- }
261
- } else {
262
- valueStr = String(value);
263
- }
264
- if (colorize) {
265
- parts.push(`${COLORS.dim}[${key}=${valueStr}]${COLORS.reset}`);
266
- } else {
267
- parts.push(`[${key}=${valueStr}]`);
268
- }
269
- });
270
- }
271
- const levelStr = metadata.level.toUpperCase();
272
- if (colorize) {
273
- const color = COLORS[metadata.level];
274
- parts.push(`${color}(${levelStr})${COLORS.reset}:`);
275
- } else {
276
- parts.push(`(${levelStr}):`);
277
- }
278
- if (colorize) {
279
- parts.push(`${COLORS.bright}${metadata.message}${COLORS.reset}`);
280
- } else {
281
- parts.push(metadata.message);
282
- }
283
- let output = parts.join(" ");
284
- if (metadata.error) {
285
- output += "\n" + formatError(metadata.error);
286
- }
287
- return output;
288
- }
289
-
290
- // src/logger/logger.ts
291
- var FORMAT_PATTERN = /%[sdifjoOc%]/;
292
- var Logger = class _Logger {
293
- config;
294
- module;
295
- constructor(config) {
296
- this.config = config;
297
- this.module = config.module;
298
- }
299
- /**
300
- * Convert unknown error to Error object
301
- */
302
- toError(error) {
303
- if (error instanceof Error) return error;
304
- if (typeof error === "string") return new Error(error);
305
- if (typeof error === "object" && error !== null) {
306
- return new Error(JSON.stringify(error));
307
- }
308
- return new Error(String(error));
309
- }
310
- /**
311
- * Check if value is a context object (not an error)
312
- */
313
- isContext(value) {
314
- if (typeof value !== "object" || value === null) return false;
315
- if (value instanceof Error) return false;
316
- const hasStack = "stack" in value && typeof value.stack === "string";
317
- if (hasStack) {
318
- return false;
319
- }
320
- return true;
321
- }
322
- /**
323
- * Get current log level
324
- */
325
- get level() {
326
- return this.config.level;
327
- }
328
- /**
329
- * Create child logger (per module)
330
- */
331
- child(module) {
332
- return new _Logger({
333
- ...this.config,
334
- module
335
- });
336
- }
337
- /**
338
- * Common log method with error/context detection
339
- */
340
- logWithLevel(level, message, errorOrContext, context) {
341
- if (errorOrContext !== void 0 && FORMAT_PATTERN.test(message)) {
342
- this.log(level, format(message, errorOrContext), void 0, context);
343
- return;
344
- }
345
- if (errorOrContext instanceof Error) {
346
- this.log(level, message, errorOrContext, context);
347
- } else if (errorOrContext !== void 0 && typeof errorOrContext === "object" && !this.isContext(errorOrContext)) {
348
- this.log(level, message, this.toError(errorOrContext), context);
349
- } else if (typeof errorOrContext === "string" || typeof errorOrContext === "number" || typeof errorOrContext === "boolean") {
350
- this.log(level, message, this.toError(errorOrContext), context);
351
- } else {
352
- this.log(level, message, void 0, errorOrContext);
353
- }
354
- }
355
- debug(message, errorOrContext, context) {
356
- this.logWithLevel("debug", message, errorOrContext, context);
357
- }
358
- info(message, errorOrContext, context) {
359
- this.logWithLevel("info", message, errorOrContext, context);
360
- }
361
- warn(message, errorOrContext, context) {
362
- this.logWithLevel("warn", message, errorOrContext, context);
363
- }
364
- error(message, errorOrContext, context) {
365
- this.logWithLevel("error", message, errorOrContext, context);
366
- }
367
- fatal(message, errorOrContext, context) {
368
- this.logWithLevel("fatal", message, errorOrContext, context);
369
- }
370
- /**
371
- * Log processing (internal)
372
- */
373
- log(level, message, error, context) {
374
- if (LOG_LEVEL_PRIORITY[level] < LOG_LEVEL_PRIORITY[this.config.level]) {
375
- return;
376
- }
377
- const metadata = {
378
- timestamp: /* @__PURE__ */ new Date(),
379
- level,
380
- message,
381
- module: this.module,
382
- error,
383
- // Mask sensitive information in context to prevent credential leaks
384
- context: context ? maskSensitiveData(context) : void 0
385
- };
386
- this.processTransports(metadata);
387
- }
388
- /**
389
- * Process Transports
390
- */
391
- processTransports(metadata) {
392
- const promises = this.config.transports.filter((transport) => transport.enabled).map((transport) => this.safeTransportLog(transport, metadata));
393
- Promise.all(promises).catch((error) => {
394
- const errorMessage = error instanceof Error ? error.message : String(error);
395
- process.stderr.write(`[Logger] Transport error: ${errorMessage}
396
- `);
397
- });
398
- }
399
- /**
400
- * Transport log (error-safe)
401
- */
402
- async safeTransportLog(transport, metadata) {
403
- try {
404
- await transport.log(metadata);
405
- } catch (error) {
406
- const errorMessage = error instanceof Error ? error.message : String(error);
407
- process.stderr.write(`[Logger] Transport "${transport.name}" failed: ${errorMessage}
408
- `);
409
- }
410
- }
411
- /**
412
- * Close all Transports
413
- */
414
- async close() {
415
- const closePromises = this.config.transports.filter((transport) => transport.close).map((transport) => transport.close());
416
- await Promise.all(closePromises);
417
- }
418
- };
419
-
420
- // src/logger/transports/console.ts
421
- var ConsoleTransport = class {
422
- name = "console";
423
- level;
424
- enabled;
425
- colorize;
426
- constructor(config) {
427
- this.level = config.level;
428
- this.enabled = config.enabled;
429
- this.colorize = config.colorize ?? true;
430
- }
431
- async log(metadata) {
432
- if (!this.enabled) {
433
- return;
434
- }
435
- if (LOG_LEVEL_PRIORITY[metadata.level] < LOG_LEVEL_PRIORITY[this.level]) {
436
- return;
437
- }
438
- const message = formatConsole(metadata, this.colorize);
439
- if (metadata.level === "warn" || metadata.level === "error" || metadata.level === "fatal") {
440
- console.error(message);
441
- } else {
442
- console.log(message);
443
- }
444
- }
445
- };
446
-
447
- // src/logger/config.ts
448
- function getConsoleConfig() {
449
- const isProduction = process.env.NODE_ENV === "production";
450
- return {
451
- level: "debug",
452
- enabled: true,
453
- colorize: !isProduction
454
- // Dev: colored output, Production: plain text
455
- };
456
- }
457
- function validateEnvironment() {
458
- const nodeEnv = process.env.NODE_ENV;
459
- if (!nodeEnv) {
460
- process.stderr.write(
461
- "[Logger] Warning: NODE_ENV is not set. Defaulting to test environment.\n"
462
- );
463
- }
464
- }
465
- function validateConfig() {
466
- validateEnvironment();
467
- }
468
-
469
- // src/logger/factory.ts
470
- function initializeTransports() {
471
- const transports = [];
472
- const consoleConfig = getConsoleConfig();
473
- transports.push(new ConsoleTransport(consoleConfig));
474
- return transports;
475
- }
476
- function getLogLevel() {
477
- const envLevel = process.env.SPFN_LOG_LEVEL || process.env.NEXT_PUBLIC_SPFN_LOG_LEVEL || "info";
478
- if (envLevel in LOG_LEVEL_PRIORITY) {
479
- return envLevel;
480
- }
481
- process.stderr.write(
482
- `[Logger] Invalid log level "${envLevel}", defaulting to "info"
483
- `
484
- );
485
- return "info";
486
- }
487
- function initializeLogger() {
488
- validateConfig();
489
- return new Logger({
490
- level: getLogLevel(),
491
- transports: initializeTransports()
492
- });
493
- }
494
- var logger = initializeLogger();
495
-
496
- // src/errors/serializable-error.ts
497
117
  var RESERVED_RESPONSE_KEYS = /* @__PURE__ */ new Set(["__type", "message", "error"]);
498
118
  var AUTHORING_ENVIRONMENTS = /* @__PURE__ */ new Set(["local", "development", "test"]);
499
119
  function refuseReservedKey(className, key) {