alwaysHasCapacity flag (#6395)

Co-authored-by: Marcin Komorski <[email protected]>

Author: mkomorski

dev-docs/bidder-adaptor.md

@@ -238,7 +238,8 @@ export const spec = {
     onSetTargeting: function(bid) {},
     onBidderError: function({ error, bidderRequest }) {},
     onAdRenderSucceeded: function(bid) {},
-    supportedMediaTypes: [BANNER, VIDEO, NATIVE, AUDIO]
+    supportedMediaTypes: [BANNER, VIDEO, NATIVE, AUDIO],
+    alwaysHasCapacity: true // When true, this bidder will be omitted in checking if origin has http capacity
 }
 registerBidder(spec);
 
@@ -1190,6 +1191,7 @@ export const spec = {
         code: BIDDER_CODE,
     gvlid: 0000000000,
     supportedMediaTypes: [BANNER, VIDEO, NATIVE],
+    alwaysHasCapacity: true,
         aliases: [{code: "myAlias", gvlid: 99999999999} ],
         /**
          * Determines whether or not the given bid request is valid.

dev-docs/modules/prebidServer.md

@@ -99,6 +99,7 @@ There are many configuration options for s2sConfig:
 | `customHeaders` | Optional | Object | These custom headers will be included in the XHR call to the bidder's endpoint. This will allow you to send data specific to your use case. The format consists of an object where the keys represent the header names and the values correspond to the respective header values. Here is an example how a customHeader object might look like - `{"Header1": "Value1", "Header2": "Value2"}`|
 | `endpointCompression` | Optional | Boolean | Gzip compress the auction request payload when supported and debug mode is off. Adds `gzip=1` to the request URL. |
 | `filterBidderlessCalls` | Optional | Boolean | When `true`, ad units that have no bidders defined are excluded from Prebid Server requests. Defaults to `false`. | `true` |
+| `alwaysHasCapacity` | Optional | Boolean | When `true`, this prebid server instance will be omitted in checking if origin has http capacity, defaults to `false` |
 
 If `endpoint` and `syncEndpoint` are objects, these are the supported properties:
 

dev-docs/publisher-api-reference/setConfig.md

@@ -115,6 +115,14 @@ pbjs.setConfig({ maxRequestsPerOrigin: 6 });
 pbjs.setConfig({ maxRequestsPerOrigin: 1 });
 ```
 
+Note: Prebid adapters or Prebid Server instances can be omitted from this capacity check if they declare `alwaysHasCapacity: true`. See [bidder adapter configuration](/dev-docs/bidder-adaptor.html) and [Prebid Server configuration](/dev-docs/modules/prebidServer.html) for more details.
+
+Although, `maxRequestsPerOrigin` can still be forced by the publisher using:
+
+```javascript
+pbjs.setConfig({ maxRequestsPerOrigin: 1, forceMaxRequestsPerOrigin: true });
+```
+
 ### Disable Ajax Timeout
 
 <a name="setConfig-Disable-Ajax-Timeout"></a>