fix: KnockGuideStep type definition to return a promise from async methods

.changeset/yellow-worlds-smile.md

@@ -0,0 +1,5 @@
+---
+"@knocklabs/client": patch
+---
+
+[guides] fix: KnockGuideStep type definition to return a promise from async methods

.tool-versions

@@ -1,2 +1,2 @@
-nodejs 22.17.0
+nodejs 24.12.0
 yarn 1.22.22

package.json

@@ -52,6 +52,6 @@
     "vitest": "^3.1.1"
   },
   "engines": {
-    "node": "22.17.0"
+    "node": ">=24.10.0"
   }
 }

packages/client/src/clients/guide/client.ts

@@ -952,17 +952,12 @@ export class KnockGuideClient {
         ...rest,
         message: { ...message },
         markAsSeen() {
-          // Send a seen event if it has not been previously seen.
-          if (this.message.seen_at) return;
           return self.markAsSeen(localGuide, this);
         },
         markAsInteracted({ metadata }: { metadata?: GenericData } = {}) {
-          // Always send an interaction event through.
           return self.markAsInteracted(localGuide, this, metadata);
         },
         markAsArchived() {
-          // Send an archived event if it has not been previously archived.
-          if (this.message.archived_at) return;
           return self.markAsArchived(localGuide, this);
         },
       };

packages/client/src/clients/guide/types.ts

@@ -166,9 +166,11 @@ export type GuideSocketEvent =
 
 export interface KnockGuideStep<TContent = Any>
   extends GuideStepData<TContent> {
-  markAsSeen: () => void;
-  markAsInteracted: (params?: { metadata?: GenericData }) => void;
-  markAsArchived: () => void;
+  markAsSeen: () => Promise<KnockGuideStep<TContent> | undefined>;
+  markAsInteracted: (params?: {
+    metadata?: GenericData;
+  }) => Promise<KnockGuideStep<TContent> | undefined>;
+  markAsArchived: () => Promise<KnockGuideStep<TContent> | undefined>;
 }
 
 export interface KnockGuideActivationUrlPattern