Floxis Bid Adapter: redesign to seat-based architecture with ortbConverter

Major rewrite replacing teqblazeUtils with ortbConverter for ORTB 2.x compliance.

Changes:
- New params: seat (required), region (required), partner (required)
- Endpoint URL: https://{subdomain}.floxis.tech/pbjs?seat={seat}
  - subdomain = region for 'floxis' partner
  - subdomain = {partner}-{region} for white-label partners
- ORTB-native implementation with Floors Module support
- 40 comprehensive tests with full code coverage
- Updated documentation with examples

Addresses all PR #13934 review comments from @osazos

Author: floxis-tech

modules/FloxisBidAdapter.md

@@ -2,84 +2,31 @@
 
 ```
 Module Name: Floxis Bidder Adapter
-Module Type: Floxis Bidder Adapter
+Module Type: Bidder Adapter
 Maintainer: admin@floxis.tech
 ```
+
 # Description
 
-The Floxis Bid Adapter enables integration with the Floxis programmatic advertising platform via Prebid.js. It supports banner, video (instream and outstream), and native formats, and is designed for multi-partner, multi-region use.
+The Floxis Bid Adapter enables integration with the Floxis programmatic advertising platform via Prebid.js. It supports banner, video (instream and outstream), and native formats.
 
 **Key Features:**
 - Banner, Video and Native ad support
 - OpenRTB 2.x compliant
-- Privacy regulation compliance
-
-## Required Params
-- `partner` (string): Partner name
-- `placementId` (integer): Placement identifier
-
-## OpenRTB Blocking Params Support
-FloxisBidAdapter supports OpenRTB blocking parameters. You can pass the following optional params in your ad unit config:
-- `bcat` (array): Blocked categories
-- `badv` (array): Blocked advertiser domains
-- `bapp` (array): Blocked app bundle IDs
-- `battr` (array): Blocked creative attributes
+- Privacy regulation compliance (GDPR, USP, GPP, COPPA)
+- Prebid.js Floors Module support
 
-These will be included in the OpenRTB request and imp objects as appropriate.
-
-**Example:**
-```javascript
-pbjs.addAdUnits([
-  {
-    code: 'adunit-20',
-    mediaTypes: { banner: { sizes: [[300, 250]] } },
-    bids: [{
-      bidder: 'floxis',
-      params: {
-        partner: 'floxis',
-        placementId: 555,
-        bcat: ['IAB1-1', 'IAB1-2'],
-        badv: ['example.com', 'test.com'],
-        bapp: ['com.example.app'],
-        battr: [1, 2, 3]
-      }
-    }]
-  }
-]);
-```
+## Supported Media Types
+- Banner
+- Video
+- Native
 
 ## Floors Module Support
-FloxisBidAdapter supports Prebid.js Floors Module. If a bid request provides a floor value via the Floors Module (`getFloor` function), it will be sent in the OpenRTB request as `imp.bidfloor` and `imp.bidfloorcur`. If not, you can also set a static floor using `params.bidFloor`.
-
-**Example with Floors Module:**
-```javascript
-pbjs.addAdUnits([
-  {
-    code: 'adunit-1',
-    mediaTypes: { banner: { sizes: [[300, 250]] } },
-    bids: [{
-      bidder: 'floxis',
-      params: {
-        partner: 'floxis',
-        placementId: 1,
-        bidFloor: 2.5 // optional static floor
-      },
-      getFloor: function({currency, mediaType, size}) {
-        return { floor: 2.5, currency: 'USD' };
-      }
-    }]
-  }
-]);
-```
+The Floxis Bid Adapter supports the Prebid.js [Floors Module](https://docs.prebid.org/dev-docs/modules/floors.html). Floor values are automatically included in the OpenRTB request as `imp.bidfloor` and `imp.bidfloorcur`.
 
 ## Privacy
 Privacy fields (GDPR, USP, GPP, COPPA) are handled by Prebid.js core and automatically included in the OpenRTB request.
 
-## Supported Media Types
-- Banner
-- Video
-- Native
-
 ## Example Usage
 ```javascript
 pbjs.addAdUnits([
@@ -89,22 +36,24 @@ pbjs.addAdUnits([
     bids: [{
       bidder: 'floxis',
       params: {
-        partner: 'floxis',
-        placementId: 1
+        seat: 'testSeat',
+        region: 'us-e',
+        partner: 'floxis'
       }
     }]
   }
 ]);
 ```
 
-
 # Configuration
-## Required Parameters
+
+## Parameters
 
 | Name | Scope | Description | Example | Type |
 | --- | --- | --- | --- | --- |
-| `partner` | required | Partner identifier provided by Floxis | `floxis` | `string` |
-| `placementId` | required | Placement identifier provided by Floxis | `1` | `int` |
+| `seat` | required | Seat identifier | `'testSeat'` | `string` |
+| `region` | required | Region identifier for routing | `'us-e'` | `string` |
+| `partner` | required | Partner identifier | `'floxis'` | `string` |
 
 ## Testing
-Unit tests are provided in `test/spec/modules/floxisBidAdapter_spec.js` and cover validation, request building, and response interpretation.
+Unit tests are provided in `test/spec/modules/floxisBidAdapter_spec.js` and cover validation, request building, response interpretation, and bid-won notifications.

modules/floxisBidAdapter.js

@@ -1,26 +1,29 @@
-import { ortbConverter } from '../libraries/ortbConverter/converter.js';
 import { registerBidder } from '../src/adapters/bidderFactory.js';
 import { BANNER, NATIVE, VIDEO } from '../src/mediaTypes.js';
-import * as utils from '../src/utils.js';
+import { ortbConverter } from '../libraries/ortbConverter/converter.js';
+import { triggerPixel, mergeDeep } from '../src/utils.js';
 
 const BIDDER_CODE = 'floxis';
-
-const DEFAULT_REGION = 'us';
-const DEFAULT_PARTNER = 'floxis';
 const DEFAULT_BID_TTL = 300;
 const DEFAULT_CURRENCY = 'USD';
 const DEFAULT_NET_REVENUE = true;
 
+
+function getEndpointUrl(seat, region, partner) {
+  const subdomain = partner === BIDDER_CODE ? region : `${partner}-${region}`;
+  return `https://${subdomain}.floxis.tech/pbjs?seat=${encodeURIComponent(seat)}`;
+}
+
 const CONVERTER = ortbConverter({
   context: {
     netRevenue: DEFAULT_NET_REVENUE,
     ttl: DEFAULT_BID_TTL,
     currency: DEFAULT_CURRENCY
   },
   imp(buildImp, bidRequest, context) {
-    let imp = buildImp(bidRequest, context);
+    const imp = buildImp(bidRequest, context);
     imp.secure = bidRequest.ortb2Imp?.secure ?? 1;
-    // Floors Module support
+
     let floorInfo;
     if (typeof bidRequest.getFloor === 'function') {
       try {
@@ -31,132 +34,79 @@ const CONVERTER = ortbConverter({
         });
       } catch (e) { }
     }
-    const floor = floorInfo && typeof floorInfo.floor === 'number' ? floorInfo.floor : bidRequest.params?.bidFloor;
-    const floorCur = floorInfo && typeof floorInfo.currency === 'string' ? floorInfo.currency : DEFAULT_CURRENCY;
+    const floor = floorInfo?.floor;
+    const floorCur = floorInfo?.currency || DEFAULT_CURRENCY;
     if (typeof floor === 'number' && !isNaN(floor)) {
       imp.bidfloor = floor;
       imp.bidfloorcur = floorCur;
     }
-    // ORTB blocking params (imp-level)
-    if (Array.isArray(bidRequest.params?.battr)) {
-      imp.banner = imp.banner || {};
-      imp.banner.battr = bidRequest.params.battr;
-    }
+
     return imp;
   },
   request(buildRequest, imps, bidderRequest, context) {
     const req = buildRequest(imps, bidderRequest, context);
-    req.at = 1;
-    req.ext = req.ext || {};
-    req.ext.name = 'prebidjs';
-    req.ext.version = '$prebid.version$';
-    req.site = req.site || {};
-    req.site.ext = req.site.ext || {};
-    // Set placementId from first bid
-    const firstBid = context.bidRequests[0];
-    if (firstBid?.params?.placementId) {
-      req.site.ext.placementId = firstBid.params.placementId;
-    }
-    // ORTB blocking params (request-level)
-    const firstParams = firstBid?.params || {};
-    if (Array.isArray(firstParams.bcat)) {
-      req.bcat = firstParams.bcat;
-    }
-    if (Array.isArray(firstParams.badv)) {
-      req.badv = firstParams.badv;
-    }
-    if (Array.isArray(firstParams.bapp)) {
-      req.bapp = firstParams.bapp;
-    }
+    mergeDeep(req, {
+      at: 1,
+      ext: {
+        prebid: {
+          adapter: BIDDER_CODE,
+          adapterVersion: '2.0.0'
+        }
+      }
+    });
     return req;
   }
 });
 
-function buildRequests(validBidRequests = [], bidderRequest = {}) {
-  if (!validBidRequests || !validBidRequests.length) {
-    return [];
-  }
-  const firstBid = validBidRequests[0];
-  const partner = firstBid?.params?.partner || DEFAULT_PARTNER;
-  const region = firstBid?.params?.region || DEFAULT_REGION;
+export const spec = {
+  code: BIDDER_CODE,
+  supportedMediaTypes: [BANNER, VIDEO, NATIVE],
 
-  const ortbRequest = CONVERTER.toORTB({ bidRequests: validBidRequests, bidderRequest });
-  return [{
-    method: 'POST',
-    url: getFloxisUrl(partner, region),
-    data: ortbRequest,
-    options: {
-      withCredentials: true,
-      contentType: 'application/json;charset=UTF-8',
-    }
-  }];
-}
+  isBidRequestValid(bid) {
+    const params = bid?.params;
+    if (!params) return false;
+    if (typeof params.seat !== 'string' || !params.seat.length) return false;
+    if (typeof params.region !== 'string' || !params.region.length) return false;
+    if (typeof params.partner !== 'string' || !params.partner.length) return false;
+    return true;
+  },
 
-function getFloxisUrl(partner, region = DEFAULT_REGION) {
-  return `https://${partner}-${region}.floxis.tech/pbjs`;
-}
+  buildRequests(validBidRequests = [], bidderRequest = {}) {
+    if (!validBidRequests.length) return [];
 
-// User sync not supported initially
-function getUserSyncs() {
-  return [];
-}
+    const firstBid = validBidRequests[0];
+    const { seat, region, partner } = firstBid.params;
+    const url = getEndpointUrl(seat, region, partner);
+    const data = CONVERTER.toORTB({ bidRequests: validBidRequests, bidderRequest });
 
-export const spec = {
-  code: BIDDER_CODE,
-  supportedMediaTypes: [BANNER, VIDEO, NATIVE],
-  isBidRequestValid: function (bid) {
-    const params = bid.params || {};
-    if (typeof params.partner !== 'string' || !params.partner.length || !Number.isInteger(params.placementId)) {
-      return false;
-    }
-    // Must have at least one media type
-    if (!bid.mediaTypes || (!bid.mediaTypes.banner && !bid.mediaTypes.video && !bid.mediaTypes.native)) {
-      return false;
-    }
-    // Banner size validation
-    if (bid.mediaTypes.banner) {
-      const sizes = bid.mediaTypes.banner.sizes;
-      if (!Array.isArray(sizes) || !sizes.length || !sizes.every(size => Array.isArray(size) && size.length === 2 && size.every(Number.isInteger))) {
-        return false;
-      }
-    }
-    // Video validation
-    if (bid.mediaTypes.video) {
-      const v = bid.mediaTypes.video;
-      if (!Array.isArray(v.playerSize) || !v.playerSize.length || !v.playerSize.every(size => Array.isArray(size) && size.length === 2 && size.every(Number.isInteger))) {
-        return false;
-      }
-      // Check for required video params
-      if (!Array.isArray(v.mimes) || !v.mimes.length) {
-        return false;
-      }
-      if (!Array.isArray(v.protocols) || !v.protocols.length) {
-        return false;
+    return [{
+      method: 'POST',
+      url,
+      data,
+      options: {
+        withCredentials: true,
+        contentType: 'application/json'
       }
-    }
-    // Native validation (basic)
-    if (bid.mediaTypes.native) {
-      const n = bid.mediaTypes.native;
-      // Require at least one asset (image, title, etc.)
-      if (!n || Object.keys(n).length === 0) {
-        return false;
-      }
-    }
-    return true;
+    }];
   },
-  buildRequests,
+
   interpretResponse(response, request) {
+    if (!response?.body) return [];
     return CONVERTER.fromORTB({ request: request.data, response: response.body }).bids;
   },
-  getUserSyncs,
-  onBidWon: function (bid) {
+
+  getUserSyncs() {
+    return [];
+  },
+
+  onBidWon(bid) {
     if (bid.burl) {
-      utils.triggerPixel(bid.burl);
+      triggerPixel(bid.burl);
     }
     if (bid.nurl) {
-      utils.triggerPixel(bid.nurl);
+      triggerPixel(bid.nurl);
     }
-  },
+  }
 };
 
 registerBidder(spec);