update specs

This commit is contained in:
Evgeny @ SimpleX Chat
2026-03-13 12:43:02 +00:00
parent bde90500ea
commit 546ee1a0e1
14 changed files with 357 additions and 17 deletions
@@ -13,3 +13,11 @@
### 2. Batch operations return per-item errors
`ntfCreateSubscriptions` and `ntfCheckSubscriptions` return `NonEmpty (Either NtfClientError result)` — individual items in a batch can fail independently. Callers must handle partial success (some created, some failed). The singular variants throw on any error.
### 3. Default port is 443
`defaultNTFClientConfig` sets the default transport to `("443", transport @TLS)`. Unlike the SMP protocol which typically uses port 5223, the NTF protocol defaults to the standard HTTPS port.
### 4. okNtfCommand parameter ordering
`okNtfCommand` has an unusual parameter order — the command comes first, then client, mode, key, entityId. This enables partial application in the `ntfDeleteToken`, `ntfVerifyToken` etc. definitions, where the command is fixed and the remaining parameters flow through.