Few changes:

- Remove deprecated aliases: FetchWrapper and FetchMiddleware
- Rename applyMiddleware to applyMiddlewares
- Ignore lint errors because of `console` usage adding a warning to the JSDoc

Author: m-paternostro

src/client/middleware.test.ts

@@ -1,8 +1,8 @@
 import {
-  withOAuth,
-  withLogging,
-  applyMiddleware,
-  createMiddleware,
+    withOAuth,
+    withLogging,
+    applyMiddlewares,
+    createMiddleware,
 } from "./middleware.js";
 import { OAuthClientProvider } from "./auth.js";
 import { FetchLike } from "../shared/transport.js";
@@ -677,7 +677,7 @@ describe("applyMiddleware", () => {
     const response = new Response("success", { status: 200 });
     mockFetch.mockResolvedValue(response);
 
-    const composedFetch = applyMiddleware()(mockFetch);
+    const composedFetch = applyMiddlewares()(mockFetch);
 
     expect(composedFetch).toBe(mockFetch);
   });
@@ -694,7 +694,7 @@ describe("applyMiddleware", () => {
         return next(input, { ...init, headers });
       };
 
-    const composedFetch = applyMiddleware(middleware1)(mockFetch);
+    const composedFetch = applyMiddlewares(middleware1)(mockFetch);
 
     await composedFetch("https://api.example.com/data");
 
@@ -736,7 +736,7 @@ describe("applyMiddleware", () => {
         return next(input, { ...init, headers });
       };
 
-    const composedFetch = applyMiddleware(
+    const composedFetch = applyMiddlewares(
       middleware1,
       middleware2,
       middleware3,
@@ -765,7 +765,7 @@ describe("applyMiddleware", () => {
 
     // Use custom logger to avoid console output
     const mockLogger = jest.fn();
-    const composedFetch = applyMiddleware(
+    const composedFetch = applyMiddlewares(
       oauthMiddleware,
       withLogging({ logger: mockLogger, statusLevel: 0 }),
     )(mockFetch);
@@ -803,7 +803,7 @@ describe("applyMiddleware", () => {
     const originalError = new Error("Network failure");
     mockFetch.mockRejectedValue(originalError);
 
-    const composedFetch = applyMiddleware(errorMiddleware)(mockFetch);
+    const composedFetch = applyMiddlewares(errorMiddleware)(mockFetch);
 
     await expect(composedFetch("https://api.example.com/data")).rejects.toThrow(
       "Middleware error: Network failure",
@@ -853,7 +853,7 @@ describe("Integration Tests", () => {
 
     // Use custom logger to avoid console output
     const mockLogger = jest.fn();
-    const enhancedFetch = applyMiddleware(
+    const enhancedFetch = applyMiddlewares(
       withOAuth(
         mockProvider as OAuthClientProvider,
         "https://mcp-server.example.com",
@@ -903,7 +903,7 @@ describe("Integration Tests", () => {
 
     // Use custom logger to avoid console output
     const mockLogger = jest.fn();
-    const enhancedFetch = applyMiddleware(
+    const enhancedFetch = applyMiddlewares(
       withOAuth(
         mockProvider as OAuthClientProvider,
         "https://streamable-server.example.com",
@@ -971,7 +971,7 @@ describe("Integration Tests", () => {
 
     // Use custom logger to avoid console output
     const mockLogger = jest.fn();
-    const enhancedFetch = applyMiddleware(
+    const enhancedFetch = applyMiddlewares(
       withOAuth(
         mockProvider as OAuthClientProvider,
         "https://mcp-server.example.com",
@@ -1177,7 +1177,7 @@ describe("createMiddleware", () => {
     });
 
     // Compose with existing middleware
-    const enhancedFetch = applyMiddleware(
+    const enhancedFetch = applyMiddlewares(
       customAuth,
       customLogging,
       withLogging({ statusLevel: 400 }),

src/client/middleware.ts

@@ -12,16 +12,6 @@ import { FetchLike } from "../shared/transport.js";
  */
 export type Middleware = (next: FetchLike) => FetchLike;
 
-/**
- * @deprecated Use Middleware instead
- */
-export type FetchWrapper = Middleware;
-
-/**
- * @deprecated Use Middleware instead
- */
-export type FetchMiddleware = Middleware;
-
 /**
  * Creates a fetch wrapper that handles OAuth authentication automatically.
  *
@@ -163,12 +153,15 @@ export type LoggingOptions = {
  * Creates a fetch middleware that logs HTTP requests and responses.
  *
  * When called without arguments `withLogging()`, it uses the default logger that:
- * - Logs successful requests (2xx) to console.log
- * - Logs error responses (4xx/5xx) and network errors to console.error
+ * - Logs successful requests (2xx) to `console.log`
+ * - Logs error responses (4xx/5xx) and network errors to `console.error`
  * - Logs all requests regardless of status (statusLevel: 0)
  * - Does not include request or response headers in logs
  * - Measures and displays request duration in milliseconds
  *
+ * Important: the default logger uses both `console.log` and `console.error` so it should not be used with
+ * `stdio` transports and applications.
+ *
  * @param options - Logging configuration options
  * @returns A fetch middleware function
  */
@@ -212,8 +205,10 @@ export const withLogging = (options: LoggingOptions = {}): Middleware => {
     }
 
     if (error || status >= 400) {
+      // eslint-disable-next-line no-console
       console.error(message);
     } else {
+      // eslint-disable-next-line no-console
       console.log(message);
     }
   };
@@ -274,7 +269,7 @@ export const withLogging = (options: LoggingOptions = {}): Middleware => {
  * @example
  * ```typescript
  * // Create a middleware pipeline that handles both OAuth and logging
- * const enhancedFetch = applyMiddleware(
+ * const enhancedFetch = applyMiddlewares(
  *   withOAuth(oauthProvider, 'https://api.example.com'),
  *   withLogging({ statusLevel: 400 })
  * )(fetch);
@@ -286,7 +281,7 @@ export const withLogging = (options: LoggingOptions = {}): Middleware => {
  * @param middleware - Array of fetch middleware to compose into a pipeline
  * @returns A single composed middleware function
  */
-export const applyMiddleware = (
+export const applyMiddlewares = (
   ...middleware: Middleware[]
 ): Middleware => {
   return (next) => {