@pidgeon-ai/sdk 1.16.0 → 1.16.1

package/CHANGELOG.md

@@ -7,6 +7,15 @@ the two would publish a release for every unrelated product deploy.
 Semver applies to **this package's own surface** — the exported names, the
 call shapes, the result shape — not to the API behind it.
 
+## 1.16.1 — a refused send says so
+
+The contract declares `400` and `403` on every send — `messagesSend`,
+`messagesReply`, `messagesReplyAll`, `messagesForward`, `draftsSend` — and
+`409` on `messagesSend`. No request or success shape changes. The Python
+client returned `None` for a `403` (a sending limit, a rule, the send
+policy) because the status was not in the document; it returns the `Error`
+now, so check for it before treating a send as done.
+
 ## 1.16.0 — an attachment as text
 
 `attachmentsText` (`GET /attachments/{id}/text`) returns a text attachment —

package/dist/index.d.cts

@@ -2851,14 +2851,26 @@ type MessagesSendData = {
     url: '/messages';
 };
 type MessagesSendErrors = {
+    /**
+     * The request is not valid. `error.param` names the field when there is one.
+     */
+    400: Error;
     /**
      * No API key, or one that is not valid.
      */
     401: Error;
+    /**
+     * Refused, and nothing was sent to anybody. `error.code` says why: `blocked` (a rule), `not_permitted` (the send policy), `abuse_blocked` (a sending limit) or `forbidden` (the address is not one this key can send from, or is not active).
+     */
+    403: Error;
     /**
      * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
+    /**
+     * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
+     */
+    409: Error;
     /**
      * Rate limited. `X-RateLimit-Reset` says when to retry.
      */
@@ -3137,10 +3149,18 @@ type MessagesReplyData = {
     url: '/messages/{id}/reply';
 };
 type MessagesReplyErrors = {
+    /**
+     * The request is not valid. `error.param` names the field when there is one.
+     */
+    400: Error;
     /**
      * No API key, or one that is not valid.
      */
     401: Error;
+    /**
+     * Refused, and nothing was sent to anybody. `error.code` says why: `blocked` (a rule), `not_permitted` (the send policy), `abuse_blocked` (a sending limit) or `forbidden` (the address is not one this key can send from, or is not active).
+     */
+    403: Error;
     /**
      * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
@@ -3194,10 +3214,18 @@ type MessagesReplyAllData = {
     url: '/messages/{id}/reply-all';
 };
 type MessagesReplyAllErrors = {
+    /**
+     * The request is not valid. `error.param` names the field when there is one.
+     */
+    400: Error;
     /**
      * No API key, or one that is not valid.
      */
     401: Error;
+    /**
+     * Refused, and nothing was sent to anybody. `error.code` says why: `blocked` (a rule), `not_permitted` (the send policy), `abuse_blocked` (a sending limit) or `forbidden` (the address is not one this key can send from, or is not active).
+     */
+    403: Error;
     /**
      * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
@@ -3251,10 +3279,18 @@ type MessagesForwardData = {
     url: '/messages/{id}/forward';
 };
 type MessagesForwardErrors = {
+    /**
+     * The request is not valid. `error.param` names the field when there is one.
+     */
+    400: Error;
     /**
      * No API key, or one that is not valid.
      */
     401: Error;
+    /**
+     * Refused, and nothing was sent to anybody. `error.code` says why: `blocked` (a rule), `not_permitted` (the send policy), `abuse_blocked` (a sending limit) or `forbidden` (the address is not one this key can send from, or is not active).
+     */
+    403: Error;
     /**
      * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
@@ -5616,10 +5652,18 @@ type DraftsSendData = {
     url: '/drafts/{id}/send';
 };
 type DraftsSendErrors = {
+    /**
+     * The request is not valid. `error.param` names the field when there is one.
+     */
+    400: Error;
     /**
      * No API key, or one that is not valid.
      */
     401: Error;
+    /**
+     * Refused, and nothing was sent to anybody. `error.code` says why: `blocked` (a rule), `not_permitted` (the send policy), `abuse_blocked` (a sending limit) or `forbidden` (the address is not one this key can send from, or is not active).
+     */
+    403: Error;
     /**
      * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */

package/dist/index.d.ts

@@ -2851,14 +2851,26 @@ type MessagesSendData = {
     url: '/messages';
 };
 type MessagesSendErrors = {
+    /**
+     * The request is not valid. `error.param` names the field when there is one.
+     */
+    400: Error;
     /**
      * No API key, or one that is not valid.
      */
     401: Error;
+    /**
+     * Refused, and nothing was sent to anybody. `error.code` says why: `blocked` (a rule), `not_permitted` (the send policy), `abuse_blocked` (a sending limit) or `forbidden` (the address is not one this key can send from, or is not active).
+     */
+    403: Error;
     /**
      * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
     404: Error;
+    /**
+     * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
+     */
+    409: Error;
     /**
      * Rate limited. `X-RateLimit-Reset` says when to retry.
      */
@@ -3137,10 +3149,18 @@ type MessagesReplyData = {
     url: '/messages/{id}/reply';
 };
 type MessagesReplyErrors = {
+    /**
+     * The request is not valid. `error.param` names the field when there is one.
+     */
+    400: Error;
     /**
      * No API key, or one that is not valid.
      */
     401: Error;
+    /**
+     * Refused, and nothing was sent to anybody. `error.code` says why: `blocked` (a rule), `not_permitted` (the send policy), `abuse_blocked` (a sending limit) or `forbidden` (the address is not one this key can send from, or is not active).
+     */
+    403: Error;
     /**
      * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
@@ -3194,10 +3214,18 @@ type MessagesReplyAllData = {
     url: '/messages/{id}/reply-all';
 };
 type MessagesReplyAllErrors = {
+    /**
+     * The request is not valid. `error.param` names the field when there is one.
+     */
+    400: Error;
     /**
      * No API key, or one that is not valid.
      */
     401: Error;
+    /**
+     * Refused, and nothing was sent to anybody. `error.code` says why: `blocked` (a rule), `not_permitted` (the send policy), `abuse_blocked` (a sending limit) or `forbidden` (the address is not one this key can send from, or is not active).
+     */
+    403: Error;
     /**
      * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
@@ -3251,10 +3279,18 @@ type MessagesForwardData = {
     url: '/messages/{id}/forward';
 };
 type MessagesForwardErrors = {
+    /**
+     * The request is not valid. `error.param` names the field when there is one.
+     */
+    400: Error;
     /**
      * No API key, or one that is not valid.
      */
     401: Error;
+    /**
+     * Refused, and nothing was sent to anybody. `error.code` says why: `blocked` (a rule), `not_permitted` (the send policy), `abuse_blocked` (a sending limit) or `forbidden` (the address is not one this key can send from, or is not active).
+     */
+    403: Error;
     /**
      * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */
@@ -5616,10 +5652,18 @@ type DraftsSendData = {
     url: '/drafts/{id}/send';
 };
 type DraftsSendErrors = {
+    /**
+     * The request is not valid. `error.param` names the field when there is one.
+     */
+    400: Error;
     /**
      * No API key, or one that is not valid.
      */
     401: Error;
+    /**
+     * Refused, and nothing was sent to anybody. `error.code` says why: `blocked` (a rule), `not_permitted` (the send policy), `abuse_blocked` (a sending limit) or `forbidden` (the address is not one this key can send from, or is not active).
+     */
+    403: Error;
     /**
      * No such resource, or one this key cannot reach. The two answer the same, so treat a 404 as “not available to you” rather than “does not exist”.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pidgeon-ai/sdk",
-  "version": "1.16.0",
+  "version": "1.16.1",
   "description": "Email inboxes for AI agents — TypeScript SDK for Pidgeon: create addresses, send, receive and reply.",
   "keywords": [
     "email",