feat: wire the Instagram connector into connect and publishing

The Instagram connector existed but was never registered, so Channels showed
it as "provider unavailable" and publishing could not resolve it.

- Register createInstagramConnector in the connections registry and the
  publishing registry; add the connector-runtime publishing policy
  (idempotency "none": media_publish has no key, never replay).
- The Facebook app credentials identify the Hub, not a collective: read them
  only from INSTAGRAM_CLIENT_ID / INSTAGRAM_CLIENT_SECRET. Drop the
  clientId/clientSecret connect fields and stop copying the app secret into
  each connection's vault entry. The provider is connectable only when both
  are set (connectEnabled + connectNote).
- Fail the connect when several Instagram accounts are granted instead of
  silently publishing as the first Page's account.
- Fix the connector package's pre-existing lint errors (it now ships in api).
- Tests: contract cases for env-only credentials and the multi-account
  refusal; connections integration case for provider gating and the
  Facebook dialog redirect.
- docs/oauth-connect.md: Instagram setup, callback URI and limits.

Not in this change: publishing images needs a public plaintext JPEG URL that
Meta downloads, and storage is client-side encrypted, so presigned S3 URLs
cannot serve it. Until a short-lived media endpoint exists, publishing to
Instagram fails with an explicit error. Token refresh via ig_refresh_token
on graph.facebook.com also needs checking against Facebook Login tokens.
This commit is contained in:
hacklab 2026-10-15 14:15:03 +02:00
parent a6843e904b
commit 80aa198843
9 changed files with 127 additions and 78 deletions

3
pnpm-lock.yaml generated
View file

@ -50,6 +50,9 @@ importers:
'@opentelemetry/sdk-node':
specifier: ^0.222.0
version: 0.222.0(@opentelemetry/api@1.9.1)
'@tactical-media-broadcast-hub/connector-instagram':
specifier: workspace:*
version: link:../../packages/connector-instagram
'@tactical-media-broadcast-hub/connector-mastodon':
specifier: workspace:*
version: link:../../packages/connector-mastodon