@fetchmax/plugin-logger 1.0.0

package/dist/index.cjs

@@ -0,0 +1,200 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default,
+  loggerPlugin: () => loggerPlugin
+});
+module.exports = __toCommonJS(index_exports);
+function loggerPlugin(config = {}) {
+  const {
+    logRequests = true,
+    logResponses = true,
+    logErrors = true,
+    verbose = false,
+    colors = true,
+    filter,
+    logger = console
+  } = config;
+  const emoji = {
+    request: "\u{1F680}",
+    success: "\u2705",
+    error: "\u274C",
+    redirect: "\u21AA\uFE0F",
+    info: "\u2139\uFE0F",
+    warning: "\u26A0\uFE0F"
+  };
+  function shouldLog(request) {
+    return !filter || filter(request);
+  }
+  function formatDuration(ms) {
+    if (ms < 1e3) return `${ms.toFixed(0)}ms`;
+    return `${(ms / 1e3).toFixed(2)}s`;
+  }
+  function formatBytes(bytes) {
+    if (bytes === 0) return "0 B";
+    const k = 1024;
+    const sizes = ["B", "KB", "MB", "GB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
+  }
+  function getStatusColor(status) {
+    if (!colors) return "";
+    if (status >= 200 && status < 300) return "\x1B[32m";
+    if (status >= 300 && status < 400) return "\x1B[36m";
+    if (status >= 400 && status < 500) return "\x1B[33m";
+    if (status >= 500) return "\x1B[31m";
+    return "\x1B[0m";
+  }
+  const resetColor = colors ? "\x1B[0m" : "";
+  const boldColor = colors ? "\x1B[1m" : "";
+  return {
+    name: "logger",
+    async onRequest(request, _context) {
+      request.__startTime = Date.now();
+      if (!logRequests || !shouldLog(request)) {
+        request.__skipLogging = true;
+        return request;
+      }
+      const method = request.method?.toUpperCase() || "GET";
+      const url = request.url || "";
+      if (logger.group) {
+        logger.group(`${emoji.request} ${boldColor}${method}${resetColor} ${url}`);
+      } else {
+        logger.log(`${emoji.request} ${boldColor}${method}${resetColor} ${url}`);
+      }
+      if (verbose) {
+        if (request.headers && Object.keys(request.headers).length > 0) {
+          logger.log("  Headers:", request.headers);
+        }
+        if (request.params && Object.keys(request.params).length > 0) {
+          logger.log("  Params:", request.params);
+        }
+        if (request.body) {
+          logger.log("  Body:", request.body);
+        }
+      }
+      if (logger.groupEnd) {
+        logger.groupEnd();
+      }
+      return request;
+    },
+    async onResponse(response, request, _context) {
+      if (request.__skipLogging) {
+        return response;
+      }
+      if (!logResponses || !shouldLog(request)) {
+        return response;
+      }
+      const duration = Date.now() - (request.__startTime || Date.now());
+      const method = request.method?.toUpperCase() || "GET";
+      const url = request.url || "";
+      const status = response.status;
+      const statusColor = getStatusColor(status);
+      let icon = emoji.success;
+      if (status >= 300 && status < 400) icon = emoji.redirect;
+      else if (status >= 400) icon = emoji.error;
+      const statusText = `${statusColor}${status} ${response.statusText}${resetColor}`;
+      const durationText = formatDuration(duration);
+      if (logger.group) {
+        logger.group(
+          `${icon} ${statusText} ${boldColor}${method}${resetColor} ${url} ${emoji.info} ${durationText}`
+        );
+      } else {
+        logger.log(
+          `${icon} ${statusText} ${boldColor}${method}${resetColor} ${url} ${emoji.info} ${durationText}`
+        );
+      }
+      if (verbose) {
+        logger.log("  Status:", status, response.statusText);
+        const headers = {};
+        response.headers.forEach((value, key) => {
+          headers[key] = value;
+        });
+        if (Object.keys(headers).length > 0) {
+          logger.log("  Headers:", headers);
+        }
+        const contentLength = response.headers.get("content-length");
+        if (contentLength) {
+          logger.log("  Size:", formatBytes(parseInt(contentLength, 10)));
+        }
+        if (response.data) {
+          const dataStr = JSON.stringify(response.data);
+          if (dataStr.length > 1e3) {
+            logger.log("  Data:", dataStr.substring(0, 1e3) + "... (truncated)");
+          } else {
+            logger.log("  Data:", response.data);
+          }
+        }
+      }
+      if (logger.groupEnd) {
+        logger.groupEnd();
+      }
+      return response;
+    },
+    async onError(error, request, _context) {
+      if (request.__skipLogging) {
+        throw error;
+      }
+      if (!logErrors || !shouldLog(request)) {
+        throw error;
+      }
+      const duration = Date.now() - (request.__startTime || Date.now());
+      const method = request.method?.toUpperCase() || "GET";
+      const url = request.url || "";
+      const durationText = formatDuration(duration);
+      const statusText = error.status ? `${getStatusColor(error.status)}${error.status} ${error.statusText}${resetColor}` : `${emoji.error} ERROR`;
+      if (logger.group) {
+        logger.group(
+          `${emoji.error} ${statusText} ${boldColor}${method}${resetColor} ${url} ${emoji.info} ${durationText}`
+        );
+      } else {
+        logger.error(
+          `${emoji.error} ${statusText} ${boldColor}${method}${resetColor} ${url} ${emoji.info} ${durationText}`
+        );
+      }
+      logger.error("  Error:", error.message);
+      if (verbose) {
+        if (error.code) {
+          logger.error("  Code:", error.code);
+        }
+        if (error.data) {
+          logger.error("  Data:", error.data);
+        }
+        if (error.stack) {
+          logger.error("  Stack:", error.stack);
+        }
+        if (error.config) {
+          logger.error("  Config:", error.config);
+        }
+      }
+      if (logger.groupEnd) {
+        logger.groupEnd();
+      }
+      throw error;
+    }
+  };
+}
+var index_default = loggerPlugin;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loggerPlugin
+});

package/dist/index.d.cts

@@ -0,0 +1,39 @@
+import { Plugin } from '@fetchmax/core';
+
+interface LoggerConfig {
+    /** Log requests (default: true) */
+    logRequests?: boolean;
+    /** Log responses (default: true) */
+    logResponses?: boolean;
+    /** Log errors (default: true) */
+    logErrors?: boolean;
+    /** Show detailed information (default: false) */
+    verbose?: boolean;
+    /** Use colors in console output (default: true) */
+    colors?: boolean;
+    /** Filter function to determine which requests to log */
+    filter?: (request: any) => boolean;
+    /** Custom logger function */
+    logger?: {
+        log: (...args: any[]) => void;
+        error: (...args: any[]) => void;
+        group?: (...args: any[]) => void;
+        groupEnd?: () => void;
+    };
+}
+/**
+ * Logger Plugin
+ *
+ * Logs HTTP requests, responses, and errors to the console for debugging.
+ *
+ * @example
+ * ```ts
+ * const client = new HttpClient().use(loggerPlugin({
+ *   verbose: true,
+ *   filter: (request) => !request.url.includes('/health')
+ * }));
+ * ```
+ */
+declare function loggerPlugin(config?: LoggerConfig): Plugin;
+
+export { type LoggerConfig, loggerPlugin as default, loggerPlugin };

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { Plugin } from '@fetchmax/core';
+
+interface LoggerConfig {
+    /** Log requests (default: true) */
+    logRequests?: boolean;
+    /** Log responses (default: true) */
+    logResponses?: boolean;
+    /** Log errors (default: true) */
+    logErrors?: boolean;
+    /** Show detailed information (default: false) */
+    verbose?: boolean;
+    /** Use colors in console output (default: true) */
+    colors?: boolean;
+    /** Filter function to determine which requests to log */
+    filter?: (request: any) => boolean;
+    /** Custom logger function */
+    logger?: {
+        log: (...args: any[]) => void;
+        error: (...args: any[]) => void;
+        group?: (...args: any[]) => void;
+        groupEnd?: () => void;
+    };
+}
+/**
+ * Logger Plugin
+ *
+ * Logs HTTP requests, responses, and errors to the console for debugging.
+ *
+ * @example
+ * ```ts
+ * const client = new HttpClient().use(loggerPlugin({
+ *   verbose: true,
+ *   filter: (request) => !request.url.includes('/health')
+ * }));
+ * ```
+ */
+declare function loggerPlugin(config?: LoggerConfig): Plugin;
+
+export { type LoggerConfig, loggerPlugin as default, loggerPlugin };

package/dist/index.js

@@ -0,0 +1,175 @@
+// src/index.ts
+function loggerPlugin(config = {}) {
+  const {
+    logRequests = true,
+    logResponses = true,
+    logErrors = true,
+    verbose = false,
+    colors = true,
+    filter,
+    logger = console
+  } = config;
+  const emoji = {
+    request: "\u{1F680}",
+    success: "\u2705",
+    error: "\u274C",
+    redirect: "\u21AA\uFE0F",
+    info: "\u2139\uFE0F",
+    warning: "\u26A0\uFE0F"
+  };
+  function shouldLog(request) {
+    return !filter || filter(request);
+  }
+  function formatDuration(ms) {
+    if (ms < 1e3) return `${ms.toFixed(0)}ms`;
+    return `${(ms / 1e3).toFixed(2)}s`;
+  }
+  function formatBytes(bytes) {
+    if (bytes === 0) return "0 B";
+    const k = 1024;
+    const sizes = ["B", "KB", "MB", "GB"];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return `${(bytes / Math.pow(k, i)).toFixed(2)} ${sizes[i]}`;
+  }
+  function getStatusColor(status) {
+    if (!colors) return "";
+    if (status >= 200 && status < 300) return "\x1B[32m";
+    if (status >= 300 && status < 400) return "\x1B[36m";
+    if (status >= 400 && status < 500) return "\x1B[33m";
+    if (status >= 500) return "\x1B[31m";
+    return "\x1B[0m";
+  }
+  const resetColor = colors ? "\x1B[0m" : "";
+  const boldColor = colors ? "\x1B[1m" : "";
+  return {
+    name: "logger",
+    async onRequest(request, _context) {
+      request.__startTime = Date.now();
+      if (!logRequests || !shouldLog(request)) {
+        request.__skipLogging = true;
+        return request;
+      }
+      const method = request.method?.toUpperCase() || "GET";
+      const url = request.url || "";
+      if (logger.group) {
+        logger.group(`${emoji.request} ${boldColor}${method}${resetColor} ${url}`);
+      } else {
+        logger.log(`${emoji.request} ${boldColor}${method}${resetColor} ${url}`);
+      }
+      if (verbose) {
+        if (request.headers && Object.keys(request.headers).length > 0) {
+          logger.log("  Headers:", request.headers);
+        }
+        if (request.params && Object.keys(request.params).length > 0) {
+          logger.log("  Params:", request.params);
+        }
+        if (request.body) {
+          logger.log("  Body:", request.body);
+        }
+      }
+      if (logger.groupEnd) {
+        logger.groupEnd();
+      }
+      return request;
+    },
+    async onResponse(response, request, _context) {
+      if (request.__skipLogging) {
+        return response;
+      }
+      if (!logResponses || !shouldLog(request)) {
+        return response;
+      }
+      const duration = Date.now() - (request.__startTime || Date.now());
+      const method = request.method?.toUpperCase() || "GET";
+      const url = request.url || "";
+      const status = response.status;
+      const statusColor = getStatusColor(status);
+      let icon = emoji.success;
+      if (status >= 300 && status < 400) icon = emoji.redirect;
+      else if (status >= 400) icon = emoji.error;
+      const statusText = `${statusColor}${status} ${response.statusText}${resetColor}`;
+      const durationText = formatDuration(duration);
+      if (logger.group) {
+        logger.group(
+          `${icon} ${statusText} ${boldColor}${method}${resetColor} ${url} ${emoji.info} ${durationText}`
+        );
+      } else {
+        logger.log(
+          `${icon} ${statusText} ${boldColor}${method}${resetColor} ${url} ${emoji.info} ${durationText}`
+        );
+      }
+      if (verbose) {
+        logger.log("  Status:", status, response.statusText);
+        const headers = {};
+        response.headers.forEach((value, key) => {
+          headers[key] = value;
+        });
+        if (Object.keys(headers).length > 0) {
+          logger.log("  Headers:", headers);
+        }
+        const contentLength = response.headers.get("content-length");
+        if (contentLength) {
+          logger.log("  Size:", formatBytes(parseInt(contentLength, 10)));
+        }
+        if (response.data) {
+          const dataStr = JSON.stringify(response.data);
+          if (dataStr.length > 1e3) {
+            logger.log("  Data:", dataStr.substring(0, 1e3) + "... (truncated)");
+          } else {
+            logger.log("  Data:", response.data);
+          }
+        }
+      }
+      if (logger.groupEnd) {
+        logger.groupEnd();
+      }
+      return response;
+    },
+    async onError(error, request, _context) {
+      if (request.__skipLogging) {
+        throw error;
+      }
+      if (!logErrors || !shouldLog(request)) {
+        throw error;
+      }
+      const duration = Date.now() - (request.__startTime || Date.now());
+      const method = request.method?.toUpperCase() || "GET";
+      const url = request.url || "";
+      const durationText = formatDuration(duration);
+      const statusText = error.status ? `${getStatusColor(error.status)}${error.status} ${error.statusText}${resetColor}` : `${emoji.error} ERROR`;
+      if (logger.group) {
+        logger.group(
+          `${emoji.error} ${statusText} ${boldColor}${method}${resetColor} ${url} ${emoji.info} ${durationText}`
+        );
+      } else {
+        logger.error(
+          `${emoji.error} ${statusText} ${boldColor}${method}${resetColor} ${url} ${emoji.info} ${durationText}`
+        );
+      }
+      logger.error("  Error:", error.message);
+      if (verbose) {
+        if (error.code) {
+          logger.error("  Code:", error.code);
+        }
+        if (error.data) {
+          logger.error("  Data:", error.data);
+        }
+        if (error.stack) {
+          logger.error("  Stack:", error.stack);
+        }
+        if (error.config) {
+          logger.error("  Config:", error.config);
+        }
+      }
+      if (logger.groupEnd) {
+        logger.groupEnd();
+      }
+      throw error;
+    }
+  };
+}
+var index_default = loggerPlugin;
+export {
+  index_default as default,
+  loggerPlugin
+};

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@fetchmax/plugin-logger",
+  "version": "1.0.0",
+  "description": "Logger plugin for FetchMax with detailed request/response logging",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch"
+  },
+  "keywords": [
+    "fetchmax",
+    "plugin",
+    "logger",
+    "logging",
+    "debug",
+    "http",
+    "fetch"
+  ],
+  "author": "FetchMax Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fetchmax/fetchmax.git",
+    "directory": "packages/plugins/logger"
+  },
+  "bugs": {
+    "url": "https://github.com/fetchmax/fetchmax/issues"
+  },
+  "homepage": "https://github.com/fetchmax/fetchmax#readme",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "@fetchmax/core": "^1.0.0"
+  },
+  "devDependencies": {
+    "@fetchmax/core": "*",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  }
+}