@sublay/js 7.3.0 → 7.4.1

package/dist/index.mjs

@@ -289,9 +289,59 @@ __export(users_exports, {
   updateUser: () => updateUser
 });
 
+// src/core/spaceReputationParams.ts
+var bothFormsWarned = false;
+function isProduction() {
+  return typeof process !== "undefined" && !!process.env && process.env.NODE_ENV === "production";
+}
+function buildSpaceReputationParams(input) {
+  const { spaceReputation, spaceReputationId, spaceReputationDescendants } = input;
+  const objectPresent = spaceReputation !== void 0;
+  const flatPresent = spaceReputationId !== void 0 && spaceReputationId !== null || spaceReputationDescendants !== void 0 && spaceReputationDescendants !== null;
+  if (objectPresent && flatPresent && !bothFormsWarned && !isProduction()) {
+    bothFormsWarned = true;
+    console.warn(
+      "[Sublay] Both `spaceReputation` and the deprecated flat props (`spaceReputationId` / `spaceReputationDescendants`) were supplied. The `spaceReputation` object takes precedence; the flat props are ignored. Remove the flat props \u2014 they are deprecated."
+    );
+  }
+  const result = {};
+  if (objectPresent) {
+    const spaceId = spaceReputation.spaceId;
+    if (spaceId !== void 0 && spaceId !== null) {
+      result.spaceReputationId = spaceId;
+    }
+    const includeDescendants = spaceReputation.includeDescendants;
+    if (includeDescendants !== void 0 && includeDescendants !== null) {
+      result.spaceReputationDescendants = includeDescendants;
+    }
+    return result;
+  }
+  if (spaceReputationId !== void 0 && spaceReputationId !== null) {
+    result.spaceReputationId = spaceReputationId;
+  }
+  if (spaceReputationDescendants !== void 0 && spaceReputationDescendants !== null) {
+    result.spaceReputationDescendants = spaceReputationDescendants;
+  }
+  return result;
+}
+
 // src/modules/users/fetchUserById.ts
 async function fetchUserById(client, data) {
-  const { userId, ...params } = data;
+  const {
+    userId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(`/users/${userId}`, {
     params
   });
@@ -300,27 +350,72 @@ async function fetchUserById(client, data) {
 
 // src/modules/users/fetchUserByForeignId.ts
 async function fetchUserByForeignId(client, data) {
+  const {
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
   const response = await client.projectInstance.get(
     "/users/by-foreign-id",
-    { params: data }
+    {
+      params: {
+        ...rest,
+        ...buildSpaceReputationParams({
+          spaceReputation,
+          spaceReputationId,
+          spaceReputationDescendants
+        })
+      }
+    }
   );
   return response.data;
 }
 
 // src/modules/users/fetchUserByUsername.ts
 async function fetchUserByUsername(client, data) {
+  const {
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
   const response = await client.projectInstance.get(
     "/users/by-username",
-    { params: data }
+    {
+      params: {
+        ...rest,
+        ...buildSpaceReputationParams({
+          spaceReputation,
+          spaceReputationId,
+          spaceReputationDescendants
+        })
+      }
+    }
   );
   return response.data;
 }
 
 // src/modules/users/fetchUserSuggestions.ts
 async function fetchUserSuggestions(client, data) {
+  const {
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
   const response = await client.projectInstance.get(
     "/users/suggestions",
-    { params: data }
+    {
+      params: {
+        ...rest,
+        ...buildSpaceReputationParams({
+          spaceReputation,
+          spaceReputationId,
+          spaceReputationDescendants
+        })
+      }
+    }
   );
   return response.data;
 }
@@ -379,7 +474,21 @@ async function updateUser(client, data) {
 
 // src/modules/users/fetchFollowersByUserId.ts
 async function fetchFollowersByUserId(client, data) {
-  const { userId, ...params } = data;
+  const {
+    userId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(`/users/${userId}/followers`, { params });
   return response.data;
 }
@@ -395,7 +504,21 @@ async function fetchFollowersCountByUserId(client, data) {
 
 // src/modules/users/fetchFollowingByUserId.ts
 async function fetchFollowingByUserId(client, data) {
-  const { userId, ...params } = data;
+  const {
+    userId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(`/users/${userId}/following`, { params });
   return response.data;
 }
@@ -411,7 +534,21 @@ async function fetchFollowingCountByUserId(client, data) {
 
 // src/modules/users/fetchConnectionsByUserId.ts
 async function fetchConnectionsByUserId(client, data) {
-  const { userId, ...params } = data;
+  const {
+    userId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(`/users/${userId}/connections`, { params });
   return response.data;
 }
@@ -507,7 +644,21 @@ async function createEntity(client, data) {
 
 // src/modules/entities/fetchEntity.ts
 async function fetchEntity(client, data) {
-  const { entityId, ...params } = data;
+  const {
+    entityId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(
     `/entities/${entityId}`,
     { params }
@@ -536,10 +687,23 @@ async function fetchEntityByShortId(client, data) {
 // src/modules/entities/fetchManyEntities.ts
 async function fetchManyEntities(client, data) {
   const path = `/entities`;
+  const {
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
   const response = await client.projectInstance.get(
     path,
     {
-      params: data
+      params: {
+        ...rest,
+        ...buildSpaceReputationParams({
+          spaceReputation,
+          spaceReputationId,
+          spaceReputationDescendants
+        })
+      }
     }
   );
   return response.data;
@@ -611,7 +775,21 @@ async function removeReaction(client, data) {
 
 // src/modules/entities/fetchReactions.ts
 async function fetchReactions(client, data) {
-  const { entityId, ...params } = data;
+  const {
+    entityId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(
     `/entities/${entityId}/reactions`,
     { params }
@@ -840,7 +1018,21 @@ async function createComment(client, data) {
 
 // src/modules/comments/fetchComment.ts
 async function fetchComment(client, data) {
-  const { commentId, ...params } = data;
+  const {
+    commentId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(
     `/comments/${commentId}`,
     { params }
@@ -877,9 +1069,24 @@ async function deleteComment(client, data) {
 
 // src/modules/comments/fetchManyComments.ts
 async function fetchManyComments(client, data) {
+  const {
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
   const response = await client.projectInstance.get(
     "/comments",
-    { params: data }
+    {
+      params: {
+        ...rest,
+        ...buildSpaceReputationParams({
+          spaceReputation,
+          spaceReputationId,
+          spaceReputationDescendants
+        })
+      }
+    }
   );
   return response.data;
 }
@@ -905,7 +1112,21 @@ async function removeReaction2(client, data) {
 
 // src/modules/comments/fetchReactions.ts
 async function fetchReactions2(client, data) {
-  const { commentId, ...params } = data;
+  const {
+    commentId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(
     `/comments/${commentId}/reactions`,
     { params }
@@ -1130,7 +1351,21 @@ async function checkMyMembership(client, data) {
 
 // src/modules/spaces/fetchSpaceMembers.ts
 async function fetchSpaceMembers(client, data) {
-  const { spaceId, ...params } = data;
+  const {
+    spaceId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(
     `/spaces/${spaceId}/members`,
     { params }
@@ -1140,7 +1375,21 @@ async function fetchSpaceMembers(client, data) {
 
 // src/modules/spaces/fetchSpaceTeam.ts
 async function fetchSpaceTeam(client, data) {
-  const { spaceId, ...params } = data;
+  const {
+    spaceId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(
     `/spaces/${spaceId}/team`,
     { params }
@@ -1595,9 +1844,24 @@ async function createReport(client, data) {
 
 // src/modules/reports/fetchModeratedReports.ts
 async function fetchModeratedReports(client, data) {
+  const {
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
   const response = await client.projectInstance.get(
     "/reports/moderated",
-    { params: data }
+    {
+      params: {
+        ...rest,
+        ...buildSpaceReputationParams({
+          spaceReputation,
+          spaceReputationId,
+          spaceReputationDescendants
+        })
+      }
+    }
   );
   return response.data;
 }
@@ -1606,6 +1870,7 @@ async function fetchModeratedReports(client, data) {
 var search_exports = {};
 __export(search_exports, {
   askContent: () => askContent,
+  matchUsers: () => matchUsers,
   searchContent: () => searchContent,
   searchSpaces: () => searchSpaces,
   searchUsers: () => searchUsers
@@ -1613,11 +1878,22 @@ __export(search_exports, {
 
 // src/modules/search/searchContent.ts
 async function searchContent(client, data) {
-  const { spaceReputationId, spaceReputationDescendants, ...body } = data;
+  const {
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...body
+  } = data;
   const response = await client.projectInstance.post(
     "/search/content",
     body,
-    { params: { spaceReputationId, spaceReputationDescendants } }
+    {
+      params: buildSpaceReputationParams({
+        spaceReputation,
+        spaceReputationId,
+        spaceReputationDescendants
+      })
+    }
   );
   return response.data;
 }
@@ -1674,20 +1950,31 @@ function parseSseBlock(block) {
   }
 }
 async function* askContent(client, data) {
-  const { signal, spaceReputationId, spaceReputationDescendants, ...body } = data;
+  const {
+    signal,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...body
+  } = data;
   const baseURL = client.projectInstance.defaults.baseURL ?? "";
   const authHeader = await client.getAuthHeader();
   const headers = {
     "Content-Type": "application/json"
   };
   if (authHeader) headers.Authorization = authHeader;
+  const flatParams = buildSpaceReputationParams({
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants
+  });
   const search = new URLSearchParams();
-  if (spaceReputationId != null)
-    search.set("spaceReputationId", spaceReputationId);
-  if (spaceReputationDescendants != null)
+  if (flatParams.spaceReputationId != null)
+    search.set("spaceReputationId", flatParams.spaceReputationId);
+  if (flatParams.spaceReputationDescendants != null)
     search.set(
       "spaceReputationDescendants",
-      String(spaceReputationDescendants)
+      String(flatParams.spaceReputationDescendants)
     );
   const queryString = search.toString();
   const url = `${baseURL}/search/ask${queryString ? `?${queryString}` : ""}`;
@@ -1733,6 +2020,15 @@ async function* askContent(client, data) {
   }
 }
 
+// src/modules/search/matchUsers.ts
+async function matchUsers(client, data) {
+  const response = await client.projectInstance.post(
+    "/match/users",
+    data
+  );
+  return response.data;
+}
+
 // src/modules/storage/index.ts
 var storage_exports = {};
 __export(storage_exports, {
@@ -1918,7 +2214,21 @@ async function getUnreadCount(client) {
 
 // src/modules/chat/listMembers.ts
 async function listMembers(client, data) {
-  const { conversationId, ...params } = data;
+  const {
+    conversationId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(`/chat/conversations/${conversationId}/members`, { params });
   return response.data;
 }
@@ -1963,7 +2273,21 @@ async function changeMemberRole(client, data) {
 
 // src/modules/chat/listMessages.ts
 async function listMessages(client, data) {
-  const { conversationId, ...params } = data;
+  const {
+    conversationId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(
     `/chat/conversations/${conversationId}/messages`,
     { params }
@@ -1977,13 +2301,20 @@ async function sendMessage(client, data) {
     conversationId,
     files,
     // The server reads these from `req.query`, not the body, so they are
-    // forwarded as query params (in both the JSON and multipart branches).
+    // forwarded as query params (in both the JSON and multipart branches),
+    // flattened via the helper so the `spaceReputation` object never reaches
+    // the serializer.
+    spaceReputation,
     spaceReputationId,
     spaceReputationDescendants,
     ...body
   } = data;
   const path = `/chat/conversations/${conversationId}/messages`;
-  const params = { spaceReputationId, spaceReputationDescendants };
+  const params = buildSpaceReputationParams({
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants
+  });
   if (files && files.length > 0) {
     const formData = new FormData();
     for (const file of files) {
@@ -2005,7 +2336,22 @@ async function sendMessage(client, data) {
 
 // src/modules/chat/getMessage.ts
 async function getMessage(client, data) {
-  const { conversationId, messageId, ...params } = data;
+  const {
+    conversationId,
+    messageId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(
     `/chat/conversations/${conversationId}/messages/${messageId}`,
     { params }
@@ -2044,7 +2390,22 @@ async function toggleReaction(client, data) {
 
 // src/modules/chat/listReactions.ts
 async function listReactions(client, data) {
-  const { conversationId, messageId, ...params } = data;
+  const {
+    conversationId,
+    messageId,
+    spaceReputation,
+    spaceReputationId,
+    spaceReputationDescendants,
+    ...rest
+  } = data;
+  const params = {
+    ...rest,
+    ...buildSpaceReputationParams({
+      spaceReputation,
+      spaceReputationId,
+      spaceReputationDescendants
+    })
+  };
   const response = await client.projectInstance.get(
     `/chat/conversations/${conversationId}/messages/${messageId}/reactions`,
     { params }

package/dist/interfaces/SpaceReputation.d.ts

@@ -20,18 +20,37 @@
  */
 export interface SpaceReputationContextParams {
     /**
+     * Opt into space-scoped reputation enrichment. The primary form: an object
+     * describing the space and whether to include descendants.
+     *
+     * - `spaceId` — a space `<uuid>` (reputation within that specific space),
+     *   `"none"` (no space context — global reputation only), or `"context"`
+     *   (derive the space from each record's own context, e.g. a feed enriches
+     *   each row's author with reputation in that row's space).
+     * - `includeDescendants` — whether to include descendant spaces when
+     *   computing space-scoped reputation. Only honored with an explicit space
+     *   `<uuid>` (ignored for `"none"` / `"context"`).
+     */
+    spaceReputation?: {
+        spaceId: string | "none" | "context";
+        includeDescendants?: boolean;
+    };
+    /**
+     * @deprecated Pass the `spaceReputation` object instead. Retained for
+     * back-compat; removal is a later major version.
+     *
      * Opt into space-scoped reputation enrichment. Accepted forms:
      * - a space `<uuid>` — reputation within that specific space;
      * - `"none"` — no space context (global reputation only);
      * - `"context"` — derive the space from each record's own context
      *   (e.g. a feed enriches each row's author with reputation in that row's
      *   space).
-     *
-     * Plain `string` — a `string | "none" | "context"` union adds no safety
-     * since a uuid is already a string.
      */
     spaceReputationId?: string;
     /**
+     * @deprecated Pass the `spaceReputation` object (`includeDescendants`)
+     * instead. Retained for back-compat; removal is a later major version.
+     *
      * Whether to include descendant spaces when computing space-scoped
      * reputation. Only honored with an explicit space `<uuid>` (ignored for
      * `"none"` / `"context"`).
@@ -43,18 +62,37 @@ export interface SpaceReputationContextParams {
  */
 export interface SpaceReputationUserParams {
     /**
+     * Opt into space-scoped reputation enrichment. The primary form: an object
+     * describing the space and whether to include descendants.
+     *
+     * - `spaceId` — a space `<uuid>` (reputation within that specific space) or
+     *   `"none"` (no space context — global reputation only). `"context"` is
+     *   **rejected by the server (400)** on user-direct endpoints — there is no
+     *   per-record context to derive a space from.
+     * - `includeDescendants` — whether to include descendant spaces when
+     *   computing space-scoped reputation. Only honored with an explicit space
+     *   `<uuid>`.
+     */
+    spaceReputation?: {
+        spaceId: string | "none";
+        includeDescendants?: boolean;
+    };
+    /**
+     * @deprecated Pass the `spaceReputation` object instead. Retained for
+     * back-compat; removal is a later major version.
+     *
      * Opt into space-scoped reputation enrichment. Accepted forms:
      * - a space `<uuid>` — reputation within that specific space;
      * - `"none"` — no space context (global reputation only).
      *
      * `"context"` is **rejected by the server (400)** on user-direct endpoints —
      * there is no per-record context to derive a space from.
-     *
-     * Plain `string` — a `string | "none"` union adds no safety since a uuid is
-     * already a string.
      */
     spaceReputationId?: string;
     /**
+     * @deprecated Pass the `spaceReputation` object (`includeDescendants`)
+     * instead. Retained for back-compat; removal is a later major version.
+     *
      * Whether to include descendant spaces when computing space-scoped
      * reputation. Only honored with an explicit space `<uuid>`.
      */

package/dist/interfaces/UserSearch.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared optional params for text-searching a list of users
+ * (followers / following / connections).
+ *
+ * - `query` — free-text search term. When omitted, no filtering is applied.
+ * - `searchFields` — narrows which user field the term matches against. When
+ *   omitted, the term matches either `username` OR `name` (case-insensitive
+ *   substring). `"username"` / `"name"` restrict the match to that one field.
+ */
+export interface UserSearchParams {
+    query?: string;
+    searchFields?: "username" | "name";
+}