feat(adapters): add read-only Faire adapter (#1408) - #1563

Summary

Read-only Faire adapter for brands, from #1408. It's a draft so you can comment on the tool list and the auth choice before it's marked ready.

Auth: one question for you

The issue says X-FAIRE-ACCESS-TOKEN. The current brand-side docs (developers.faire.com, where faire.github.io/external-api-v2-docs now redirects) list only OAuth as the security scheme. Every request sends two headers:

• X-FAIRE-OAUTH-ACCESS-TOKEN: the OAuth access token
• X-FAIRE-APP-CREDENTIALS: applicationId:applicationSecret, Base64-encoded

The docs say OAuth tokens differ from "the access tokens used for V1 and V2". They still suggest single brands generate a token in the Brand Portal, but no longer name the header for it.

So the adapter uses the documented OAuth pair: authType: API_KEY with headerName plus extraHeaders, the same pattern as de/clockodo.json and be/falco.json. Both values are {{FAIRE_OAUTH_ACCESS_TOKEN}} and {{FAIRE_APP_CREDENTIALS}} variable references.

Would you also like support for the Brand Portal token (X-FAIRE-ACCESS-TOKEN)? If so, should it be a second adapter variant, or should I switch to it entirely?

Tools (all GET, read-only)

The issue's "inventory levels" now maps to /product-inventory/by-*: Faire removed the old /products/variants/inventory-levels-by-* endpoints on 2026-06-01.

Changes

• packages/backend/src/adapters/intl/faire.json and the regenerated catalog.ts
• packages/backend/src/adapters/intl/faire.live.spec.ts: static tests always run; live tests run only with RUN_FAIRE_LIVE=1
• Quoted counts bumped from 713 to 714, plus regenerated llms.txt and llms-full.txt
• packages/frontend/public/logos/connectors/faire.svg: a simple monogram placeholder; happy to swap in the official mark if you prefer

Testing

Run from the repository root:

$ node scripts/validate-adapters.mjs --warn
Validated 730 adapters: 730 passed, 0 failed, 1440 total warnings.

None of the 1,440 warnings is in intl/faire.json; all of them existed before.

$ node scripts/regenerate-catalog.mjs
✓ Regenerated packages/backend/src/adapters/catalog.ts: 730 adapters across 15 regions.
$ node scripts/adapter-count.mjs --check
OK: every quoted count equals 714 adapters (35 keyless, 12900 tools).
$ node scripts/generate-llms-txt.mjs --check
(passes)

Run in packages/backend:

$ npx jest src/adapters/intl/faire.live.spec.ts
Tests:       3 skipped, 21 passed, 24 total
$ npx eslint src/adapters/intl/faire.live.spec.ts
(no output, exit 0)

I didn't run the full backend suite or tsc locally; I'm relying on CI for those.

Live calls: none. I don't have a Faire brand account with an authorized app, so this is built from the docs. The live tests run only when RUN_FAIRE_LIVE=1 is set.

Type

• New feature

Related Issues

Closes #1408

🤖 Generated with Claude Code