feat(hub): push config joins the settings.json system (env > file > default)

FCM and iOS/APNs push were the only hub knobs read straight from env,
bypassing the configuration rule every other field follows (env >
settings.json > default, env persisted on first sight). Fold them in:
serverSettings resolves fcmServiceAccountPath / iosPushMode /
iosPushRelayUrl / apnsKeyP8Path / apnsKeyId / apnsTeamId / apnsBundleId
/ apnsEnv under the shared rule, and the two resolvers now consume
configuration instead of process.env. FCM_PROJECT_ID is gone: operators
point at the service-account JSON and the project id comes from the
file — no copying values out of it. Paths accept ~.
This commit is contained in:
weishu
2026-08-18 23:10:57 +08:00
parent 21a5bf2655
commit c76af90d88
10 changed files with 371 additions and 89 deletions
+13 -4
View File
@@ -162,7 +162,9 @@ ones.
### Transports: self-host (direct APNs) vs official relay
The hub picks one of two transports via `HAPI_IOS_PUSH`:
The hub picks one of two transports via `HAPI_IOS_PUSH` (or the
`iosPushMode` field in `~/.hapi/settings.json` — every variable below has a
settings.json equivalent, see [Environment](#environment-hub-operator)):
| Mode | Who talks to Apple | Requirements |
|------|--------------------|--------------|
@@ -212,13 +214,20 @@ and suppresses the Web Push fallback for the namespace when a send succeeds
```bash
FCM_SERVICE_ACCOUNT_PATH=/path/to/service-account.json
FCM_PROJECT_ID=your-firebase-project-id
```
When unset, hub skips FCM channel (Web Push / Telegram unchanged).
iOS transport selection (`HAPI_IOS_PUSH`, `APNS_*`) is documented in
The Firebase project id comes from the service-account JSON itself. When
unset, hub skips FCM channel (Web Push / Telegram unchanged). iOS transport
selection (`HAPI_IOS_PUSH`, `APNS_*`) is documented in
[iOS (APNs)](#transports-self-host-direct-apns-vs-official-relay).
Push configuration follows the hub-wide rule (env > `settings.json` >
default; an env value is persisted into `~/.hapi/settings.json` on first
sight, so the variable only has to be passed once). settings.json keys:
`fcmServiceAccountPath`, `iosPushMode`, `iosPushRelayUrl`, `apnsKeyP8Path`,
`apnsKeyId`, `apnsTeamId`, `apnsBundleId`, `apnsEnv`. Path values may use
`~`.
The native push channel is **opt-in**: operators who don't run a companion
app see no behavior change. When at least one device is registered for a
namespace, the existing Web Push channel suppresses its fallback for that