New adapter: HypeLab

[Minebomber]

🔧 Type of changes

• new bid adapter
• bid adapter update
• new feature
• new analytics adapter
• new module
• module update
• bugfix
• documentation
• configuration
• dependency update
• tech debt (test coverage, refactorings, etc.)

✨ What's the context?

This PR adds the HypeLab bid adapter to Prebid Server Java.

The adapter supports site banner, native, and video inventory. It accepts property_slug and placement_slug bidder params, forwards eligible OpenRTB 2.6 requests to HypeLab, adds HypeLab display manager metadata, and maps HypeLab bid responses back into Prebid bid types.

🧠 Rationale behind the change

HypeLab needs a dedicated adapter because the request is not just a raw OpenRTB pass-through. The adapter validates required bidder params, sets tagid from placement_slug, preserves the HypeLab bidder ext, adds provider metadata, and resolves response bid type from mtype, ext.hypelab.creative_type, VAST markup, or the original impression media type.

🔎 New Bid Adapter Checklist

• verify email contact works
• NO fully dynamic hostnames
• geographic host parameters are NOT required
• direct use of HTTP is prohibited - implement an existing Bidder interface that will do all the job
• if the ORTB is just forwarded to the endpoint, use the generic adapter - define the new adapter as the alias of the generic adapter
• cover an adapter configuration with an integration test

🧪 Test plan

How do you know the changes are safe to ship to production?

• Added unit coverage for request creation, required param validation, mixed valid/invalid impressions, response parsing failures, empty responses, and bid type resolution.
• Added integration coverage for the /openrtb2/auction path and HypeLab adapter configuration.
• Ran ./mvnw -Dtest=HypeLabBidderTest test successfully.
• Generated a local JaCoCo report for HypeLabBidder: 96% instruction coverage and 97% line coverage.

🏎 Quality check

• Are your changes following our code style guidelines?
• Are there any breaking changes in your code? No breaking changes.
• Does your test coverage exceed 90%?
• Are there any erroneous console logs, debuggers or leftover code in your changes? No.

[CTMBNara]

Result.withErrors

[CTMBNara]

Use BidderUtil.defaultRequest

[CTMBNara]

Move parsing out of this method

[CTMBNara]

No need for this checks

[CTMBNara]

Use TypeReference<ExtPrebid<?, ExtImpHypeLab>> instead

[CTMBNara]

    private static List<BidderBid> extractBids(BidRequest request, BidResponse response, List<BidderError> errors) {
        if (response == null || CollectionUtils.isEmpty(response.getSeatbid())) {
            return Collections.emptyList();
        }

        final Map<String, Imp> impIdToImp = request.getImp().stream()
                .collect(Collectors.toMap(Imp::getId, imp -> imp));

        return response.getSeatbid().stream()
                .filter(Objects::nonNull)
                .flatMap(seatBid -> CollectionUtils.emptyIfNull(seatBid.getBid()).stream()
                        .filter(Objects::nonNull)
                        .map(bid -> makeBidderBid(bid, seatBid.getSeat(), impIdToImp, response.getCur(), errors))
                        .filter(Objects::nonNull))
                .toList();
    }

    private static BidderBid makeBidderBid(Bid bid,
                                           String seat,
                                           Map<String, Imp> impIdToImp, String currency,
                                           List<BidderError> errors) {

        try {
            return BidderBid.of(bid, resolveBidType(bid, impIdToImp), seat, currency);
        } catch (PreBidException e) {
            errors.add(BidderError.badServerResponse(e.getMessage()));
            return null;
        }
    }

    private static BidType resolveBidType(Bid bid, Map<String, Imp> impIdToImp) {
        return bidTypeFromMtype(bid.getMtype())
                .or(() -> bidTypeFromExt(bid))
                .or(() -> bidTypeFromAdm(bid.getAdm()))
                .or(() -> bidTypeFromImp(bid, impIdToImp))
                .orElseThrow(() -> new PreBidException("unable to determine media type for bid %s on imp %s"
                        .formatted(bid.getId(), bid.getImpid())));
    }

    private static Optional<BidType> bidTypeFromMtype(Integer mtype) {
        return Optional.ofNullable(switch (mtype) {
            case 1 -> BidType.banner;
            case 2 -> BidType.video;
            case 4 -> BidType.xNative;
            case null, default -> null;
        });
    }

    private static Optional<BidType> bidTypeFromExt(Bid bid) {
        return Optional.ofNullable(bid.getExt())
                .map(ext -> ext.get("hypelab"))
                .map(hypelab -> hypelab.get("creative_type"))
                .filter(JsonNode::isTextual)
                .map(JsonNode::asText)
                .map(creativeType -> switch (creativeType) {
                    case "display" -> BidType.banner;
                    case "video" -> BidType.video;
                    default -> null;
                });
    }

    private static Optional<BidType> bidTypeFromAdm(String adm) {
        return StringUtils.startsWith(StringUtils.trimToEmpty(adm), "<VAST")
                ? Optional.of(BidType.video)
                : Optional.empty();
    }

    private static Optional<BidType> bidTypeFromImp(Bid bid, Map<String, Imp> impIdToImp) {
        return impIdToImp.containsKey(bid.getImpid())
                ? Optional.of(BidderUtil.getBidType(bid, impIdToImp))
                : Optional.empty();
    }

[CTMBNara]

I see the difference with GO version. You didn't append prebid-server@ prefix

[CTMBNara]

GO version have native case:

	case "native":
		return openrtb_ext.BidTypeNative, true, nil

[CTMBNara]

GO doesn't support multi-media imps: mediaTypeCount == 1

[CTMBNara]

No need to declare empty app-media-types