@pidgeon-ai/sdk 1.36.0 → 1.37.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,31 @@ the two would publish a release for every unrelated product deploy.
7
7
  Semver applies to **this package's own surface** — the exported names, the
8
8
  call shapes, the result shape — not to the API behind it.
9
9
 
10
+ ## 1.37.0 — every endpoint keeps the API's promises
11
+
12
+ - **Every write takes an `Idempotency-Key` header**, not only the sends and
13
+ the creates: every `PATCH`, `PUT` and `DELETE`, and the other `POST`s.
14
+ Each declares the `409` (`idempotency_in_progress`,
15
+ `idempotency_mismatch`) and the test-mode `504`. A retried delete replays
16
+ "deleted" instead of answering `404`. Unauthenticated agent signup and
17
+ `keysRotate` are the exceptions.
18
+ - **Every list pages to the end.** `domainsList` and `webhooksList` honour
19
+ the `limit` and `cursor` they always declared; `webhooksDeliveries`,
20
+ `draftsList`, `calendarListEvents`, `calendarGetAgenda`,
21
+ `calendarListEventInstances` and `messagesSearch` take `cursor` and answer
22
+ `next_cursor`. Each used to stop at `limit` with `has_more: false`. A
23
+ calendar window holding more than 1,000 events is a `400` naming
24
+ `before`; search reads the 1,000 best matches.
25
+ - `appPasswordsCreate` answers `AppPasswordCreated`, with the `username` and
26
+ `password` it always returned. `password` and `WebhookCreated.secret` are
27
+ `string | null`: null on an `Idempotency-Key` replay, because neither is
28
+ stored. Check them before storing.
29
+ - `MailboxChange` carries the listing row's fields, as the endpoint always
30
+ sent them.
31
+ - A `400` names the field you sent: an unknown key by its name, and in
32
+ `snake_case` (`send_at`, not `sendAt`). Every `429` carries
33
+ `X-RateLimit-Limit`, `-Remaining` and `-Reset` beside `Retry-After`.
34
+
10
35
  ## 1.36.0 — the mail a domain already receives
11
36
 
12
37
  `domainsCreate` answers `existing_mail`: who already receives mail for the