@knocklabs/client 0.9.4 → 0.10.1

package/dist/types/clients/slack/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../src/clients/slack/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../../src/clients/slack/interfaces.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,IAAI,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE;QACb,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,cAAc,EAAE,YAAY,EAAE,CAAC;IAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC"}

package/dist/types/index.d.ts

@@ -9,6 +9,9 @@ export * from "./clients/preferences/interfaces";
 export * from "./clients/slack";
 export * from "./clients/slack/interfaces";
 export * from "./clients/users";
+export * from "./clients/users/interfaces";
+export * from "./clients/messages";
+export * from "./clients/messages/interfaces";
 export * from "./networkStatus";
 export default Knock;
 export { Feed, FeedClient };

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,MAAM,SAAS,CAAC;AAE5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAEhC,eAAe,KAAK,CAAC;AACrB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,EAAE,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,MAAM,SAAS,CAAC;AAE5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iBAAiB,CAAC;AAEhC,eAAe,KAAK,CAAC;AACrB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC"}

package/dist/types/interfaces.d.ts

@@ -21,6 +21,10 @@ export interface User extends GenericData {
     created_at: string | null;
 }
 export type Recipient = User | KnockObject;
+export type RecipientRef = string | {
+    collection: string;
+    id: string;
+};
 export interface Activity<T = GenericData> {
     id: string;
     inserted_at: string;
@@ -38,4 +42,16 @@ export interface AuthenticateOptions {
     onUserTokenExpiring?: UserTokenExpiringCallback;
     timeBeforeExpirationInMs?: number;
 }
+export interface BulkOperation {
+    id: string;
+    name: string;
+    status: "queued" | "processing" | "completed" | "failed";
+    processed_rows: number;
+    estimated_total_rows: number;
+    started_at?: string;
+    completed_at?: string;
+    failed_at?: string;
+    inserted_at: string;
+    updated_at: string;
+}
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/types/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,WAAW;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,CAAC,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,WAAW,CAAC;AAE3C,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,WAAW;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,GAAG,KACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5B,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;IAChD,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,WAAW;IAC1C,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,CAAC,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,WAAW,CAAC;AAE3C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,WAAW;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;CAChB;AAED,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,GAAG;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CAAC,CAAC;CACT;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,GAAG,KACd,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5B,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,CAAC,EAAE,yBAAyB,CAAC;IAChD,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/knock.d.ts

@@ -1,5 +1,6 @@
 import ApiClient from "./api";
 import FeedClient from "./clients/feed";
+import MessageClient from "./clients/messages";
 import ObjectClient from "./clients/objects";
 import Preferences from "./clients/preferences";
 import SlackClient from "./clients/slack";
@@ -18,6 +19,7 @@ declare class Knock {
     readonly preferences: Preferences;
     readonly slack: SlackClient;
     readonly user: UserClient;
+    readonly messages: MessageClient;
     constructor(apiKey: string, options?: KnockOptions);
     client(): ApiClient;
     authenticate(userId: string, userToken?: string, options?: AuthenticateOptions): void;

package/dist/types/knock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"knock.d.ts","sourceRoot":"","sources":["../../src/knock.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,MAAM,OAAO,CAAC;AAC9B,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAChD,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EAET,MAAM,cAAc,CAAC;AAItB,cAAM,KAAK;IAcP,QAAQ,CAAC,MAAM,EAAE,MAAM;IAblB,IAAI,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,SAAS,CAA0B;IACpC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC3B,OAAO,CAAC,oBAAoB,CAA8C;IAC1E,QAAQ,CAAC,KAAK,aAAwB;IACtC,QAAQ,CAAC,OAAO,eAA0B;IAC1C,QAAQ,CAAC,WAAW,cAAyB;IAC7C,QAAQ,CAAC,KAAK,cAAyB;IACvC,QAAQ,CAAC,IAAI,aAAwB;gBAG1B,MAAM,EAAE,MAAM,EACvB,OAAO,GAAE,YAAiB;IAe5B,MAAM;IAuBN,YAAY,CACV,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,mBAAmB;IA6C/B,eAAe,CAAC,cAAc,UAAQ;IAKtC,QAAQ;IASR,GAAG,CAAC,OAAO,EAAE,MAAM;IAMnB;;OAEG;IACH,OAAO,CAAC,eAAe;YAQT,gCAAgC;CA8B/C;AAED,eAAe,KAAK,CAAC"}
+{"version":3,"file":"knock.d.ts","sourceRoot":"","sources":["../../src/knock.ts"],"names":[],"mappings":"AAEA,OAAO,SAAS,MAAM,OAAO,CAAC;AAC9B,OAAO,UAAU,MAAM,gBAAgB,CAAC;AACxC,OAAO,aAAa,MAAM,oBAAoB,CAAC;AAC/C,OAAO,YAAY,MAAM,mBAAmB,CAAC;AAC7C,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAChD,OAAO,WAAW,MAAM,iBAAiB,CAAC;AAC1C,OAAO,UAAU,MAAM,iBAAiB,CAAC;AACzC,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,QAAQ,EAET,MAAM,cAAc,CAAC;AAItB,cAAM,KAAK;IAeP,QAAQ,CAAC,MAAM,EAAE,MAAM;IAdlB,IAAI,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,SAAS,CAA0B;IACpC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC3B,OAAO,CAAC,oBAAoB,CAA8C;IAC1E,QAAQ,CAAC,KAAK,aAAwB;IACtC,QAAQ,CAAC,OAAO,eAA0B;IAC1C,QAAQ,CAAC,WAAW,cAAyB;IAC7C,QAAQ,CAAC,KAAK,cAAyB;IACvC,QAAQ,CAAC,IAAI,aAAwB;IACrC,QAAQ,CAAC,QAAQ,gBAA2B;gBAGjC,MAAM,EAAE,MAAM,EACvB,OAAO,GAAE,YAAiB;IAe5B,MAAM;IAuBN,YAAY,CACV,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,mBAAmB;IA6C/B,eAAe,CAAC,cAAc,UAAQ;IAKtC,QAAQ;IASR,GAAG,CAAC,OAAO,EAAE,MAAM;IAMnB;;OAEG;IACH,OAAO,CAAC,eAAe;YAQT,gCAAgC;CA8B/C;AAED,eAAe,KAAK,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knocklabs/client",
-  "version": "0.9.4",
+  "version": "0.10.1",
   "description": "The clientside library for interacting with Knock",
   "homepage": "https://github.com/knocklabs/javascript/tree/main/packages/client",
   "author": "@knocklabs",

package/src/clients/feed/feed.ts

@@ -4,6 +4,10 @@ import { StoreApi } from "zustand";
 
 import Knock from "../../knock";
 import { NetworkStatus, isRequestInFlight } from "../../networkStatus";
+import {
+  BulkUpdateMessagesInChannelProperties,
+  MessageEngagementStatus,
+} from "../messages/interfaces";
 
 import {
   FeedClientOptions,
@@ -24,15 +28,6 @@ import {
   FeedStoreState,
 } from "./types";
 
-export type Status =
-  | "seen"
-  | "read"
-  | "interacted"
-  | "archived"
-  | "unseen"
-  | "unread"
-  | "unarchived";
-
 // Default options to apply
 const feedClientDefaults: Pick<FeedClientOptions, "archived"> = {
   archived: "exclude",
@@ -48,6 +43,7 @@ class Feed {
   private broadcastChannel!: BroadcastChannel | null;
   private disconnectTimer: ReturnType<typeof setTimeout> | null = null;
   private hasSubscribedToRealTimeUpdates: Boolean = false;
+  private visibilityChangeHandler: () => void;
 
   // The raw store instance, used for binding in React and other environments
   public store: StoreApi<FeedStoreState>;
@@ -97,6 +93,8 @@ class Feed {
       this.channel.off("new-message");
     }
 
+    this.teardownAutoSocketManager();
+
     if (this.disconnectTimer) {
       clearTimeout(this.disconnectTimer);
       this.disconnectTimer = null;
@@ -556,7 +554,7 @@ class Feed {
 
   private optimisticallyPerformStatusUpdate(
     itemOrItems: FeedItemOrItems,
-    type: Status,
+    type: MessageEngagementStatus | "unread" | "unseen" | "unarchived",
     attrs: object,
     badgeCountAttr?: "unread_count" | "unseen_count",
   ) {
@@ -605,22 +603,21 @@ class Feed {
     setState((store) => store.setItemAttrs(itemIds, attrs));
   }
 
-  private async makeStatusUpdate(itemOrItems: FeedItemOrItems, type: Status) {
+  private async makeStatusUpdate(
+    itemOrItems: FeedItemOrItems,
+    type: MessageEngagementStatus | "unread" | "unseen" | "unarchived",
+  ) {
     // Always treat items as a batch to use the corresponding batch endpoint
     const items = Array.isArray(itemOrItems) ? itemOrItems : [itemOrItems];
     const itemIds = items.map((item) => item.id);
 
-    const result = await this.knock.client().makeRequest({
-      method: "POST",
-      url: `/v1/messages/batch/${type}`,
-      data: { message_ids: itemIds },
-    });
+    const result = await this.knock.messages.batchUpdateStatuses(itemIds, type);
 
     // Emit the event that these items had their statuses changed
     // Note: we do this after the update to ensure that the server event actually completed
     this.broadcaster.emit(`items.${type}`, { items });
 
-    // Note: `items.type` format is being deprecated in favor over the `items:type` format, 
+    // Note: `items.type` format is being deprecated in favor over the `items:type` format,
     // but emit both formats to make it backward compatible for now.
     this.broadcaster.emit(`items:${type}`, { items });
     this.broadcastOverChannel(`items:${type}`, { items });
@@ -628,13 +625,15 @@ class Feed {
     return result;
   }
 
-  private async makeBulkStatusUpdate(type: "seen" | "read" | "archive") {
+  private async makeBulkStatusUpdate(
+    status: BulkUpdateMessagesInChannelProperties["status"],
+  ) {
     // The base scope for the call should take into account all of the options currently
     // set on the feed, as well as being scoped for the current user. We do this so that
     // we ONLY make changes to the messages that are currently in view on this feed, and not
     // all messages that exist.
     const options = {
-      user_ids: [this.knock.userId],
+      user_ids: [this.knock.userId!],
       engagement_status:
         this.defaultOptions.status !== "all"
           ? this.defaultOptions.status
@@ -646,10 +645,10 @@ class Feed {
         : undefined,
     };
 
-    return await this.knock.client().makeRequest({
-      method: "POST",
-      url: `/v1/channels/${this.feedId}/messages/bulk/${type}`,
-      data: options,
+    return await this.knock.messages.bulkUpdateAllStatusesInChannel({
+      channelId: this.feedId,
+      status,
+      options,
     });
   }
 
@@ -724,9 +723,7 @@ class Feed {
     this.channel.on("new-message", (resp) => this.onNewMessageReceived(resp));
 
     if (this.defaultOptions.auto_manage_socket_connection) {
-      this.setupAutoSocketManager(
-        this.defaultOptions.auto_manage_socket_connection_delay,
-      );
+      this.setupAutoSocketManager();
     }
 
     // If we're initializing but they have previously opted to listen to real-time updates
@@ -741,33 +738,44 @@ class Feed {
    * Listen for changes to document visibility and automatically disconnect
    * or reconnect the socket after a delay
    */
-  private setupAutoSocketManager(autoManageSocketConnectionDelay?: number) {
+  private setupAutoSocketManager() {
+    this.visibilityChangeHandler = this.handleVisibilityChange.bind(this);
+    document.addEventListener("visibilitychange", this.visibilityChangeHandler);
+  }
+
+  private teardownAutoSocketManager() {
+    document.removeEventListener(
+      "visibilitychange",
+      this.visibilityChangeHandler,
+    );
+  }
+
+  private handleVisibilityChange() {
     const disconnectDelay =
-      autoManageSocketConnectionDelay ?? DEFAULT_DISCONNECT_DELAY;
-
-    document.addEventListener("visibilitychange", () => {
-      const client = this.knock.client();
-
-      if (document.visibilityState === "hidden") {
-        // When the tab is hidden, clean up the socket connection after a delay
-        this.disconnectTimer = setTimeout(() => {
-          client.socket?.disconnect();
-          this.disconnectTimer = null;
-        }, disconnectDelay);
-      } else if (document.visibilityState === "visible") {
-        // When the tab is visible, clear the disconnect timer if active to cancel disconnecting
-        // This handles cases where the tab is only briefly hidden to avoid unnecessary disconnects
-        if (this.disconnectTimer) {
-          clearTimeout(this.disconnectTimer);
-          this.disconnectTimer = null;
-        }
+      this.defaultOptions.auto_manage_socket_connection_delay ??
+      DEFAULT_DISCONNECT_DELAY;
+
+    const client = this.knock.client();
+
+    if (document.visibilityState === "hidden") {
+      // When the tab is hidden, clean up the socket connection after a delay
+      this.disconnectTimer = setTimeout(() => {
+        client.socket?.disconnect();
+        this.disconnectTimer = null;
+      }, disconnectDelay);
+    } else if (document.visibilityState === "visible") {
+      // When the tab is visible, clear the disconnect timer if active to cancel disconnecting
+      // This handles cases where the tab is only briefly hidden to avoid unnecessary disconnects
+      if (this.disconnectTimer) {
+        clearTimeout(this.disconnectTimer);
+        this.disconnectTimer = null;
+      }
 
-        // If the socket is not connected, try to reconnect
-        if (!client.socket?.isConnected()) {
-          this.initializeRealtimeConnection();
-        }
+      // If the socket is not connected, try to reconnect
+      if (!client.socket?.isConnected()) {
+        this.initializeRealtimeConnection();
       }
-    });
+    }
   }
 }
 

package/src/clients/feed/interfaces.ts

@@ -2,6 +2,7 @@ import { GenericData, PageInfo } from "@knocklabs/types";
 
 import { Activity, Recipient } from "../../interfaces";
 import { NetworkStatus } from "../../networkStatus";
+import { NotificationSource } from "../messages/interfaces";
 
 // Specific feed interfaces
 
@@ -64,11 +65,6 @@ export interface MarkdownContentBlock extends ContentBlockBase {
   content: string;
 }
 
-export interface NotificationSource {
-  key: string;
-  version_id: string;
-}
-
 export type ContentBlock =
   | MarkdownContentBlock
   | TextContentBlock

package/src/clients/messages/index.ts

@@ -0,0 +1,90 @@
+import { ApiResponse } from "../../api";
+import { BulkOperation } from "../../interfaces";
+import Knock from "../../knock";
+
+import {
+  BulkUpdateMessagesInChannelProperties,
+  Message,
+  MessageEngagementStatus,
+} from "./interfaces";
+
+class MessageClient {
+  private knock: Knock;
+
+  constructor(knock: Knock) {
+    this.knock = knock;
+  }
+
+  async get(messageId: string): Promise<Message> {
+    const result = await this.knock.client().makeRequest({
+      method: "GET",
+      url: `/v1/messages/${messageId}`,
+    });
+
+    return this.handleResponse<Message>(result);
+  }
+
+  async updateStatus(
+    messageId: string,
+    status: MessageEngagementStatus,
+  ): Promise<Message> {
+    const result = await this.knock.client().makeRequest({
+      method: "PUT",
+      url: `/v1/messages/${messageId}/${status}`,
+    });
+
+    return this.handleResponse<Message>(result);
+  }
+
+  async removeStatus(
+    messageId: string,
+    status: Exclude<MessageEngagementStatus, "interacted">,
+  ): Promise<Message> {
+    const result = await this.knock.client().makeRequest({
+      method: "DELETE",
+      url: `/v1/messages/${messageId}/${status}`,
+    });
+
+    return this.handleResponse<Message>(result);
+  }
+
+  async batchUpdateStatuses(
+    messageIds: string[],
+    status: MessageEngagementStatus | "unseen" | "unread" | "unarchived",
+  ): Promise<Message[]> {
+    const result = await this.knock.client().makeRequest({
+      method: "POST",
+      url: `/v1/messages/batch/${status}`,
+      data: { message_ids: messageIds },
+    });
+
+    return this.handleResponse<Message[]>(result);
+  }
+
+  async bulkUpdateAllStatusesInChannel({
+    channelId,
+    status,
+    options,
+  }: BulkUpdateMessagesInChannelProperties): Promise<BulkOperation> {
+    const result = await this.knock.client().makeRequest({
+      method: "POST",
+      url: `/v1/channels/${channelId}/messages/bulk/${status}`,
+      data: options,
+    });
+
+    return this.handleResponse<BulkOperation>(result);
+  }
+
+  private handleResponse<T = any>(response: ApiResponse) {
+    if (response.statusCode === "error") {
+      if (response.error?.response?.status < 500) {
+        return response.error || response.body;
+      }
+      throw new Error(response.error || response.body);
+    }
+
+    return response.body as T;
+  }
+}
+
+export default MessageClient;

package/src/clients/messages/interfaces.ts

@@ -0,0 +1,53 @@
+import { RecipientRef } from "../..";
+
+export type MessageDeliveryStatus =
+  | "queued"
+  | "sent"
+  | "delivered"
+  | "delivery_attempted"
+  | "undelivered"
+  | "not_sent";
+
+export interface NotificationSource {
+  key: string;
+  version_id: string;
+  categories: string[];
+}
+
+export type MessageEngagementStatus =
+  | "seen"
+  | "read"
+  | "interacted"
+  | "archived";
+
+export interface Message<T = any> {
+  id: string;
+  channel_id: string;
+  recipient: RecipientRef;
+  actors: RecipientRef[];
+  inserted_at: string;
+  updated_at: string;
+  read_at: string | null;
+  seen_at: string | null;
+  archived_at: string | null;
+  tenant: string | null;
+  status: MessageDeliveryStatus;
+  engagement_statuses: MessageEngagementStatus[];
+  source: NotificationSource;
+  data: T | null;
+  metadata: {
+    external_id?: string;
+  };
+}
+
+export type BulkUpdateMessagesInChannelProperties = {
+  channelId: string;
+  status: "seen" | "read" | "archive";
+  options: {
+    user_ids?: string[];
+    engagement_status?: "seen" | "read" | "unseen" | "unread";
+    archived?: "exclude" | "include" | "only";
+    has_tenant?: boolean;
+    tenants?: string[];
+  };
+};

package/src/clients/slack/index.ts

@@ -4,6 +4,7 @@ import Knock from "../../knock";
 import {
   AuthCheckInput,
   GetSlackChannelsInput,
+  GetSlackChannelsResponse,
   RevokeAccessTokenInput,
 } from "./interfaces";
 
@@ -32,7 +33,9 @@ class SlackClient {
     return this.handleResponse(result);
   }
 
-  async getChannels(input: GetSlackChannelsInput) {
+  async getChannels(
+    input: GetSlackChannelsInput,
+  ): Promise<GetSlackChannelsResponse> {
     const { knockChannelId, tenant } = input;
     const queryOptions = input.queryOptions || {};
 

package/src/clients/slack/interfaces.ts

@@ -27,6 +27,11 @@ export type RevokeAccessTokenInput = {
   knockChannelId: string;
 };
 
+export type GetSlackChannelsResponse = {
+  slack_channels: SlackChannel[];
+  next_cursor: string | null;
+};
+
 export type SlackChannel = {
   name: string;
   id: string;

package/src/index.ts

@@ -10,6 +10,9 @@ export * from "./clients/preferences/interfaces";
 export * from "./clients/slack";
 export * from "./clients/slack/interfaces";
 export * from "./clients/users";
+export * from "./clients/users/interfaces";
+export * from "./clients/messages";
+export * from "./clients/messages/interfaces";
 export * from "./networkStatus";
 
 export default Knock;

package/src/interfaces.ts

@@ -27,6 +27,8 @@ export interface User extends GenericData {
 
 export type Recipient = User | KnockObject;
 
+export type RecipientRef = string | { collection: string; id: string };
+
 export interface Activity<T = GenericData> {
   id: string;
   inserted_at: string;
@@ -50,3 +52,16 @@ export interface AuthenticateOptions {
   onUserTokenExpiring?: UserTokenExpiringCallback;
   timeBeforeExpirationInMs?: number;
 }
+
+export interface BulkOperation {
+  id: string;
+  name: string;
+  status: "queued" | "processing" | "completed" | "failed";
+  processed_rows: number;
+  estimated_total_rows: number;
+  started_at?: string;
+  completed_at?: string;
+  failed_at?: string;
+  inserted_at: string;
+  updated_at: string;
+}

package/src/knock.ts

@@ -2,6 +2,7 @@ import { jwtDecode } from "jwt-decode";
 
 import ApiClient from "./api";
 import FeedClient from "./clients/feed";
+import MessageClient from "./clients/messages";
 import ObjectClient from "./clients/objects";
 import Preferences from "./clients/preferences";
 import SlackClient from "./clients/slack";
@@ -27,6 +28,7 @@ class Knock {
   readonly preferences = new Preferences(this);
   readonly slack = new SlackClient(this);
   readonly user = new UserClient(this);
+  readonly messages = new MessageClient(this);
 
   constructor(
     readonly apiKey: string,