@pidgeon-ai/sdk 1.5.0 → 1.9.0

package/CHANGELOG.md

@@ -9,6 +9,54 @@ call shapes, the result shape — not to the API behind it.
 
 ## Unreleased
 
+## 1.9.0 — export over the API
+
+**`exportMail`** (`GET /v1/export`) streams every message the key can read as
+one `application/mbox` file — the export the dashboard has always offered,
+now for software. Pass `identity_id` for one address. Each message carries
+`X-Pidgeon-Mailbox`, so one file holding several addresses can be split
+again. Four an hour per workspace.
+
+## 1.8.0 — wait for a message, and read the code out of it
+
+**`messagesAwait`** (`GET /v1/messages/await`) holds the request open until a
+message matching your filters arrives at an address — `from`, `subject_contains`,
+`has_code` — or `timeout` seconds pass, up to 280. It answers
+`{ message, timed_out, cursor }`; pass `cursor` back as `after` so a message
+arriving between two calls is never missed. One call where an agent waiting
+for a sign-up code used to write a polling loop.
+
+**Every `Message` carries `extracted`**: `codes` and `links`, most likely
+first, each with its kind. Candidates rather than one answer, because
+extraction is a heuristic — take the first, and when it fails the second is
+right there. Read from the new text, never the quoted history.
+
+## 1.7.0 — a pod's reputation you can see
+
+`GET /metrics` takes `pod_id`, and its window carries `pod` and `reputation`.
+1.6.0 claimed each pod had its own sending reputation and gave no way to
+check it; this is the check. `/metrics` also rejects an unknown query
+parameter instead of ignoring it, so a caller passing a misspelt filter is
+told rather than answered for the whole account.
+
+## 1.6.0 — a pod is a boundary now
+
+**No field changed.** What changed is what a pod means, and that is worth a
+release because 1.5.0's own description told you the opposite.
+
+**Each pod has its own sending reputation.** Bounces and complaints from one
+customer's mail are counted against that customer's pod and nothing else, so
+one bad tenant cannot degrade delivery for the rest. Mail from an address in
+a pod sends under that pod whichever domain it is on, so two pods sharing one
+domain are still separate.
+
+1.5.0 said _"a pod carries no sending reputation of its own"_, which was true
+and is not. Leaving it would be the worse kind of stale documentation — a
+caller reading it would decline to use something they already have.
+
+A pod is still **not** a key scope. A key is a list of address ids, which is
+what makes its reach checkable.
+
 ## 1.5.0 — a container your customers live in
 
 **Additive.** Every account has exactly one pod already, every address is in

package/dist/index.cjs

@@ -63,6 +63,7 @@ __export(index_exports, {
   eventsGet: () => eventsGet,
   eventsList: () => eventsList,
   eventsStream: () => eventsStream,
+  exportMail: () => exportMail,
   identitiesAccessCreate: () => identitiesAccessCreate,
   identitiesAccessDelete: () => identitiesAccessDelete,
   identitiesAccessGet: () => identitiesAccessGet,
@@ -93,6 +94,7 @@ __export(index_exports, {
   mailboxesListFolder: () => mailboxesListFolder,
   meGet: () => meGet,
   messagesAct: () => messagesAct,
+  messagesAwait: () => messagesAwait,
   messagesForward: () => messagesForward,
   messagesGet: () => messagesGet,
   messagesListInThread: () => messagesListInThread,
@@ -1175,6 +1177,11 @@ var messagesUndo = (options) => (options.client ?? client).post({
     ...options.headers
   }
 });
+var messagesAwait = (options) => (options.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/messages/await",
+  ...options
+});
 var messagesGet = (options) => (options.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/messages/{id}",
@@ -1221,6 +1228,11 @@ var messagesRaw = (options) => (options.client ?? client).get({
   url: "/messages/{id}/raw",
   ...options
 });
+var exportMail = (options) => (options?.client ?? client).get({
+  security: [{ scheme: "bearer", type: "http" }],
+  url: "/export",
+  ...options
+});
 var threadsList = (options) => (options?.client ?? client).get({
   security: [{ scheme: "bearer", type: "http" }],
   url: "/threads",
@@ -1824,6 +1836,7 @@ function sleep(ms, signal) {
   eventsGet,
   eventsList,
   eventsStream,
+  exportMail,
   identitiesAccessCreate,
   identitiesAccessDelete,
   identitiesAccessGet,
@@ -1854,6 +1867,7 @@ function sleep(ms, signal) {
   mailboxesListFolder,
   meGet,
   messagesAct,
+  messagesAwait,
   messagesForward,
   messagesGet,
   messagesListInThread,