@liveblocks/core 3.21.0-private1 → 3.21.0-private2

package/dist/index.d.cts

@@ -93,9 +93,6 @@ declare const Permission: {
     readonly CommentsPrivateWrite: "comments:private:write";
     readonly CommentsPrivateRead: "comments:private:read";
     readonly CommentsPrivateNone: "comments:private:none";
-    readonly CommentsPersonalWrite: "comments:personal:write";
-    readonly CommentsPersonalRead: "comments:personal:read";
-    readonly CommentsPersonalNone: "comments:personal:none";
     /**
      * Feeds
      */
@@ -117,7 +114,6 @@ type PermissionMatrix = {
     comments: AccessLevel;
     "comments:public": AccessLevel;
     "comments:private": AccessLevel;
-    "comments:personal": AccessLevel;
     feeds: AccessLevel;
     personal: AccessLevel;
 };
@@ -125,22 +121,11 @@ type PermissionResources = keyof PermissionMatrix;
 type RoomPermissions = Permission[];
 type RoomAccesses = Record<string, RoomPermissions>;
 type UpdateRoomAccesses = Record<string, RoomPermissions | null>;
+declare function permissionMatrixFromScopes(scopes: RoomPermissions): PermissionMatrix;
+declare function hasPermissionAccess(matrix: Partial<PermissionMatrix>, resource: PermissionResources, requiredAccess: RequiredAccessLevel): boolean;
 declare function normalizeRoomPermissions(permissions: string[] | readonly string[]): RoomPermissions;
 declare function normalizeRoomAccesses(accesses: RoomAccesses | undefined): RoomAccesses | undefined;
 declare function normalizeUpdateRoomAccesses(accesses: UpdateRoomAccesses | undefined): UpdateRoomAccesses | undefined;
-/**
- * Validates a set of permissions:
- * - every scope must be a known permission scope,
- * - exactly one base permission is required (*:read, *:write, or the legacy
- *   aliases room:read, room:write),
- * - at most one scope per feature (storage, comments, feeds, ...),
- * - room:presence:write is accepted as an extra legacy scope.
- *
- * Returns `true` when the set is valid, or an error message otherwise.
- */
-declare function validatePermissionsSet(scopes: readonly string[]): true | string;
-declare function permissionMatrixFromScopes(scopes: RoomPermissions): PermissionMatrix;
-declare function hasPermissionAccess(matrix: Partial<PermissionMatrix>, resource: PermissionResources, requiredAccess: RequiredAccessLevel): boolean;
 /**
  * Merges permission scopes from multiple sources, by priority: explicit user
  * accesses override group accesses, which override the room defaults. Groups
@@ -152,6 +137,17 @@ declare function mergeRoomPermissionScopes({ defaultAccesses, groupsAccesses, us
     groupsAccesses: RoomPermissions[];
     userAccesses: RoomPermissions;
 }): RoomPermissions;
+/**
+ * Validates a set of permissions:
+ * - every scope must be a known permission scope,
+ * - exactly one base permission is required (*:read, *:write, or the legacy
+ *   aliases room:read, room:write),
+ * - at most one scope per feature (storage, comments, feeds, ...),
+ * - room:presence:write is accepted as an extra legacy scope.
+ *
+ * Returns `true` when the set is valid, or an error message otherwise.
+ */
+declare function validatePermissionsSet(scopes: readonly string[]): true | string;
 
 type CustomAuthenticationResult = Relax<{
     token: string;
@@ -1750,17 +1746,20 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
     deleteThread({ roomId, threadId, }: {
         roomId: string;
         threadId: string;
+        visibility?: ThreadVisibility;
     }): Promise<void>;
     editThreadMetadata({ roomId, metadata, threadId, }: {
         roomId: string;
         metadata: Patchable<TM>;
         threadId: string;
+        visibility?: ThreadVisibility;
     }): Promise<TM>;
     editCommentMetadata({ roomId, threadId, commentId, metadata, }: {
         roomId: string;
         threadId: string;
         commentId: string;
         metadata: Patchable<CM>;
+        visibility?: ThreadVisibility;
     }): Promise<CM>;
     createComment({ roomId, threadId, commentId, body, metadata, attachmentIds, }: {
         roomId: string;
@@ -1769,6 +1768,7 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
         body: CommentBody;
         metadata?: CM;
         attachmentIds?: string[];
+        visibility?: ThreadVisibility;
     }): Promise<CommentData<CM>>;
     editComment({ roomId, threadId, commentId, body, attachmentIds, metadata, }: {
         roomId: string;
@@ -1777,31 +1777,37 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
         body: CommentBody;
         attachmentIds?: string[];
         metadata?: Patchable<CM>;
+        visibility?: ThreadVisibility;
     }): Promise<CommentData<CM>>;
     deleteComment({ roomId, threadId, commentId, }: {
         roomId: string;
         threadId: string;
         commentId: string;
+        visibility?: ThreadVisibility;
     }): Promise<void>;
     addReaction({ roomId, threadId, commentId, emoji, }: {
         roomId: string;
         threadId: string;
         commentId: string;
         emoji: string;
+        visibility?: ThreadVisibility;
     }): Promise<CommentUserReaction>;
     removeReaction({ roomId, threadId, commentId, emoji, }: {
         roomId: string;
         threadId: string;
         commentId: string;
         emoji: string;
+        visibility?: ThreadVisibility;
     }): Promise<void>;
     markThreadAsResolved({ roomId, threadId, }: {
         roomId: string;
         threadId: string;
+        visibility?: ThreadVisibility;
     }): Promise<void>;
     markThreadAsUnresolved({ roomId, threadId, }: {
         roomId: string;
         threadId: string;
+        visibility?: ThreadVisibility;
     }): Promise<void>;
     subscribeToThread({ roomId, threadId, }: {
         roomId: string;
@@ -4150,6 +4156,7 @@ type PrivateRoomApi = {
     getSelf_forDevTools(): UserTreeNode | null;
     getOthers_forDevTools(): readonly UserTreeNode[];
     reportTextEditor(editor: TextEditorType, rootKey: string): Promise<void>;
+    getPermissionMatrix(): PermissionMatrix | undefined;
     createTextMention(mentionId: string, mention: MentionData): Promise<void>;
     deleteTextMention(mentionId: string): Promise<void>;
     listTextVersions(): Promise<{

package/dist/index.d.ts

@@ -93,9 +93,6 @@ declare const Permission: {
     readonly CommentsPrivateWrite: "comments:private:write";
     readonly CommentsPrivateRead: "comments:private:read";
     readonly CommentsPrivateNone: "comments:private:none";
-    readonly CommentsPersonalWrite: "comments:personal:write";
-    readonly CommentsPersonalRead: "comments:personal:read";
-    readonly CommentsPersonalNone: "comments:personal:none";
     /**
      * Feeds
      */
@@ -117,7 +114,6 @@ type PermissionMatrix = {
     comments: AccessLevel;
     "comments:public": AccessLevel;
     "comments:private": AccessLevel;
-    "comments:personal": AccessLevel;
     feeds: AccessLevel;
     personal: AccessLevel;
 };
@@ -125,22 +121,11 @@ type PermissionResources = keyof PermissionMatrix;
 type RoomPermissions = Permission[];
 type RoomAccesses = Record<string, RoomPermissions>;
 type UpdateRoomAccesses = Record<string, RoomPermissions | null>;
+declare function permissionMatrixFromScopes(scopes: RoomPermissions): PermissionMatrix;
+declare function hasPermissionAccess(matrix: Partial<PermissionMatrix>, resource: PermissionResources, requiredAccess: RequiredAccessLevel): boolean;
 declare function normalizeRoomPermissions(permissions: string[] | readonly string[]): RoomPermissions;
 declare function normalizeRoomAccesses(accesses: RoomAccesses | undefined): RoomAccesses | undefined;
 declare function normalizeUpdateRoomAccesses(accesses: UpdateRoomAccesses | undefined): UpdateRoomAccesses | undefined;
-/**
- * Validates a set of permissions:
- * - every scope must be a known permission scope,
- * - exactly one base permission is required (*:read, *:write, or the legacy
- *   aliases room:read, room:write),
- * - at most one scope per feature (storage, comments, feeds, ...),
- * - room:presence:write is accepted as an extra legacy scope.
- *
- * Returns `true` when the set is valid, or an error message otherwise.
- */
-declare function validatePermissionsSet(scopes: readonly string[]): true | string;
-declare function permissionMatrixFromScopes(scopes: RoomPermissions): PermissionMatrix;
-declare function hasPermissionAccess(matrix: Partial<PermissionMatrix>, resource: PermissionResources, requiredAccess: RequiredAccessLevel): boolean;
 /**
  * Merges permission scopes from multiple sources, by priority: explicit user
  * accesses override group accesses, which override the room defaults. Groups
@@ -152,6 +137,17 @@ declare function mergeRoomPermissionScopes({ defaultAccesses, groupsAccesses, us
     groupsAccesses: RoomPermissions[];
     userAccesses: RoomPermissions;
 }): RoomPermissions;
+/**
+ * Validates a set of permissions:
+ * - every scope must be a known permission scope,
+ * - exactly one base permission is required (*:read, *:write, or the legacy
+ *   aliases room:read, room:write),
+ * - at most one scope per feature (storage, comments, feeds, ...),
+ * - room:presence:write is accepted as an extra legacy scope.
+ *
+ * Returns `true` when the set is valid, or an error message otherwise.
+ */
+declare function validatePermissionsSet(scopes: readonly string[]): true | string;
 
 type CustomAuthenticationResult = Relax<{
     token: string;
@@ -1750,17 +1746,20 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
     deleteThread({ roomId, threadId, }: {
         roomId: string;
         threadId: string;
+        visibility?: ThreadVisibility;
     }): Promise<void>;
     editThreadMetadata({ roomId, metadata, threadId, }: {
         roomId: string;
         metadata: Patchable<TM>;
         threadId: string;
+        visibility?: ThreadVisibility;
     }): Promise<TM>;
     editCommentMetadata({ roomId, threadId, commentId, metadata, }: {
         roomId: string;
         threadId: string;
         commentId: string;
         metadata: Patchable<CM>;
+        visibility?: ThreadVisibility;
     }): Promise<CM>;
     createComment({ roomId, threadId, commentId, body, metadata, attachmentIds, }: {
         roomId: string;
@@ -1769,6 +1768,7 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
         body: CommentBody;
         metadata?: CM;
         attachmentIds?: string[];
+        visibility?: ThreadVisibility;
     }): Promise<CommentData<CM>>;
     editComment({ roomId, threadId, commentId, body, attachmentIds, metadata, }: {
         roomId: string;
@@ -1777,31 +1777,37 @@ interface RoomHttpApi<TM extends BaseMetadata, CM extends BaseMetadata> {
         body: CommentBody;
         attachmentIds?: string[];
         metadata?: Patchable<CM>;
+        visibility?: ThreadVisibility;
     }): Promise<CommentData<CM>>;
     deleteComment({ roomId, threadId, commentId, }: {
         roomId: string;
         threadId: string;
         commentId: string;
+        visibility?: ThreadVisibility;
     }): Promise<void>;
     addReaction({ roomId, threadId, commentId, emoji, }: {
         roomId: string;
         threadId: string;
         commentId: string;
         emoji: string;
+        visibility?: ThreadVisibility;
     }): Promise<CommentUserReaction>;
     removeReaction({ roomId, threadId, commentId, emoji, }: {
         roomId: string;
         threadId: string;
         commentId: string;
         emoji: string;
+        visibility?: ThreadVisibility;
     }): Promise<void>;
     markThreadAsResolved({ roomId, threadId, }: {
         roomId: string;
         threadId: string;
+        visibility?: ThreadVisibility;
     }): Promise<void>;
     markThreadAsUnresolved({ roomId, threadId, }: {
         roomId: string;
         threadId: string;
+        visibility?: ThreadVisibility;
     }): Promise<void>;
     subscribeToThread({ roomId, threadId, }: {
         roomId: string;
@@ -4150,6 +4156,7 @@ type PrivateRoomApi = {
     getSelf_forDevTools(): UserTreeNode | null;
     getOthers_forDevTools(): readonly UserTreeNode[];
     reportTextEditor(editor: TextEditorType, rootKey: string): Promise<void>;
+    getPermissionMatrix(): PermissionMatrix | undefined;
     createTextMention(mentionId: string, mention: MentionData): Promise<void>;
     deleteTextMention(mentionId: string): Promise<void>;
     listTextVersions(): Promise<{