@chronary/sdk 0.7.1 → 0.9.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
@@ -2,6 +2,35 @@
2
2
 
3
3
  All notable changes to `@chronary/sdk` will be documented in this file starting with the soft-launch release.
4
4
 
5
+ ## 0.9.0 — Unreleased
6
+
7
+ - A 429 `quota_exceeded` (a monthly plan limit) is no longer retried: the request rejects with `QuotaExceededError` at once instead of sleeping on `Retry-After` and asking again. A rate-limit 429 still retries, waiting at most 60 seconds (#1936).
8
+ - Add the `developer` plan: `PlanId` includes it, `Plan.annual_price`, `BillingSummary.pending_plan` / `pending_plan_interval` / `pending_plan_at`, `BillingUpgradeOption.plan` (`developer` | `pro`) and `via`, `UpgradeRequest.plan`. Errors expose `upgradePlan` (the plan `upgradeUrl` leads to). Additive; `BillingSummary.plan` stays a plain string (#1911).
9
+
10
+ ## 0.8.1 — 2026-11-09
11
+
12
+ - Internal hardening of `baseUrl` normalisation and `RateLimit` header parsing. No API change.
13
+ - `waitlist.join()` now resolves to `{ waitlisted: true, message }` (HTTP 202) for every email, whether new, already on the list or with an active account. It no longer returns the entry (`data`) and no longer throws 409 `email_taken`. `WaitlistJoinParams` gains `intent`; `WaitlistedOrg` is deprecated (#1655).
14
+ - `agentAuth.signUp()` types the 202 sent while sign-ups are paused: `AgentSignUpWaitlistedResponse` (`{ waitlisted: true, message }`, no `org_id`) (#1655).
15
+
16
+ ## 0.8.0 — 2026-10-19
17
+
18
+ - Add the `billing` resource: `billing.get()` and `billing.upgradeRequests.create/get/cancel` so an agent can read plan status and ask its human to upgrade (#1129).
19
+ - Add `PlanRequiredError` (403 `plan_required`). Errors now expose `upgradeUrl`, `docsUrl`, `requiredPlan`, `feature`, `contactUrl`, `metric`, `limit` and the raw `body`.
20
+ - Fix `QuotaExceededError` reporting status 402 for HTTP 429 responses; it now keeps the real status.
21
+ - Add the `org.plan_changed` webhook event type: fires once when the account's plan changes, so agents don't have to poll billing (#1130).
22
+ - Type `BillingSummary.offer` as `BillingOffer | null` — the founding member offer for early-access accounts (`upcoming` / `available` / `redeemed`) (#1121).
23
+ - Add the `calendar_connection.reauthorization_required` webhook event type: fires once when a connected human calendar stops accepting access, so agents learn their availability now fails closed (#1196).
24
+ - Add `connectionLinks.list({ status, calendar_id, limit })` and the setup details on connection links (`requesting_agent_id`, `requested_capabilities`, `requested_publication_policy`, `created_at`) (#1196).
25
+ - Add `webhooks.getDelivery(webhookId, deliveryId)`: one delivery with its attempt timeline (`attempt_log`: HTTP status, duration, response body prefix, error code). Deliveries in `listDeliveries` gain `last_response_status`, `last_error_code` and `last_duration_ms` (#1200).
26
+ - Add `webhooks.sendTest(webhookId, { event_type })`: sends a signed sample payload once (`is_test`, `X-Chronary-Test: 1`, quota-exempt). Deliveries gain `is_test`, and `Webhook` gains `deactivatedAt` and `deactivatedReason` (`manual`, `circuit_breaker`, `unsafe_destination_url`, `account_deletion`) (#1200).
27
+ - `webhooks.listDeliveries` takes `event_type` (exact, or a prefix ending in a dot such as `event.`), `created_after`, `created_before`, `delivery_id`, `is_test` and `cursor`, and returns `next_cursor` and `has_more`. Delivery `status` gains `dropped` (a Free-plan delivery the monthly limit stopped, `last_error_code: 'quota_exceeded'`), and `stats` gains `dropped` (#1200).
28
+ - Add `events.listAll({ calendar_id, agent_id, start_after, start_before, status, source, q, expand })`: events across all of the organization's calendars (`GET /v1/events`), with title search inside a window of at most 31 days. Add `calendars.rotateIcalToken(id)` to regenerate a calendar's subscribe URL, and a `q` search on `calendars.list()`. Array query values are sent as repeated parameters (#1202).
29
+ - Add `bookingPages.listBookings(id, { limit, cursor })`: the bookings made through a page with the invitee's name, email and notes, newest first, paged by `next_cursor`. Add `bookingPages.rotateSlug(id)` to replace a page's public link, and a `calendar_id` filter on `bookingPages.list()` (#1202).
30
+ - Add `webhooks.replayDelivery(webhookId, deliveryId)` (Pro): sends a `failed` or `dropped` delivery again as a new delivery, with an `X-Chronary-Replay-Of` header naming the original. It counts toward the monthly delivery quota. Add the `WebhookReplaySent` type. Deliveries gain `replay_of_delivery_id`, and the delivery detail's `request_headers` gains `x-chronary-replay-of` on a replay (#588).
31
+ - **Webhook secret rotation (#594).** `verifySignature` and `constructEvent` now accept a delivery when the secret matches either `X-Signature` or `X-Signature-Previous`. During a rotation's grace window Chronary sends both headers, the second signed with the replaced secret, so a receiver can switch secrets without rejecting deliveries. Update before you rotate a secret. Add `webhooks.rotateSecret(webhookId, { expire_old_in })` (Pro): returns the new secret once, and the old one keeps working for `now`, `1h`, `24h` (default) or `7d`. `Webhook` gains `previousSecretExpiresAt`.
32
+ - Type `Event.holdPriority` as `number` (was `number | null`). The API has always sent a number: `0` unless a hold set a priority. Code that compares it to `null` now gets a TypeScript "no overlap" error and can drop the check; nothing changes at runtime (#1446).
33
+
5
34
  ## 0.7.1 — 2026-07-14
6
35
 
7
36
  - Docs-only: neutral wording for the booking-page type (no competitor references). No API change.
package/README.md CHANGED
@@ -65,10 +65,11 @@ Chronary enforces a per-key rate limit and per-org monthly quotas that vary by p
65
65
  |---|---|---|
66
66
  | Rate limit | 10 req/s | 50 req/s |
67
67
  | Webhook delivery retries | 4 | 8 |
68
- | Agents | 3 | 50 |
69
- | Calendars | 10 | 250 |
70
- | Events / mo | 2,500 | 125,000 |
71
- | API calls / mo | 50,000 | 1,000,000 |
68
+ | Agents | 1 | 50 |
69
+ | Calendars | 1 | 250 |
70
+ | Events / mo | 100 | 125,000 |
71
+ | API calls / mo | 1,000 | 1,000,000 |
72
+ | Webhook deliveries / mo | 1,000 | 250,000 |
72
73
  | Pro-only features | — | Scheduling proposals, temporal holds, cross-calendar availability, per-agent API keys (`chr_ak_*`) |
73
74
 
74
75
  Pro-only feature calls return `403` with an upgrade hint on Free. See the full matrix and rate-limit handling guidance at <https://docs.chronary.ai/resources/rate-limits/>.
@@ -82,6 +83,12 @@ const event = await Chronary.webhooks.constructEvent(rawBody, headers, secret);
82
83
  // event.type comes from X-Chronary-Event-Type; event.data is the parsed payload body.
83
84
  ```
84
85
 
86
+ ## Security and support
87
+
88
+ Report vulnerabilities to [security@chronary.ai](mailto:security@chronary.ai) or through private vulnerability reporting on this package's GitHub repository. Please don't open a public issue. Read the full [security policy](https://github.com/Chronary/.github/blob/main/SECURITY.md).
89
+
90
+ Version 0.x is supported with security fixes until at least **April 2031**. Fixes ship in a new 0.x release, so keep up with the latest one. Supported versions and end dates for every Chronary package are listed in the [security policy](https://github.com/Chronary/.github/blob/main/SECURITY.md#supported-versions).
91
+
85
92
  ## License
86
93
 
87
94
  Apache-2.0