@arabold/docs-mcp-server 2.0.4 → 2.1.1

package/dist/logger-CLtABTNb.js

@@ -0,0 +1,99 @@
+function normalizeEnvValue(value) {
+  const trimmed = value.trim();
+  if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
+    return trimmed.slice(1, -1);
+  }
+  return trimmed;
+}
+function sanitizeEnvironment(env = process.env) {
+  const sanitizedKeys = [];
+  for (const [key, value] of Object.entries(env)) {
+    if (value === void 0) {
+      continue;
+    }
+    const normalized = normalizeEnvValue(value);
+    if (normalized !== value) {
+      env[key] = normalized;
+      sanitizedKeys.push(key);
+    }
+  }
+  return sanitizedKeys;
+}
+const LogLevel = {
+  ERROR: 0,
+  WARN: 1,
+  INFO: 2,
+  DEBUG: 3
+};
+const LOG_LEVEL_MAP = {
+  ERROR: LogLevel.ERROR,
+  WARN: LogLevel.WARN,
+  INFO: LogLevel.INFO,
+  DEBUG: LogLevel.DEBUG
+};
+function suppressLogsInTests() {
+  return !!process.env.VITEST_WORKER_ID && process.env.ENABLE_TEST_LOGS !== "1";
+}
+function isInteractiveSession() {
+  return !!process.stdout.isTTY && !!process.stderr.isTTY;
+}
+function writeToStderr(message) {
+  process.stderr.write(message.endsWith("\n") ? message : `${message}
+`);
+}
+function getLogLevelFromEnv() {
+  const envLevel = process.env.LOG_LEVEL?.toUpperCase();
+  return envLevel && envLevel in LOG_LEVEL_MAP ? LOG_LEVEL_MAP[envLevel] : null;
+}
+let currentLogLevel = getLogLevelFromEnv() ?? (isInteractiveSession() ? LogLevel.INFO : LogLevel.ERROR);
+function setLogLevel(level) {
+  currentLogLevel = level;
+}
+const logger = {
+  /**
+   * Logs a debug message if the current log level is DEBUG or higher.
+   * @param message - The message to log.
+   */
+  debug: (message) => {
+    if (currentLogLevel >= LogLevel.DEBUG && !suppressLogsInTests()) {
+      writeToStderr(message);
+    }
+  },
+  /**
+   * Logs an info message if the current log level is INFO or higher.
+   * @param message - The message to log.
+   */
+  info: (message) => {
+    if (currentLogLevel >= LogLevel.INFO && !suppressLogsInTests()) {
+      writeToStderr(message);
+    }
+  },
+  /**
+   * Logs a warning message if the current log level is WARN or higher.
+   * @param message - The message to log.
+   */
+  warn: (message) => {
+    if (currentLogLevel >= LogLevel.WARN && !suppressLogsInTests()) {
+      writeToStderr(message);
+    }
+  },
+  /**
+   * Logs an error message if the current log level is ERROR or higher.
+   * Suppressed during test runs unless `ENABLE_TEST_LOGS=1` is set.
+   * @param message - The message to log.
+   */
+  error: (message) => {
+    if (currentLogLevel >= LogLevel.ERROR && !suppressLogsInTests()) {
+      writeToStderr(message);
+    }
+  }
+};
+export {
+  LogLevel as L,
+  setLogLevel as a,
+  getLogLevelFromEnv as g,
+  logger as l,
+  normalizeEnvValue as n,
+  sanitizeEnvironment as s
+};
+//# sourceMappingURL=logger-CLtABTNb.js.map

package/dist/logger-CLtABTNb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-CLtABTNb.js","sources":["../src/utils/env.ts","../src/utils/logger.ts"],"sourcesContent":["/**\n * Normalize a single environment variable value by trimming surrounding whitespace\n * and removing matching outer quotes. Internal quotes are preserved.\n */\nexport function normalizeEnvValue(value: string): string {\n  const trimmed = value.trim();\n  if (\n    (trimmed.startsWith('\"') && trimmed.endsWith('\"')) ||\n    (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\"))\n  ) {\n    return trimmed.slice(1, -1);\n  }\n  return trimmed;\n}\n\n/**\n * Normalize all string values in process.env in place.\n * Returns the names of environment variables that changed.\n */\nexport function sanitizeEnvironment(env: NodeJS.ProcessEnv = process.env): string[] {\n  const sanitizedKeys: string[] = [];\n\n  for (const [key, value] of Object.entries(env)) {\n    if (value === undefined) {\n      continue;\n    }\n\n    const normalized = normalizeEnvValue(value);\n    if (normalized !== value) {\n      env[key] = normalized;\n      sanitizedKeys.push(key);\n    }\n  }\n\n  return sanitizedKeys;\n}\n","/**\n * Defines the available log levels.\n */\nexport const LogLevel = {\n  ERROR: 0,\n  WARN: 1,\n  INFO: 2,\n  DEBUG: 3,\n} as const;\n\nexport type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];\n\n/**\n * Maps string log level names to their numeric values.\n */\nconst LOG_LEVEL_MAP: Record<string, LogLevel> = {\n  ERROR: LogLevel.ERROR,\n  WARN: LogLevel.WARN,\n  INFO: LogLevel.INFO,\n  DEBUG: LogLevel.DEBUG,\n};\n\nfunction suppressLogsInTests(): boolean {\n  return !!process.env.VITEST_WORKER_ID && process.env.ENABLE_TEST_LOGS !== \"1\";\n}\n\nfunction isInteractiveSession(): boolean {\n  return !!process.stdout.isTTY && !!process.stderr.isTTY;\n}\n\nfunction writeToStderr(message: string): void {\n  process.stderr.write(message.endsWith(\"\\n\") ? message : `${message}\\n`);\n}\n\n/**\n * Gets the log level from the `LOG_LEVEL` environment variable.\n * Returns the matching {@link LogLevel} value, or `null` if the variable\n * is unset or contains an unrecognised value.\n */\nexport function getLogLevelFromEnv(): LogLevel | null {\n  const envLevel = process.env.LOG_LEVEL?.toUpperCase();\n  return envLevel && envLevel in LOG_LEVEL_MAP ? LOG_LEVEL_MAP[envLevel] : null;\n}\n\nlet currentLogLevel: LogLevel =\n  getLogLevelFromEnv() ?? (isInteractiveSession() ? LogLevel.INFO : LogLevel.ERROR);\n\n/**\n * Sets the current logging level for the application.\n */\nexport function setLogLevel(level: LogLevel): void {\n  currentLogLevel = level;\n}\n\n/**\n * Returns the current logging level for the application.\n */\nexport function getLogLevel(): LogLevel {\n  return currentLogLevel;\n}\n\n/**\n * Provides logging functionalities with level control.\n */\nexport const logger = {\n  /**\n   * Logs a debug message if the current log level is DEBUG or higher.\n   * @param message - The message to log.\n   */\n  debug: (message: string) => {\n    if (currentLogLevel >= LogLevel.DEBUG && !suppressLogsInTests()) {\n      writeToStderr(message);\n    }\n  },\n  /**\n   * Logs an info message if the current log level is INFO or higher.\n   * @param message - The message to log.\n   */\n  info: (message: string) => {\n    if (currentLogLevel >= LogLevel.INFO && !suppressLogsInTests()) {\n      writeToStderr(message);\n    }\n  },\n  /**\n   * Logs a warning message if the current log level is WARN or higher.\n   * @param message - The message to log.\n   */\n  warn: (message: string) => {\n    if (currentLogLevel >= LogLevel.WARN && !suppressLogsInTests()) {\n      writeToStderr(message);\n    }\n  },\n  /**\n   * Logs an error message if the current log level is ERROR or higher.\n   * Suppressed during test runs unless `ENABLE_TEST_LOGS=1` is set.\n   * @param message - The message to log.\n   */\n  error: (message: string) => {\n    if (currentLogLevel >= LogLevel.ERROR && !suppressLogsInTests()) {\n      writeToStderr(message);\n    }\n  },\n};\n"],"names":[],"mappings":"AAIO,SAAS,kBAAkB,OAAuB;AACvD,QAAM,UAAU,MAAM,KAAA;AACtB,MACG,QAAQ,WAAW,GAAG,KAAK,QAAQ,SAAS,GAAG,KAC/C,QAAQ,WAAW,GAAG,KAAK,QAAQ,SAAS,GAAG,GAChD;AACA,WAAO,QAAQ,MAAM,GAAG,EAAE;AAAA,EAC5B;AACA,SAAO;AACT;AAMO,SAAS,oBAAoB,MAAyB,QAAQ,KAAe;AAClF,QAAM,gBAA0B,CAAA;AAEhC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC9C,QAAI,UAAU,QAAW;AACvB;AAAA,IACF;AAEA,UAAM,aAAa,kBAAkB,KAAK;AAC1C,QAAI,eAAe,OAAO;AACxB,UAAI,GAAG,IAAI;AACX,oBAAc,KAAK,GAAG;AAAA,IACxB;AAAA,EACF;AAEA,SAAO;AACT;AChCO,MAAM,WAAW;AAAA,EACtB,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AACT;AAOA,MAAM,gBAA0C;AAAA,EAC9C,OAAO,SAAS;AAAA,EAChB,MAAM,SAAS;AAAA,EACf,MAAM,SAAS;AAAA,EACf,OAAO,SAAS;AAClB;AAEA,SAAS,sBAA+B;AACtC,SAAO,CAAC,CAAC,QAAQ,IAAI,oBAAoB,QAAQ,IAAI,qBAAqB;AAC5E;AAEA,SAAS,uBAAgC;AACvC,SAAO,CAAC,CAAC,QAAQ,OAAO,SAAS,CAAC,CAAC,QAAQ,OAAO;AACpD;AAEA,SAAS,cAAc,SAAuB;AAC5C,UAAQ,OAAO,MAAM,QAAQ,SAAS,IAAI,IAAI,UAAU,GAAG,OAAO;AAAA,CAAI;AACxE;AAOO,SAAS,qBAAsC;AACpD,QAAM,WAAW,QAAQ,IAAI,WAAW,YAAA;AACxC,SAAO,YAAY,YAAY,gBAAgB,cAAc,QAAQ,IAAI;AAC3E;AAEA,IAAI,kBACF,mBAAA,MAAyB,yBAAyB,SAAS,OAAO,SAAS;AAKtE,SAAS,YAAY,OAAuB;AACjD,oBAAkB;AACpB;AAYO,MAAM,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA,EAKpB,OAAO,CAAC,YAAoB;AAC1B,QAAI,mBAAmB,SAAS,SAAS,CAAC,uBAAuB;AAC/D,oBAAc,OAAO;AAAA,IACvB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,CAAC,YAAoB;AACzB,QAAI,mBAAmB,SAAS,QAAQ,CAAC,uBAAuB;AAC9D,oBAAc,OAAO;AAAA,IACvB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,CAAC,YAAoB;AACzB,QAAI,mBAAmB,SAAS,QAAQ,CAAC,uBAAuB;AAC9D,oBAAc,OAAO;AAAA,IACvB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,CAAC,YAAoB;AAC1B,QAAI,mBAAmB,SAAS,SAAS,CAAC,uBAAuB;AAC/D,oBAAc,OAAO;AAAA,IACvB;AAAA,EACF;AACF;"}