@liveblocks/node 1.0.8 → 1.0.10

package/dist/index.d.ts

@@ -2,25 +2,47 @@ import { IncomingHttpHeaders } from 'http';
 
 declare type AuthorizeOptions = {
     /**
-     * The secret api provided at https://liveblocks.io/dashboard/apikeys
+     * The secret API key for your Liveblocks account. You can find it on
+     * https://liveblocks.io/dashboard/apikeys
      */
     secret: string;
     /**
-     * The room provided in the authorization request body
+     * The room ID for which to authorize the user. This will authorize the user
+     * to enter the Liveblocks room.
      */
     room: string;
     /**
-     * The id of the user that try to connect. It can be used to get information about the connected users in the room (name, avatar, etc).
-     * It can also be used to generate a token that gives access to a private room where the userId is configured in the room accesses.
-     * Liveblocks uses the userId to calculate your account's Monthly Active Users.
+     * Associates a user ID to the session that is being authorized. The user ID
+     * is typically set to the user ID from your own database.
+     *
+     * It can also be used to generate a token that gives access to a private
+     * room where the userId is configured in the room accesses.
+     *
+     * This user ID will be used as the unique identifier to compute your
+     * Liveblocks account's Monthly Active Users.
      */
     userId: string;
     /**
-     * The info associated to the user. Can be used to store the name or the profile picture to implement avatar for example. Can't exceed 1KB when serialized as JSON
+     * Arbitrary metadata associated to this user session.
+     *
+     * You can use it to store a small amount of static metadata for a user
+     * session. It is public information, that will be visible to other users in
+     * the same room, like name, avatar URL, etc.
+     *
+     * It's only suitable for static info that won't change during a session. If
+     * you want to store dynamic metadata on a user session, don't keep that in
+     * the session token, but use Presence instead.
+     *
+     * Can't exceed 1KB when serialized as JSON.
      */
     userInfo?: unknown;
     /**
-     * The ids of the groups to which the user belongs. It should be used to generate a token that gives access to a private room and at least one of the group is configured in the room accesses.
+     * Tell Liveblocks which group IDs this user belongs to. This will authorize
+     * the user session to access private rooms that have at least one of these
+     * group IDs listed in their room access configuration.
+     *
+     * See https://liveblocks.io/docs/guides/managing-rooms-users-permissions#permissions
+     * for how to configure your room's permissions to use this feature.
      */
     groupIds?: string[];
 };
@@ -30,6 +52,10 @@ declare type AuthorizeResponse = {
     error?: Error;
 };
 /**
+ * Tells Liveblocks that a user should be allowed access to a room, which user
+ * this session is for, and what metadata to associate with the user (like
+ * name, avatar, etc.)
+ *
  * @example
  * export default async function auth(req, res) {
  *

package/dist/index.js

@@ -35,34 +35,38 @@ function authorize(options) {
           "Invalid userId. Please provide a non-empty string as the userId. For more information: https://liveblocks.io/docs/api-reference/liveblocks-node#authorize"
         );
       }
-      const result = yield _nodefetch2.default.call(void 0, 
-        buildLiveblocksAuthorizeEndpoint(options, room),
-        {
-          method: "POST",
-          headers: {
-            Authorization: `Bearer ${secret}`,
-            "Content-Type": "application/json"
-          },
-          body: JSON.stringify({
-            userId,
-            userInfo,
-            groupIds
-          })
-        }
-      );
-      if (!result.ok) {
+      const resp = yield _nodefetch2.default.call(void 0, buildLiveblocksAuthorizeEndpoint(options, room), {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${secret}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          userId,
+          userInfo,
+          groupIds
+        })
+      });
+      if (resp.ok) {
+        return {
+          status: 200,
+          body: yield resp.text()
+        };
+      }
+      if (resp.status >= 500) {
+        return {
+          status: 503,
+          body: yield resp.text()
+        };
+      } else {
         return {
           status: 403,
-          body: yield result.text()
+          body: yield resp.text()
         };
       }
-      return {
-        status: 200,
-        body: yield result.text()
-      };
     } catch (er) {
       return {
-        status: 403,
+        status: 503,
         body: 'Call to "https://api.liveblocks.io/v2/rooms/:roomId/authorize" failed. See "error" for more information.',
         error: er
       };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liveblocks/node",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "A server-side utility that lets you set up a Liveblocks authentication endpoint. Liveblocks is the all-in-one toolkit to build collaborative products like Figma, Notion, and more.",
   "license": "Apache-2.0",
   "main": "./dist/index.js",