New Adapter: ferio

[deferoper]

Type of change

• New bidder adapter
• Does this change affect user-facing APIs or examples documented on http://prebid.org?

Description of change

Adds the initial Ferio (ferio) bidder adapter for Prebid.js.

Included functionality:

• Posts OpenRTB requests to https://ferio.bid/pbjs/bid using Prebid's ortbConverter and pbsExtensions.
• Supports banner, video, and native inventory.
• Requires publisherId, adUnitId, and tenantId bidder params.
• Forwards GDPR, USP, GPP, and EID signals into the OpenRTB request.
• Registers image and iframe user syncs derived from the Ferio endpoint, with privacy query params.
• Adds bidder documentation and FerioBidParams TypeScript declarations for the public params interface.
• Adds a shared Ferio bidder-spec helper used by this adapter and covered for configurable alias endpoints/param keys.

Maintainer contact:

• prebid@ferio.cloud

Test parameters:

var adUnits = [
  {
    code: "banner-div",
    mediaTypes: { banner: { sizes: [[300, 250]] } },
    bids: [
      {
        bidder: "ferio",
        params: {
          publisherId: "pub-123",
          adUnitId: "ad-unit-456",
          tenantId: "tenant-123",
        },
      },
    ],
  },
];

Other information

Docs PR: (prebid/prebid.github.io#6568)

Company: Ferio Flow

This PR includes:

• modules/ferioBidAdapter.js
• libraries/ferioUtils/bidderUtils.js
• modules/ferioBidAdapter.md
• modules/ferioBidAdapterTypes.d.ts
• test/spec/modules/ferioBidAdapter_spec.js

Unit coverage covers bid validation, OpenRTB request construction, banner/video/native impression generation, response parsing, media type inference, privacy fields, EIDs, user sync URL generation, and the shared Ferio helper's alias configuration path.

Coverage: 100% source functions, 94.6% source lines, 85.0% source branches.

Local checks:

• npx eslint modules/ferioBidAdapter.js libraries/ferioUtils/bidderUtils.js test/spec/modules/ferioBidAdapter_spec.js --cache --cache-strategy content
• npx gulp test-coverage --file test/spec/modules/ferioBidAdapter_spec.js - 25 tests completed

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 8b64e74213

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

[chatgpt-codex-connector]

Avoid mutating shared mediaType in bid response context

Setting context.mediaType here leaks state across all bids that share the same impid in a single ORTB response, because fromORTB reuses the same imp context object for each bid on that impression. If the first bid lacks mtype/ext.prebid.type, this assignment persists and can force subsequent bids (even those with explicit media types) to be parsed as the wrong format, which can corrupt fields like vastXml/native parsing or cause bids to be dropped.

Useful? React with 👍 / 👎.

[github-actions]

Whoa there partner! This project is migrating to typescript. Consider changing the new JS files to TS, with well-defined types for what interacts with the prebid public API (for example: bid params and configuration). Thanks!

• libraries/ferioUtils/bidderUtils.js
• modules/ferioBidAdapter.js

[patmmccann]

why add a library if there is only one importer

[deferoper]

it is planned as utils for multiple upcoming adapters

[patmmccann]

The next several functions are available by using the ortb converter library

[patmmccann]

Why do these next three lines exist