@pidgeon-ai/sdk 1.34.0 → 1.35.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,20 @@ 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.35.0 — a key says what it is, and minting is idempotent
11
+
12
+ - `meGet` returns `key.test`, `key.rotated_at` and
13
+ `key.previous_token_expires_at`. Read `key.test` rather than the token's
14
+ prefix to tell a test key.
15
+ - `keysCreate` takes an `Idempotency-Key` header. A replay returns the same
16
+ key with `Idempotent-Replay: true` and `token: null`, so
17
+ `ApiKeyCreated.token` is now `string | null`: check it before storing.
18
+ - An idempotency `409` now has its own `error.code`:
19
+ `idempotency_in_progress` (wait `Retry-After` seconds, then send the same
20
+ request) or `idempotency_mismatch` (the key went with a different
21
+ request). Both were `conflict`; code that matched `conflict` for these
22
+ must match the new codes.
23
+
10
24
  ## 1.34.0 — a test key creates test addresses
11
25
 
12
26
  Every address carries `test`. `identitiesCreate` with a test key (at admin
package/dist/index.d.cts CHANGED
@@ -1520,9 +1520,9 @@ type ApiKeyCreated = {
1520
1520
  */
1521
1521
  previous_token_expires_at: string | null;
1522
1522
  /**
1523
- * The secret. Shown once, here, and never again.
1523
+ * The secret. Shown once, here, and never again. Null on an `Idempotency-Key` replay of a mint (`Idempotent-Replay: true`): the secret is never stored, so rotate the key (`POST /api-keys/{id}/rotate`), or revoke it and mint again.
1524
1524
  */
1525
- token: string;
1525
+ token: string | null;
1526
1526
  };
1527
1527
  type AppPassword = {
1528
1528
  id: string;
@@ -1575,6 +1575,18 @@ type Me = {
1575
1575
  * ISO-8601, UTC.
1576
1576
  */
1577
1577
  created_at: string;
1578
+ /**
1579
+ * A test-mode key (`pgn_test_`): its mail never leaves Pidgeon and counts against nothing. Read this rather than the token’s prefix.
1580
+ */
1581
+ test: boolean;
1582
+ /**
1583
+ * When the key was last given a new secret by `POST /api-keys/{id}/rotate`, or null.
1584
+ */
1585
+ rotated_at: string | null;
1586
+ /**
1587
+ * While the secret it had before its last rotation still works, when that stops. Null when it has stopped or there was no grace period.
1588
+ */
1589
+ previous_token_expires_at: string | null;
1578
1590
  } | null;
1579
1591
  workspace: {
1580
1592
  id: string;
@@ -2380,7 +2392,7 @@ type IdentitiesCreateErrors = {
2380
2392
  */
2381
2393
  404: Error;
2382
2394
  /**
2383
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
2395
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
2384
2396
  */
2385
2397
  409: Error;
2386
2398
  /**
@@ -3265,7 +3277,7 @@ type PodsCreateErrors = {
3265
3277
  */
3266
3278
  404: Error;
3267
3279
  /**
3268
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
3280
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
3269
3281
  */
3270
3282
  409: Error;
3271
3283
  /**
@@ -3556,7 +3568,7 @@ type LabelsCreateErrors = {
3556
3568
  */
3557
3569
  404: Error;
3558
3570
  /**
3559
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
3571
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
3560
3572
  */
3561
3573
  409: Error;
3562
3574
  /**
@@ -4010,7 +4022,7 @@ type MessagesSendErrors = {
4010
4022
  */
4011
4023
  404: Error;
4012
4024
  /**
4013
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
4025
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
4014
4026
  */
4015
4027
  409: Error;
4016
4028
  /**
@@ -4466,7 +4478,7 @@ type MessagesReplyErrors = {
4466
4478
  */
4467
4479
  404: Error;
4468
4480
  /**
4469
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
4481
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
4470
4482
  */
4471
4483
  409: Error;
4472
4484
  /**
@@ -4566,7 +4578,7 @@ type MessagesReplyAllErrors = {
4566
4578
  */
4567
4579
  404: Error;
4568
4580
  /**
4569
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
4581
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
4570
4582
  */
4571
4583
  409: Error;
4572
4584
  /**
@@ -4666,7 +4678,7 @@ type MessagesForwardErrors = {
4666
4678
  */
4667
4679
  404: Error;
4668
4680
  /**
4669
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
4681
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
4670
4682
  */
4671
4683
  409: Error;
4672
4684
  /**
@@ -5074,7 +5086,7 @@ type DomainsCreateErrors = {
5074
5086
  */
5075
5087
  404: Error;
5076
5088
  /**
5077
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
5089
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
5078
5090
  */
5079
5091
  409: Error;
5080
5092
  /**
@@ -5529,7 +5541,7 @@ type RoutingCreateErrors = {
5529
5541
  */
5530
5542
  404: Error;
5531
5543
  /**
5532
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
5544
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
5533
5545
  */
5534
5546
  409: Error;
5535
5547
  /**
@@ -6002,6 +6014,12 @@ type KeysCreateData = {
6002
6014
  */
6003
6015
  test?: boolean;
6004
6016
  };
6017
+ headers?: {
6018
+ /**
6019
+ * Any string unique to this attempt, reused on its retries. A repeat with the same key and the same request returns the first answer with `Idempotent-Replay: true` and does nothing — no second email. The same key with a different request is a `409`. Kept for 24 hours; a failure is not kept, so a retry after one runs.
6020
+ */
6021
+ 'Idempotency-Key'?: string;
6022
+ };
6005
6023
  path?: never;
6006
6024
  query?: never;
6007
6025
  url: '/api-keys';
@@ -6028,7 +6046,7 @@ type KeysCreateErrors = {
6028
6046
  */
6029
6047
  404: Error;
6030
6048
  /**
6031
- * It conflicts with what is there: it already exists, or the `etag` you sent is not the current one.
6049
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
6032
6050
  */
6033
6051
  409: Error;
6034
6052
  /**
@@ -6343,7 +6361,7 @@ type TestInboundErrors = {
6343
6361
  */
6344
6362
  404: Error;
6345
6363
  /**
6346
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
6364
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
6347
6365
  */
6348
6366
  409: Error;
6349
6367
  /**
@@ -7025,7 +7043,7 @@ type WebhooksCreateErrors = {
7025
7043
  */
7026
7044
  404: Error;
7027
7045
  /**
7028
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
7046
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
7029
7047
  */
7030
7048
  409: Error;
7031
7049
  /**
@@ -7466,7 +7484,7 @@ type MessagesRespondToInvitationErrors = {
7466
7484
  */
7467
7485
  404: Error;
7468
7486
  /**
7469
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
7487
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
7470
7488
  */
7471
7489
  409: Error;
7472
7490
  /**
@@ -7737,7 +7755,7 @@ type CalendarCreateEventErrors = {
7737
7755
  */
7738
7756
  404: Error;
7739
7757
  /**
7740
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
7758
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
7741
7759
  */
7742
7760
  409: Error;
7743
7761
  /**
@@ -7808,7 +7826,7 @@ type CalendarRespondToEventErrors = {
7808
7826
  */
7809
7827
  404: Error;
7810
7828
  /**
7811
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
7829
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
7812
7830
  */
7813
7831
  409: Error;
7814
7832
  /**
@@ -8012,7 +8030,7 @@ type CalendarDeleteEventErrors = {
8012
8030
  */
8013
8031
  404: Error;
8014
8032
  /**
8015
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
8033
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
8016
8034
  */
8017
8035
  409: Error;
8018
8036
  /**
@@ -8170,7 +8188,7 @@ type CalendarUpdateEventErrors = {
8170
8188
  */
8171
8189
  404: Error;
8172
8190
  /**
8173
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
8191
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
8174
8192
  */
8175
8193
  409: Error;
8176
8194
  /**
@@ -8346,7 +8364,7 @@ type DraftsCreateErrors = {
8346
8364
  */
8347
8365
  404: Error;
8348
8366
  /**
8349
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
8367
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
8350
8368
  */
8351
8369
  409: Error;
8352
8370
  /**
@@ -8606,7 +8624,7 @@ type DraftsSendErrors = {
8606
8624
  */
8607
8625
  404: Error;
8608
8626
  /**
8609
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
8627
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
8610
8628
  */
8611
8629
  409: Error;
8612
8630
  /**
@@ -8722,7 +8740,7 @@ type DraftsScheduleErrors = {
8722
8740
  */
8723
8741
  404: Error;
8724
8742
  /**
8725
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
8743
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
8726
8744
  */
8727
8745
  409: Error;
8728
8746
  /**
package/dist/index.d.ts CHANGED
@@ -1520,9 +1520,9 @@ type ApiKeyCreated = {
1520
1520
  */
1521
1521
  previous_token_expires_at: string | null;
1522
1522
  /**
1523
- * The secret. Shown once, here, and never again.
1523
+ * The secret. Shown once, here, and never again. Null on an `Idempotency-Key` replay of a mint (`Idempotent-Replay: true`): the secret is never stored, so rotate the key (`POST /api-keys/{id}/rotate`), or revoke it and mint again.
1524
1524
  */
1525
- token: string;
1525
+ token: string | null;
1526
1526
  };
1527
1527
  type AppPassword = {
1528
1528
  id: string;
@@ -1575,6 +1575,18 @@ type Me = {
1575
1575
  * ISO-8601, UTC.
1576
1576
  */
1577
1577
  created_at: string;
1578
+ /**
1579
+ * A test-mode key (`pgn_test_`): its mail never leaves Pidgeon and counts against nothing. Read this rather than the token’s prefix.
1580
+ */
1581
+ test: boolean;
1582
+ /**
1583
+ * When the key was last given a new secret by `POST /api-keys/{id}/rotate`, or null.
1584
+ */
1585
+ rotated_at: string | null;
1586
+ /**
1587
+ * While the secret it had before its last rotation still works, when that stops. Null when it has stopped or there was no grace period.
1588
+ */
1589
+ previous_token_expires_at: string | null;
1578
1590
  } | null;
1579
1591
  workspace: {
1580
1592
  id: string;
@@ -2380,7 +2392,7 @@ type IdentitiesCreateErrors = {
2380
2392
  */
2381
2393
  404: Error;
2382
2394
  /**
2383
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
2395
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
2384
2396
  */
2385
2397
  409: Error;
2386
2398
  /**
@@ -3265,7 +3277,7 @@ type PodsCreateErrors = {
3265
3277
  */
3266
3278
  404: Error;
3267
3279
  /**
3268
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
3280
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
3269
3281
  */
3270
3282
  409: Error;
3271
3283
  /**
@@ -3556,7 +3568,7 @@ type LabelsCreateErrors = {
3556
3568
  */
3557
3569
  404: Error;
3558
3570
  /**
3559
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
3571
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
3560
3572
  */
3561
3573
  409: Error;
3562
3574
  /**
@@ -4010,7 +4022,7 @@ type MessagesSendErrors = {
4010
4022
  */
4011
4023
  404: Error;
4012
4024
  /**
4013
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
4025
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
4014
4026
  */
4015
4027
  409: Error;
4016
4028
  /**
@@ -4466,7 +4478,7 @@ type MessagesReplyErrors = {
4466
4478
  */
4467
4479
  404: Error;
4468
4480
  /**
4469
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
4481
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
4470
4482
  */
4471
4483
  409: Error;
4472
4484
  /**
@@ -4566,7 +4578,7 @@ type MessagesReplyAllErrors = {
4566
4578
  */
4567
4579
  404: Error;
4568
4580
  /**
4569
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
4581
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
4570
4582
  */
4571
4583
  409: Error;
4572
4584
  /**
@@ -4666,7 +4678,7 @@ type MessagesForwardErrors = {
4666
4678
  */
4667
4679
  404: Error;
4668
4680
  /**
4669
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
4681
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
4670
4682
  */
4671
4683
  409: Error;
4672
4684
  /**
@@ -5074,7 +5086,7 @@ type DomainsCreateErrors = {
5074
5086
  */
5075
5087
  404: Error;
5076
5088
  /**
5077
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
5089
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
5078
5090
  */
5079
5091
  409: Error;
5080
5092
  /**
@@ -5529,7 +5541,7 @@ type RoutingCreateErrors = {
5529
5541
  */
5530
5542
  404: Error;
5531
5543
  /**
5532
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
5544
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
5533
5545
  */
5534
5546
  409: Error;
5535
5547
  /**
@@ -6002,6 +6014,12 @@ type KeysCreateData = {
6002
6014
  */
6003
6015
  test?: boolean;
6004
6016
  };
6017
+ headers?: {
6018
+ /**
6019
+ * Any string unique to this attempt, reused on its retries. A repeat with the same key and the same request returns the first answer with `Idempotent-Replay: true` and does nothing — no second email. The same key with a different request is a `409`. Kept for 24 hours; a failure is not kept, so a retry after one runs.
6020
+ */
6021
+ 'Idempotency-Key'?: string;
6022
+ };
6005
6023
  path?: never;
6006
6024
  query?: never;
6007
6025
  url: '/api-keys';
@@ -6028,7 +6046,7 @@ type KeysCreateErrors = {
6028
6046
  */
6029
6047
  404: Error;
6030
6048
  /**
6031
- * It conflicts with what is there: it already exists, or the `etag` you sent is not the current one.
6049
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
6032
6050
  */
6033
6051
  409: Error;
6034
6052
  /**
@@ -6343,7 +6361,7 @@ type TestInboundErrors = {
6343
6361
  */
6344
6362
  404: Error;
6345
6363
  /**
6346
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
6364
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
6347
6365
  */
6348
6366
  409: Error;
6349
6367
  /**
@@ -7025,7 +7043,7 @@ type WebhooksCreateErrors = {
7025
7043
  */
7026
7044
  404: Error;
7027
7045
  /**
7028
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
7046
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
7029
7047
  */
7030
7048
  409: Error;
7031
7049
  /**
@@ -7466,7 +7484,7 @@ type MessagesRespondToInvitationErrors = {
7466
7484
  */
7467
7485
  404: Error;
7468
7486
  /**
7469
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
7487
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
7470
7488
  */
7471
7489
  409: Error;
7472
7490
  /**
@@ -7737,7 +7755,7 @@ type CalendarCreateEventErrors = {
7737
7755
  */
7738
7756
  404: Error;
7739
7757
  /**
7740
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
7758
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
7741
7759
  */
7742
7760
  409: Error;
7743
7761
  /**
@@ -7808,7 +7826,7 @@ type CalendarRespondToEventErrors = {
7808
7826
  */
7809
7827
  404: Error;
7810
7828
  /**
7811
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
7829
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
7812
7830
  */
7813
7831
  409: Error;
7814
7832
  /**
@@ -8012,7 +8030,7 @@ type CalendarDeleteEventErrors = {
8012
8030
  */
8013
8031
  404: Error;
8014
8032
  /**
8015
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
8033
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
8016
8034
  */
8017
8035
  409: Error;
8018
8036
  /**
@@ -8170,7 +8188,7 @@ type CalendarUpdateEventErrors = {
8170
8188
  */
8171
8189
  404: Error;
8172
8190
  /**
8173
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
8191
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
8174
8192
  */
8175
8193
  409: Error;
8176
8194
  /**
@@ -8346,7 +8364,7 @@ type DraftsCreateErrors = {
8346
8364
  */
8347
8365
  404: Error;
8348
8366
  /**
8349
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
8367
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
8350
8368
  */
8351
8369
  409: Error;
8352
8370
  /**
@@ -8606,7 +8624,7 @@ type DraftsSendErrors = {
8606
8624
  */
8607
8625
  404: Error;
8608
8626
  /**
8609
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
8627
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
8610
8628
  */
8611
8629
  409: Error;
8612
8630
  /**
@@ -8722,7 +8740,7 @@ type DraftsScheduleErrors = {
8722
8740
  */
8723
8741
  404: Error;
8724
8742
  /**
8725
- * This `Idempotency-Key` was used with a different request, or that request is still running. Nothing was sent by this call.
8743
+ * Nothing was done by this call. `error.code` says which: `idempotency_in_progress` when the first request with this `Idempotency-Key` has not answered yet (wait `Retry-After` seconds and send it again), `idempotency_mismatch` when the key was used with a different request (use a new key).
8726
8744
  */
8727
8745
  409: Error;
8728
8746
  /**
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pidgeon-ai/sdk",
3
- "version": "1.34.0",
3
+ "version": "1.35.0",
4
4
  "description": "Email inboxes for AI agents — TypeScript SDK for Pidgeon: create addresses, send, receive and reply.",
5
5
  "keywords": [
6
6
  "email",