seam 1.237.0 → 1.239.0

package/README.md

@@ -254,6 +254,31 @@ When the `waitForActionAttempt` option is enabled, the SDK:
 - Rejects with a `SeamActionAttemptTimeoutError` if the action attempt is still pending when the `timeout` is reached.
 - Both errors expose an `actionAttempt` property.
 
+The `ActionAttempt` type is a union discriminated by `action_type` and `status`.
+The `error` and `result` properties are typed as `null`
+except for the status that populates them,
+so narrow on the `status` before reading them:
+
+```ts
+const actionAttempt = await seam.locks.unlockDoor(
+  { device_id },
+  { waitForActionAttempt: false },
+)
+
+if (actionAttempt.status === 'success') {
+  console.log(actionAttempt.result) // The result is non-null here.
+}
+
+if (actionAttempt.status === 'error') {
+  console.log(actionAttempt.error.message) // The error is non-null here.
+}
+```
+
+Waiting for an action attempt resolves with the successful action attempt,
+so after checking `status === 'success'` the `result` is immediately usable.
+Use the `SucceededActionAttempt` and `FailedActionAttempt` types
+to extract the success and error members from any action attempt type.
+
 If you already have an action attempt ID
 and want to wait for it to resolve, simply use
 
@@ -916,6 +941,24 @@ Use it to parse and validate [Seam webhook events](https://docs.seam.co/latest/d
 Refer to the [Svix docs on Consuming Webhooks](https://docs.svix.com/receiving/introduction)
 for an in-depth guide on best-practices for handling webhooks in your application.
 
+Verification failures throw Svix's `WebhookVerificationError`, re-exported as
+`SeamWebhookVerificationError`.
+A payload that is correctly signed but unreadable throws a `SeamInvalidWebhookPayloadError`.
+
+```js
+import { isSeamInvalidWebhookPayloadError, SeamWebhook } from 'seam'
+
+try {
+  data = webhook.verify(req.body, req.headers)
+} catch (err) {
+  if (isSeamInvalidWebhookPayloadError(err)) {
+    console.error('Unreadable Seam webhook payload', err)
+    return res.status(204).send()
+  }
+  return res.status(400).send()
+}
+```
+
 > [!TIP]
 > This example is for [Express](https://expressjs.com/),
 > see the [Svix docs for more examples in specific frameworks](https://docs.svix.com/receiving/verifying-payloads/how).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seam",
-  "version": "1.237.0",
+  "version": "1.239.0",
   "description": "JavaScript SDK for the Seam API written in TypeScript.",
   "type": "module",
   "main": "index.js",
@@ -76,8 +76,8 @@
   "packageManager": "npm@11.19.0",
   "dependencies": {
     "@seamapi/cli": "0.37.0",
-    "@seamapi/http": "2.26.0",
-    "@seamapi/webhook": "1.4.1"
+    "@seamapi/http": "2.27.0",
+    "@seamapi/webhook": "1.5.0"
   },
   "devDependencies": {
     "@types/node": "^24.10.9",