Feat: nexchange plugin

[j0ntz]

CHANGELOG

Does this branch warrant an entry to the CHANGELOG?

• Yes
• No

Dependencies

Api Key should be shared privately.

Description

Recreated from #212 by external contributor @MMrj9 so that Bugbot (which skips external authors) can run. Git author attribution on the cherry-picked commit is preserved for Miguel Morujão. Original PR should be closed once this one merges.

Original description follows:

• Added new nexchange partner plugin at src/partners/nexchange.ts.
• Integrated the plugin into the query engine in src/queryEngine.ts.
• Implemented Edge audit orders API ingestion (/audits/edge/orders) with support for:
  • API key auth via x-api-key
  • Legacy Authorization: ApiKey <key> auth header
  • Cursor pagination with offset fallback
  • dateFrom incremental sync using persisted latestIsoDate and lookback
• Added tests in test/nexchange.test.ts for transaction mapping and auth header behavior.

https://app.asana.com/1/9976422036640/project/1200382638405084/task/1213650284151456?focus=true

---

Note

Medium Risk
Introduces a new external API ingestion path and enables it in the query engine, which could affect sync completeness/duplication and error handling behavior for that partner. Core engine changes are limited to registration, but the new pagination/date logic needs verification against real API responses.

Overview
Adds a new Nexchange partner integration that fetches /audits/edge/orders, supports x-api-key and/or legacy Authorization auth headers, paginates via cursor with offset fallback, and performs incremental sync using a persisted latestIsoDate with a 5-day lookback.

Registers nexchange in src/queryEngine.ts so it runs alongside existing partners, and adds test/nexchange.test.ts to validate StandardTx mapping (status/date/amount normalization) and header construction.

^{Reviewed by Cursor Bugbot for commit 5591c9e. Bugbot is set up for automated code reviews on this repo. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 59abfa0. Configure here.}