ENG-1966 Adobe Experience Platform integration

[thabofletcher]

Ticket ENG-1966

Description Of Changes

Adds the basics for an Adobe Experience Platform integration

Code Changes

• integration for Adobe Web SDK (untested outside mocks) (window.alloy)
• integration for ECID OptIn (tested on nvidia.com and jetson-ai-lab.com) (window.adobe.optIn)
• configuration mapping scheme/defaults for WebSDK and ECID OptIN
• unit tests
• shared abstraction with blueconic integration for listening to Fides events

Steps to Confirm

1. Open nvidia.com and dev tools
2. Check relevant ECID settings, paste in

(() => { const o = window.adobe?.optIn; return o ? { aa: o.isApproved(o.Categories.ANALYTICS), target: o.isApproved(o.Categories.TARGET), aam: o.isApproved(o.Categories.AAM) } : 'Not loaded'; })()

3. Inject fides.js from the Vercel env
4. Run the aep integration:

window.fidesAEP = Fides.aep({
    purposeMapping: {
      performance: ['collect', 'measure'],
      functional: ['personalize'],
      advertising: ['personalize', 'share']
    },
    ecidMapping: {
      performance: ['aa'],
      functional: ['target'],
      advertising: ['aam']
    }
  });

5. Re check ECID settings at the start and after using Fides.showModal() to make changes

Pre-Merge Checklist

• Issue requirements met
• All CI pipelines succeeded
• CHANGELOG.md updated
  • Add a db-migration This indicates that a change includes a database migration label to the entry if your change includes a DB migration
  • Add a high-risk This issue suggests changes that have a high-probability of breaking existing code label to the entry if your change includes a high-risk change (i.e. potential for performance impact or unexpected regression) that should be flagged
  • Updates unreleased work already in Changelog, no new entry necessary
• UX feedback:
  • All UX related changes have been reviewed by a designer
  • No UX review needed
• Followup issues:
  • Followup issues created
  • No followup issues
• Database migrations:
  • Ensure that your downrev is up to date with the latest revision on main
  • Ensure that your downgrade() migration is correct and works
    • If a downgrade migration is not possible for this change, please call this out in the PR description!
  • No migrations
• Documentation:
  • Documentation complete, PR opened in fidesdocs
  • Documentation issue created in fidesdocs
  • If there are any new client scopes created as part of the pull request, remember to update public-facing documentation that references our scope registry
  • No documentation updates required

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
fides-plus-nightly	Ready	Preview	Comment	Nov 14, 2025 10:55pm

1 Skipped Deployment

Project	Deployment	Preview	Comments	Updated (UTC)
fides-privacy-center	Ignored			Nov 14, 2025 10:55pm

[greptile-apps]

Greptile Overview

Greptile Summary

This PR adds Adobe Experience Platform (AEP) integration to FidesJS, enabling consent synchronization with both modern Adobe Web SDK (Alloy) and legacy ECID Opt-In Service.

Key Changes:

• New aep.ts integration supporting dual Adobe consent systems with configurable purpose/category mappings
• Shared integration-utils.ts with subscribeToConsent() helper for consistent event handling across integrations
• Refactored BlueConic integration to use new shared utilities, removing duplicate code
• Comprehensive test suite with 546 lines covering both Adobe products, custom mappings, edge cases, and event subscriptions
• Bundle size increased from 26KB to 27KB (within acceptable limits)

Implementation Quality:
The implementation demonstrates strong architectural patterns with proper TypeScript interfaces, thorough error handling, debug logging via fidesDebugger, and dynamic category support for future-proofing. The shared utility abstraction reduces code duplication and ensures consistent behavior across integrations.

Confidence Score: 5/5

• This PR is safe to merge with minimal risk
• Score reflects well-structured code with proper TypeScript typing, comprehensive test coverage (546 test lines), consistent patterns with existing integrations, proper error handling, and thorough documentation. The refactoring to shared utilities improves maintainability. No security concerns, logic errors, or breaking changes identified.
• No files require special attention

Important Files Changed

File Analysis

Filename	Score	Overview
clients/fides-js/src/integrations/aep.ts	5/5	New Adobe Experience Platform integration supporting both Web SDK (Alloy) and legacy ECID Opt-In service with proper error handling and debug logging
clients/fides-js/src/integrations/integration-utils.ts	5/5	New shared utility for integrations to subscribe to Fides consent events with configurable event filtering and synthetic event support
clients/fides-js/tests/integrations/aep.test.ts	5/5	Comprehensive test coverage for AEP integration including both Adobe products, custom mappings, edge cases, and event subscriptions

[greptile-apps]

_{8 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}

[gilluminate]

LGTM!✨