Floxis Bid Adapter (backport kit): add first-party fallback id at user.ext.floxisId

[floxis-admin]

Summary

Ports the first-party fallback id feature (9ee83ddae from floxis-adapter-first-party-id) into the backport kit for old-wrapper publishers running Prebid.js 8.52–10.29 (G4G and similar).

Same mechanism: the adapter mints a random v4 UUID in the publisher's page context (localStorage + cookie, scoped to the publisher's origin) and places it at user.ext.floxisId when no id is already present via ortb2 FPD. Degrades to a no-op when storage access is disallowed (consent, deviceAccess, or bidderSettings.floxis.storageAllowed not set).

Old-core API compatibility

getStorageManager({ bidderCode }) and generateUUID were verified against old-core sources (commit fbb71ad1c, circa Prebid 7.x) — both APIs are identical across 8.52.2–10.29.1. No adaptation was needed; the {moduleType:'bidder', moduleName} verbose form is NOT required.

Build + test (Prebid 8.52.2, node 20)

git clone --depth 1 --branch 8.52.2 https://github.com/prebid/Prebid.js.git /tmp/prebid-8.52.2
./install.sh /tmp/prebid-8.52.2
cd /tmp/prebid-8.52.2 && PUPPETEER_SKIP_DOWNLOAD=true npm ci
node_modules/.bin/gulp build --modules=floxisBidAdapter
# grep bundle BEFORE tests wipe build/dist:
grep -c "flx_uid\|floxisId\|getStorageManager" build/dist/floxisBidAdapter.js  # → 1 (minified, all in one line)
node_modules/.bin/gulp test --nolint --file test/spec/modules/floxisBidAdapter_spec.js

Karma results (second run — definitive per kit docs):

• 106 tests completed, 0 failed (prior baseline: 98; +8 = the new first-party-id suite)

Changes

• floxis-backport-kit/modules/floxisBidAdapter.js — getStorageManager, getOrCreateFloxisId, and mergeDeep(req,{user:{ext:{floxisId}}}) in the ortbConverter request hook
• floxis-backport-kit/modules/floxisBidAdapter.md — First-Party Fallback Id section (mirrors main adapter)
• floxis-backport-kit/test/spec/modules/floxisBidAdapter_spec.js — 8 new cases (identical to main spec): mint/reuse/localStorage-fallback/malformed-regenerate/no-storage/throw-guard/FPD-coexist/no-overwrite
• floxis-backport-kit/INTEGRATION.md — new Section 5: "Enable first-party fallback id" documenting the storageAllowed: true opt-in, storage scope, and backend priority

🤖 Generated with Claude Code