@liveblocks/node 1.10.0-beta1 → 1.10.0-beta3

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { IUserInfo, Json, PlainLsonObject, JsonObject, ThreadData, BaseMetadata, CommentData, CommentBody, CommentUserReaction, InboxNotificationData } from '@liveblocks/core';
+import { IUserInfo, Json, PlainLsonObject, JsonObject, ThreadData, BaseMetadata, CommentData, CommentBody, CommentUserReaction, InboxNotificationData, RoomNotificationSettings } from '@liveblocks/core';
 export { CommentBody, CommentBodyBlockElement, CommentBodyElement, CommentBodyInlineElement, CommentBodyLink, CommentBodyLinkElementArgs, CommentBodyMention, CommentBodyMentionElementArgs, CommentBodyParagraph, CommentBodyParagraphElementArgs, CommentBodyText, CommentBodyTextElementArgs, CommentData, CommentUserReaction, IUserInfo, Json, JsonArray, JsonObject, JsonScalar, Lson, LsonObject, PlainLsonObject, ResolveUsersArgs, StringifyCommentBodyElements, StringifyCommentBodyOptions, ThreadData, User, getMentionedIdsFromCommentBody, stringifyCommentBody } from '@liveblocks/core';
 import { IncomingHttpHeaders } from 'http';
 
@@ -621,10 +621,44 @@ declare class Liveblocks {
             removedAt?: Date;
         };
     }): Promise<void>;
+    /**
+     * Returns the inbox notifications for a user.
+     * @param params.userId The user ID to get the inbox notifications from.
+     * @param params.inboxNotificationId The ID of the inbox notification to get.
+     */
     getInboxNotification(params: {
         userId: string;
         inboxNotificationId: string;
     }): Promise<InboxNotificationData>;
+    /**
+     * Gets the user's room notification settings.
+     * @param params.userId The user ID to get the room notifications from.
+     * @param params.roomId The room ID to get the room notification settings from.
+     */
+    getRoomNotificationSettings(params: {
+        userId: string;
+        roomId: string;
+    }): Promise<RoomNotificationSettings>;
+    /**
+     * Updates the user's room notification settings.
+     * @param params.userId The user ID to update the room notification settings for.
+     * @param params.roomId The room ID to update the room notification settings for.
+     * @param params.data The new room notification settings for the user.
+     */
+    updateRoomNotificationSettings(params: {
+        userId: string;
+        roomId: string;
+        data: RoomNotificationSettings;
+    }): Promise<RoomNotificationSettings>;
+    /**
+     * Delete the user's room notification settings.
+     * @param params.userId The user ID to delete the room notification settings from.
+     * @param params.roomId The room ID to delete the room notification settings from.
+     */
+    deleteRoomNotificationSettings(params: {
+        userId: string;
+        roomId: string;
+    }): Promise<void>;
 }
 
 declare class WebhookHandler {
@@ -683,7 +717,7 @@ declare type WebhookRequest = {
      */
     rawBody: string;
 };
-declare type WebhookEvent = StorageUpdatedEvent | UserEnteredEvent | UserLeftEvent | RoomCreatedEvent | RoomDeletedEvent | CommentCreatedEvent | CommentEditedEvent | CommentDeletedEvent | CommentReactionAdded | CommentReactionRemoved | ThreadMetadataUpdatedEvent | ThreadCreatedEvent | YDocUpdatedEvent;
+declare type WebhookEvent = StorageUpdatedEvent | UserEnteredEvent | UserLeftEvent | RoomCreatedEvent | RoomDeletedEvent | CommentCreatedEvent | CommentEditedEvent | CommentDeletedEvent | CommentReactionAdded | CommentReactionRemoved | ThreadMetadataUpdatedEvent | ThreadEmailNotificationEvent | ThreadCreatedEvent | YDocUpdatedEvent;
 declare type StorageUpdatedEvent = {
     type: "storageUpdated";
     data: {
@@ -864,5 +898,20 @@ declare type ThreadCreatedEvent = {
         createdBy: string;
     };
 };
+declare type ThreadEmailNotificationEvent = {
+    type: "threadEmailNotification";
+    data: {
+        projectId: string;
+        roomId: string;
+        userId: string;
+        threadId: string;
+        inboxNotificationId: string;
+        /**
+         * ISO 8601 datestring
+         * @example "2021-03-01T12:00:00.000Z"
+         */
+        createdAt: string;
+    };
+};
 
-export { type CommentCreatedEvent, type CommentDeletedEvent, type CommentEditedEvent, type CommentReactionAdded, type CommentReactionRemoved, Liveblocks, type LiveblocksOptions, type RoomAccesses, type RoomCreatedEvent, type RoomDeletedEvent, type RoomInfo, type RoomPermission, type RoomUser, type Schema, type StorageUpdatedEvent, type ThreadCreatedEvent, type ThreadMetadataUpdatedEvent, type ThreadParticipants, type UserEnteredEvent, type UserLeftEvent, type WebhookEvent, WebhookHandler, type WebhookRequest, authorize };
+export { type CommentCreatedEvent, type CommentDeletedEvent, type CommentEditedEvent, type CommentReactionAdded, type CommentReactionRemoved, Liveblocks, type LiveblocksOptions, type RoomAccesses, type RoomCreatedEvent, type RoomDeletedEvent, type RoomInfo, type RoomPermission, type RoomUser, type Schema, type StorageUpdatedEvent, type ThreadCreatedEvent, type ThreadEmailNotificationEvent, type ThreadMetadataUpdatedEvent, type ThreadParticipants, type UserEnteredEvent, type UserLeftEvent, type WebhookEvent, WebhookHandler, type WebhookRequest, authorize };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { IUserInfo, Json, PlainLsonObject, JsonObject, ThreadData, BaseMetadata, CommentData, CommentBody, CommentUserReaction, InboxNotificationData } from '@liveblocks/core';
+import { IUserInfo, Json, PlainLsonObject, JsonObject, ThreadData, BaseMetadata, CommentData, CommentBody, CommentUserReaction, InboxNotificationData, RoomNotificationSettings } from '@liveblocks/core';
 export { CommentBody, CommentBodyBlockElement, CommentBodyElement, CommentBodyInlineElement, CommentBodyLink, CommentBodyLinkElementArgs, CommentBodyMention, CommentBodyMentionElementArgs, CommentBodyParagraph, CommentBodyParagraphElementArgs, CommentBodyText, CommentBodyTextElementArgs, CommentData, CommentUserReaction, IUserInfo, Json, JsonArray, JsonObject, JsonScalar, Lson, LsonObject, PlainLsonObject, ResolveUsersArgs, StringifyCommentBodyElements, StringifyCommentBodyOptions, ThreadData, User, getMentionedIdsFromCommentBody, stringifyCommentBody } from '@liveblocks/core';
 import { IncomingHttpHeaders } from 'http';
 
@@ -621,10 +621,44 @@ declare class Liveblocks {
             removedAt?: Date;
         };
     }): Promise<void>;
+    /**
+     * Returns the inbox notifications for a user.
+     * @param params.userId The user ID to get the inbox notifications from.
+     * @param params.inboxNotificationId The ID of the inbox notification to get.
+     */
     getInboxNotification(params: {
         userId: string;
         inboxNotificationId: string;
     }): Promise<InboxNotificationData>;
+    /**
+     * Gets the user's room notification settings.
+     * @param params.userId The user ID to get the room notifications from.
+     * @param params.roomId The room ID to get the room notification settings from.
+     */
+    getRoomNotificationSettings(params: {
+        userId: string;
+        roomId: string;
+    }): Promise<RoomNotificationSettings>;
+    /**
+     * Updates the user's room notification settings.
+     * @param params.userId The user ID to update the room notification settings for.
+     * @param params.roomId The room ID to update the room notification settings for.
+     * @param params.data The new room notification settings for the user.
+     */
+    updateRoomNotificationSettings(params: {
+        userId: string;
+        roomId: string;
+        data: RoomNotificationSettings;
+    }): Promise<RoomNotificationSettings>;
+    /**
+     * Delete the user's room notification settings.
+     * @param params.userId The user ID to delete the room notification settings from.
+     * @param params.roomId The room ID to delete the room notification settings from.
+     */
+    deleteRoomNotificationSettings(params: {
+        userId: string;
+        roomId: string;
+    }): Promise<void>;
 }
 
 declare class WebhookHandler {
@@ -683,7 +717,7 @@ declare type WebhookRequest = {
      */
     rawBody: string;
 };
-declare type WebhookEvent = StorageUpdatedEvent | UserEnteredEvent | UserLeftEvent | RoomCreatedEvent | RoomDeletedEvent | CommentCreatedEvent | CommentEditedEvent | CommentDeletedEvent | CommentReactionAdded | CommentReactionRemoved | ThreadMetadataUpdatedEvent | ThreadCreatedEvent | YDocUpdatedEvent;
+declare type WebhookEvent = StorageUpdatedEvent | UserEnteredEvent | UserLeftEvent | RoomCreatedEvent | RoomDeletedEvent | CommentCreatedEvent | CommentEditedEvent | CommentDeletedEvent | CommentReactionAdded | CommentReactionRemoved | ThreadMetadataUpdatedEvent | ThreadEmailNotificationEvent | ThreadCreatedEvent | YDocUpdatedEvent;
 declare type StorageUpdatedEvent = {
     type: "storageUpdated";
     data: {
@@ -864,5 +898,20 @@ declare type ThreadCreatedEvent = {
         createdBy: string;
     };
 };
+declare type ThreadEmailNotificationEvent = {
+    type: "threadEmailNotification";
+    data: {
+        projectId: string;
+        roomId: string;
+        userId: string;
+        threadId: string;
+        inboxNotificationId: string;
+        /**
+         * ISO 8601 datestring
+         * @example "2021-03-01T12:00:00.000Z"
+         */
+        createdAt: string;
+    };
+};
 
-export { type CommentCreatedEvent, type CommentDeletedEvent, type CommentEditedEvent, type CommentReactionAdded, type CommentReactionRemoved, Liveblocks, type LiveblocksOptions, type RoomAccesses, type RoomCreatedEvent, type RoomDeletedEvent, type RoomInfo, type RoomPermission, type RoomUser, type Schema, type StorageUpdatedEvent, type ThreadCreatedEvent, type ThreadMetadataUpdatedEvent, type ThreadParticipants, type UserEnteredEvent, type UserLeftEvent, type WebhookEvent, WebhookHandler, type WebhookRequest, authorize };
+export { type CommentCreatedEvent, type CommentDeletedEvent, type CommentEditedEvent, type CommentReactionAdded, type CommentReactionRemoved, Liveblocks, type LiveblocksOptions, type RoomAccesses, type RoomCreatedEvent, type RoomDeletedEvent, type RoomInfo, type RoomPermission, type RoomUser, type Schema, type StorageUpdatedEvent, type ThreadCreatedEvent, type ThreadEmailNotificationEvent, type ThreadMetadataUpdatedEvent, type ThreadParticipants, type UserEnteredEvent, type UserLeftEvent, type WebhookEvent, WebhookHandler, type WebhookRequest, authorize };

package/dist/index.js

@@ -3,7 +3,7 @@ var _core = require('@liveblocks/core');
 
 // src/version.ts
 var PKG_NAME = "@liveblocks/node";
-var PKG_VERSION = "1.10.0-beta1";
+var PKG_VERSION = "1.10.0-beta3";
 var PKG_FORMAT = "cjs";
 
 // src/utils.ts
@@ -126,7 +126,7 @@ var READ_ACCESS = Object.freeze([
   "comments:read"
 ]);
 var FULL_ACCESS = Object.freeze(["room:write", "comments:write"]);
-var roomPatternRegex = /^[^*]{1,128}[*]?$/;
+var roomPatternRegex = /^([*]|[^*]{1,128}[*]?)$/;
 var Session = class {
   /** @internal */
   constructor(postFn, userId, userInfo) {
@@ -161,6 +161,9 @@ var Session = class {
     }
   }
   allow(roomIdOrPattern, newPerms) {
+    if (typeof roomIdOrPattern !== "string") {
+      throw new Error("Room name or pattern must be a string");
+    }
     if (!roomPatternRegex.test(roomIdOrPattern)) {
       throw new Error("Invalid room name or pattern");
     }
@@ -1015,6 +1018,11 @@ var Liveblocks = class {
       throw new LiveblocksError(res.status, text);
     }
   }
+  /**
+   * Returns the inbox notifications for a user.
+   * @param params.userId The user ID to get the inbox notifications from.
+   * @param params.inboxNotificationId The ID of the inbox notification to get.
+   */
   async getInboxNotification(params) {
     const { userId, inboxNotificationId } = params;
     const res = await this.get(
@@ -1031,6 +1039,55 @@ var Liveblocks = class {
       readAt: data.readAt ? new Date(data.readAt) : null
     };
   }
+  /**
+   * Gets the user's room notification settings.
+   * @param params.userId The user ID to get the room notifications from.
+   * @param params.roomId The room ID to get the room notification settings from.
+   */
+  async getRoomNotificationSettings(params) {
+    const { userId, roomId } = params;
+    const res = await this.get(
+      url`/v2/rooms/${roomId}/users/${userId}/notification-settings`
+    );
+    if (!res.ok) {
+      const text = await res.text();
+      throw new LiveblocksError(res.status, text);
+    }
+    return await res.json();
+  }
+  /**
+   * Updates the user's room notification settings.
+   * @param params.userId The user ID to update the room notification settings for.
+   * @param params.roomId The room ID to update the room notification settings for.
+   * @param params.data The new room notification settings for the user.
+   */
+  async updateRoomNotificationSettings(params) {
+    const { userId, roomId, data } = params;
+    const res = await this.post(
+      url`/v2/rooms/${roomId}/users/${userId}/notification-settings`,
+      data
+    );
+    if (!res.ok) {
+      const text = await res.text();
+      throw new LiveblocksError(res.status, text);
+    }
+    return await res.json();
+  }
+  /**
+   * Delete the user's room notification settings.
+   * @param params.userId The user ID to delete the room notification settings from.
+   * @param params.roomId The room ID to delete the room notification settings from.
+   */
+  async deleteRoomNotificationSettings(params) {
+    const { userId, roomId } = params;
+    const res = await this.delete(
+      url`/v2/rooms/${roomId}/users/${userId}/notification-settings`
+    );
+    if (!res.ok) {
+      const text = await res.text();
+      throw new LiveblocksError(res.status, text);
+    }
+  }
 };
 var LiveblocksError = class extends Error {
   constructor(status, message = "") {
@@ -1145,6 +1202,7 @@ var _WebhookHandler = class _WebhookHandler {
       "commentReactionAdded",
       "commentReactionRemoved",
       "threadMetadataUpdated",
+      "threadEmailNotification",
       "threadCreated",
       "ydocUpdated"
     ].includes(event.type))