vessels-sdk 0.4.1 → 0.5.0

package/dist/index.cjs

@@ -178,7 +178,8 @@ var Vessels = class {
         type: "message.user",
         timestamp: e.timestamp,
         vessel,
-        message: { id: e.message?.id, content: e.message?.content ?? null }
+        message: { id: e.message?.id, content: e.message?.content ?? null },
+        context: []
       };
     });
     return { ok: true, events, hasMore: data.has_more ?? false };
@@ -209,6 +210,55 @@ var Vessels = class {
       return false;
     }
   }
+  // Verify + parse in one call. Returns a typed event or null (invalid signature or unknown type).
+  // body: raw request body string (before JSON.parse)
+  // signature: X-Vessels-Signature header value
+  // webhookSecret: the secret shown when you created the webhook endpoint in Settings
+  async parseWebhookEvent(body, signature, webhookSecret) {
+    const valid = await this.verifyWebhook(body, signature, webhookSecret);
+    if (!valid) return null;
+    try {
+      const raw = JSON.parse(body);
+      const v = raw.data?.vessel ?? {};
+      const vessel = {
+        id: v.id,
+        externalId: v.external_id ?? null,
+        title: v.title ?? null,
+        metadata: v.metadata ?? {},
+        labels: v.labels ?? []
+      };
+      if (raw.event === "interaction.response") {
+        return {
+          id: raw.data.response_id,
+          type: "interaction.response",
+          timestamp: raw.timestamp,
+          vessel,
+          messageId: raw.data.message_id,
+          interactionType: raw.data.interaction_type,
+          response: raw.data.response,
+          interactionMetadata: raw.data.metadata ?? null,
+          user: raw.data.user ?? null
+        };
+      }
+      if (raw.event === "message.user") {
+        return {
+          id: raw.data.message_id,
+          type: "message.user",
+          timestamp: raw.timestamp,
+          vessel,
+          message: { id: raw.data.message_id, content: raw.data.content ?? null },
+          context: (raw.data.context ?? []).map((m) => ({
+            source: m.source,
+            content: m.content ?? null,
+            createdAt: m.created_at
+          }))
+        };
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
 };
 
 exports.AgentActivityTypes = AgentActivityTypes;

package/dist/index.d.cts

@@ -74,6 +74,11 @@ interface UserMessageEvent {
         id: string;
         content: string | null;
     };
+    context: Array<{
+        source: string;
+        content: string | null;
+        createdAt: string;
+    }>;
 }
 type PollEvent = InteractionResponseEvent | UserMessageEvent;
 interface PollResponse {
@@ -138,6 +143,7 @@ declare class Vessels {
     }): _vessels_types.ConfirmPreviewInteraction;
     poll(options?: PollOptions): Promise<PollResponse>;
     verifyWebhook(body: string, signature: string, webhookSecret: string): Promise<boolean>;
+    parseWebhookEvent(body: string, signature: string, webhookSecret: string): Promise<InteractionResponseEvent | UserMessageEvent | null>;
 }
 
 export { AgentActivityTypes, type InteractionResponseEvent, type PollEvent, type PollOptions, type PollResponse, type PushManyResult, type PushResponse, type UserMessageEvent, type VesselContext, Vessels, VesselsAuthError, type VesselsConfig, VesselsRateLimitError, VesselsValidationError };

package/dist/index.d.ts

@@ -74,6 +74,11 @@ interface UserMessageEvent {
         id: string;
         content: string | null;
     };
+    context: Array<{
+        source: string;
+        content: string | null;
+        createdAt: string;
+    }>;
 }
 type PollEvent = InteractionResponseEvent | UserMessageEvent;
 interface PollResponse {
@@ -138,6 +143,7 @@ declare class Vessels {
     }): _vessels_types.ConfirmPreviewInteraction;
     poll(options?: PollOptions): Promise<PollResponse>;
     verifyWebhook(body: string, signature: string, webhookSecret: string): Promise<boolean>;
+    parseWebhookEvent(body: string, signature: string, webhookSecret: string): Promise<InteractionResponseEvent | UserMessageEvent | null>;
 }
 
 export { AgentActivityTypes, type InteractionResponseEvent, type PollEvent, type PollOptions, type PollResponse, type PushManyResult, type PushResponse, type UserMessageEvent, type VesselContext, Vessels, VesselsAuthError, type VesselsConfig, VesselsRateLimitError, VesselsValidationError };

package/dist/index.js

@@ -176,7 +176,8 @@ var Vessels = class {
         type: "message.user",
         timestamp: e.timestamp,
         vessel,
-        message: { id: e.message?.id, content: e.message?.content ?? null }
+        message: { id: e.message?.id, content: e.message?.content ?? null },
+        context: []
       };
     });
     return { ok: true, events, hasMore: data.has_more ?? false };
@@ -207,6 +208,55 @@ var Vessels = class {
       return false;
     }
   }
+  // Verify + parse in one call. Returns a typed event or null (invalid signature or unknown type).
+  // body: raw request body string (before JSON.parse)
+  // signature: X-Vessels-Signature header value
+  // webhookSecret: the secret shown when you created the webhook endpoint in Settings
+  async parseWebhookEvent(body, signature, webhookSecret) {
+    const valid = await this.verifyWebhook(body, signature, webhookSecret);
+    if (!valid) return null;
+    try {
+      const raw = JSON.parse(body);
+      const v = raw.data?.vessel ?? {};
+      const vessel = {
+        id: v.id,
+        externalId: v.external_id ?? null,
+        title: v.title ?? null,
+        metadata: v.metadata ?? {},
+        labels: v.labels ?? []
+      };
+      if (raw.event === "interaction.response") {
+        return {
+          id: raw.data.response_id,
+          type: "interaction.response",
+          timestamp: raw.timestamp,
+          vessel,
+          messageId: raw.data.message_id,
+          interactionType: raw.data.interaction_type,
+          response: raw.data.response,
+          interactionMetadata: raw.data.metadata ?? null,
+          user: raw.data.user ?? null
+        };
+      }
+      if (raw.event === "message.user") {
+        return {
+          id: raw.data.message_id,
+          type: "message.user",
+          timestamp: raw.timestamp,
+          vessel,
+          message: { id: raw.data.message_id, content: raw.data.content ?? null },
+          context: (raw.data.context ?? []).map((m) => ({
+            source: m.source,
+            content: m.content ?? null,
+            createdAt: m.created_at
+          }))
+        };
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
 };
 
 export { AgentActivityTypes, Vessels, VesselsAuthError, VesselsRateLimitError, VesselsValidationError };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "vessels-sdk",
-	"version": "0.4.1",
+	"version": "0.5.0",
 	"description": "Let your agent reach you. Official Vessels SDK.",
 	"type": "module",
 	"exports": {