@automattic/mcp-wordpress-remote 0.2.18 → 0.2.19

package/README.md

@@ -105,7 +105,7 @@ Custom headers are included in:
 
 ## WordPress MCP Plugin
 
-You need to install the [wordpress-mcp](https://github.com/Automattic/wordpress-mcp) plugin on your WordPress website and enable MCP Functionality in Settings > MCP Settings.
+You need to install the [wordpress-mcp](https://github.com/WordPress/mcp-adapter) plugin on your WordPress website and enable MCP Functionality in Settings > MCP Settings.
 
 ## Authentication Methods
 

package/dist/lib.d.ts

@@ -1,3 +1,6 @@
+import { SocksProxyAgent } from 'socks-proxy-agent';
+import { HttpsProxyAgent } from 'https-proxy-agent';
+
 /**
  * WordPress API request parameters
  */
@@ -12,7 +15,7 @@ interface WordPressResponse {
     [key: string]: any;
 }
 
-declare const MCP_WORDPRESS_REMOTE_VERSION = "0.2.18";
+declare const MCP_WORDPRESS_REMOTE_VERSION = "0.2.19";
 /**
  * Centralized configuration for MCP WordPress Remote
  * All default values are defined here and can be overridden via environment variables
@@ -42,6 +45,7 @@ declare const CONFIG: {
     readonly WOO_CUSTOMER_SECRET: string | undefined;
     readonly CUSTOM_HEADERS: string;
     readonly NODE_ENV: string;
+    readonly USE_SYSTEM_PROXY: boolean;
 };
 /**
  * Type-safe configuration access with JSDoc descriptions
@@ -89,6 +93,8 @@ declare const getConfig: () => {
     customHeaders: string;
     /** Current environment */
     nodeEnv: string;
+    /** Whether to use system proxy (PAC files on macOS, env vars on all platforms) */
+    useSystemProxy: boolean;
 };
 /**
  * Get default OAuth scopes
@@ -219,4 +225,81 @@ declare function isConfigError(error: any): error is ConfigError;
 declare function isAuthError(error: any): error is AuthError;
 declare function isAPIError(error: any): error is APIError;
 
-export { APIError, AuthError, CONFIG, ConfigError, LogLevel, MCP_WORDPRESS_REMOTE_VERSION, OAuthError, type TokenValidationResult, type WPClientInfo, type WPTokens, type WordPressRequestParams, type WordPressResponse, getConfig, getCustomHeaders, getDefaultOAuthScopes, isAPIError, isAuthError, isConfigError, isOAuthError, log, logger, parseCustomHeaders, validateConfig, wpRequest };
+/**
+ * Fetch API utilities for MCP WordPress Remote
+ *
+ * Provides fetch polyfill setup for Node.js environments that don't have native fetch
+ * and proxy-aware fetch for routing through system proxies (PAC files, env-based SOCKS/HTTP proxies)
+ */
+/**
+ * Setup fetch polyfill for Node.js 18+ compatibility
+ *
+ * Checks if native fetch is available and loads node-fetch polyfill if needed.
+ * This ensures compatibility across different Node.js versions.
+ * Also initializes proxy support for system proxies (PAC files, env vars).
+ */
+declare function setupFetchPolyfill(): Promise<void>;
+/**
+ * Proxy-aware fetch that routes requests through system proxies when configured
+ *
+ * On macOS: Evaluates PAC file from system proxy settings to determine proxy per-URL
+ * On Linux/other: Uses SOCKS_PROXY, HTTPS_PROXY, etc. environment variables
+ * Falls back to direct connection if no proxy is configured or USE_SYSTEM_PROXY=false
+ *
+ * @param url - The URL to fetch
+ * @param init - Optional fetch init options
+ * @returns Promise resolving to the Response
+ */
+declare function proxyFetch(url: string, init?: RequestInit): Promise<Response>;
+/**
+ * Get proxy status information for logging/debugging
+ */
+declare function getProxyInfo(): {
+    configured: boolean;
+    type: "pac" | "env" | "none";
+};
+/**
+ * Check if fetch is available (either native or polyfilled)
+ *
+ * @returns true if fetch is available, false otherwise
+ */
+declare function isFetchAvailable(): boolean;
+/**
+ * Get information about the current fetch implementation
+ *
+ * @returns Object with details about fetch availability and type
+ */
+declare function getFetchInfo(): {
+    available: boolean;
+    native: boolean;
+    polyfilled: boolean;
+};
+
+/**
+ * Cross-platform proxy utilities for MCP WordPress Remote
+ *
+ * Supports:
+ * - macOS: Automatic PAC file detection from system proxy settings
+ * - All platforms: Environment variables (SOCKS_PROXY, HTTPS_PROXY, etc.)
+ */
+
+type ProxyAgent = SocksProxyAgent | HttpsProxyAgent<string>;
+/**
+ * Initialize proxy configuration (call once at startup)
+ * Guards against concurrent initialization calls
+ */
+declare function initializeProxy(): Promise<void>;
+/**
+ * Get appropriate agent for a URL based on proxy configuration
+ */
+declare function getAgentForUrl(url: string): Promise<ProxyAgent | undefined>;
+/**
+ * Check if proxy is configured
+ */
+declare function isProxyConfigured(): boolean;
+/**
+ * Get proxy configuration type for logging
+ */
+declare function getProxyType(): 'pac' | 'env' | 'none';
+
+export { APIError, AuthError, CONFIG, ConfigError, LogLevel, MCP_WORDPRESS_REMOTE_VERSION, OAuthError, type TokenValidationResult, type WPClientInfo, type WPTokens, type WordPressRequestParams, type WordPressResponse, getAgentForUrl, getConfig, getCustomHeaders, getDefaultOAuthScopes, getFetchInfo, getProxyInfo, getProxyType, initializeProxy, isAPIError, isAuthError, isConfigError, isFetchAvailable, isOAuthError, isProxyConfigured, log, logger, parseCustomHeaders, proxyFetch, setupFetchPolyfill, validateConfig, wpRequest };