@sublay/js 7.5.0 → 7.6.0

package/dist/index.d.mts

@@ -734,8 +734,84 @@ interface RemoveConnectionByUserIdProps {
 }
 declare function removeConnectionByUserId(client: SublayHttpClient, data: RemoveConnectionByUserIdProps): Promise<RemoveConnectionByUserIdResponse>;
 
+interface CreateBlockProps {
+    /** The user being blocked (the target). The blocker is the token holder. */
+    userId: string;
+}
+interface BlockResponse {
+    id: string;
+    blockerId: string;
+    blockedId: string;
+    createdAt: string;
+}
+/**
+ * POST /users/:userId/block — block `:userId`.
+ *
+ * The blocker is derived from the token (Rule A — no `actingUserId`). Idempotent:
+ * re-blocking an already-blocked user succeeds. Self-block is rejected server-side.
+ * On a new block the server tears down existing follows/connections both ways.
+ */
+declare function createBlock(client: SublayHttpClient, data: CreateBlockProps): Promise<BlockResponse>;
+
+interface DeleteBlockProps {
+    /** The user being unblocked (the target). The blocker is the token holder. */
+    userId: string;
+}
+/**
+ * DELETE /users/:userId/block — unblock `:userId`.
+ *
+ * The blocker is derived from the token (Rule A — no `actingUserId`). Idempotent:
+ * unblocking a user who isn't blocked succeeds. Restores nothing (torn-down
+ * follows/connections are gone for good).
+ */
+declare function deleteBlock(client: SublayHttpClient, data: DeleteBlockProps): Promise<void>;
+
+interface FetchBlockStatusProps {
+    /**
+     * The user whose block status is being checked (the target). The status is the
+     * token holder's OUTBOUND state only: do *I* block `:userId`?
+     */
+    userId: string;
+}
+/**
+ * The block-status response is outbound-only by design: it reports whether the
+ * token holder blocks the target, and NEVER whether the target blocked the
+ * caller (the inbound direction is deliberately not disclosed).
+ */
+interface BlockStatusResponse {
+    blocked: boolean;
+    blockId?: string;
+    createdAt?: string;
+}
+/**
+ * GET /users/:userId/block — the token holder's outbound block status toward
+ * `:userId` (Rule A — no `actingUserId`).
+ */
+declare function fetchBlockStatus(client: SublayHttpClient, data: FetchBlockStatusProps): Promise<BlockStatusResponse>;
+
+interface FetchBlockedUsersProps {
+    page?: number;
+    limit?: number;
+}
+/** An entry in the token holder's own block list (their outbound blocks). */
+interface BlockedUserListItem {
+    id: string;
+    blockedUser: User | null;
+    createdAt: string;
+}
+/**
+ * GET /blocks — the token holder's own block list (their outbound blocks),
+ * paginated. This is the private "manage / way back to unblock" surface (Rule A
+ * — the subject is derived from the token, no `actingUserId`).
+ */
+declare function fetchBlockedUsers(client: SublayHttpClient, data?: FetchBlockedUsersProps): Promise<PaginatedResponse<BlockedUserListItem>>;
+
 declare const Users_checkUsernameAvailability: typeof checkUsernameAvailability;
+declare const Users_createBlock: typeof createBlock;
 declare const Users_createFollow: typeof createFollow;
+declare const Users_deleteBlock: typeof deleteBlock;
+declare const Users_fetchBlockStatus: typeof fetchBlockStatus;
+declare const Users_fetchBlockedUsers: typeof fetchBlockedUsers;
 declare const Users_fetchConnectionStatus: typeof fetchConnectionStatus;
 declare const Users_fetchConnectionsByUserId: typeof fetchConnectionsByUserId;
 declare const Users_fetchConnectionsCountByUserId: typeof fetchConnectionsCountByUserId;
@@ -752,7 +828,7 @@ declare const Users_removeConnectionByUserId: typeof removeConnectionByUserId;
 declare const Users_requestConnection: typeof requestConnection;
 declare const Users_updateUser: typeof updateUser;
 declare namespace Users {
-  export { Users_checkUsernameAvailability as checkUsernameAvailability, Users_createFollow as createFollow, deleteFollow$1 as deleteFollow, Users_fetchConnectionStatus as fetchConnectionStatus, Users_fetchConnectionsByUserId as fetchConnectionsByUserId, Users_fetchConnectionsCountByUserId as fetchConnectionsCountByUserId, Users_fetchFollowStatus as fetchFollowStatus, Users_fetchFollowersByUserId as fetchFollowersByUserId, Users_fetchFollowersCountByUserId as fetchFollowersCountByUserId, Users_fetchFollowingByUserId as fetchFollowingByUserId, Users_fetchFollowingCountByUserId as fetchFollowingCountByUserId, Users_fetchUserByForeignId as fetchUserByForeignId, Users_fetchUserById as fetchUserById, Users_fetchUserByUsername as fetchUserByUsername, Users_fetchUserSuggestions as fetchUserSuggestions, Users_removeConnectionByUserId as removeConnectionByUserId, Users_requestConnection as requestConnection, Users_updateUser as updateUser };
+  export { Users_checkUsernameAvailability as checkUsernameAvailability, Users_createBlock as createBlock, Users_createFollow as createFollow, Users_deleteBlock as deleteBlock, deleteFollow$1 as deleteFollow, Users_fetchBlockStatus as fetchBlockStatus, Users_fetchBlockedUsers as fetchBlockedUsers, Users_fetchConnectionStatus as fetchConnectionStatus, Users_fetchConnectionsByUserId as fetchConnectionsByUserId, Users_fetchConnectionsCountByUserId as fetchConnectionsCountByUserId, Users_fetchFollowStatus as fetchFollowStatus, Users_fetchFollowersByUserId as fetchFollowersByUserId, Users_fetchFollowersCountByUserId as fetchFollowersCountByUserId, Users_fetchFollowingByUserId as fetchFollowingByUserId, Users_fetchFollowingCountByUserId as fetchFollowingCountByUserId, Users_fetchUserByForeignId as fetchUserByForeignId, Users_fetchUserById as fetchUserById, Users_fetchUserByUsername as fetchUserByUsername, Users_fetchUserSuggestions as fetchUserSuggestions, Users_removeConnectionByUserId as removeConnectionByUserId, Users_requestConnection as requestConnection, Users_updateUser as updateUser };
 }
 
 type Mention = UserMention | SpaceMention;
@@ -1085,6 +1161,7 @@ interface FetchManyEntitiesProps extends SpaceReputationContextParams {
     attachmentsFilters?: AttachmentsFilters;
     locationFilters?: LocationFilters;
     nsfwFilter?: "include-all" | "exclude" | "only";
+    blockedFilter?: "exclude" | "include-outbound-blocked";
 }
 declare function fetchManyEntities(client: SublayHttpClient, data: FetchManyEntitiesProps): Promise<PaginatedResponse<Entity>>;
 
@@ -1574,6 +1651,7 @@ interface FetchManyCommentsProps extends SpaceReputationContextParams {
     sortDir?: "asc" | "desc";
     include?: string;
     sourceId?: string;
+    blockedFilter?: "exclude" | "include-outbound-blocked";
 }
 declare function fetchManyComments(client: SublayHttpClient, data: FetchManyCommentsProps): Promise<PaginatedResponse<Comment>>;
 

package/dist/index.js

@@ -312,8 +312,12 @@ async function confirmAccountDeletion(client, data) {
 var users_exports = {};
 __export(users_exports, {
   checkUsernameAvailability: () => checkUsernameAvailability,
+  createBlock: () => createBlock,
   createFollow: () => createFollow,
+  deleteBlock: () => deleteBlock,
   deleteFollow: () => deleteFollow,
+  fetchBlockStatus: () => fetchBlockStatus,
+  fetchBlockedUsers: () => fetchBlockedUsers,
   fetchConnectionStatus: () => fetchConnectionStatus,
   fetchConnectionsByUserId: () => fetchConnectionsByUserId,
   fetchConnectionsCountByUserId: () => fetchConnectionsCountByUserId,
@@ -657,6 +661,37 @@ async function removeConnectionByUserId(client, data) {
   return response.data;
 }
 
+// src/modules/users/createBlock.ts
+async function createBlock(client, data) {
+  const { userId } = data;
+  const response = await client.projectInstance.post(
+    `/users/${userId}/block`,
+    {}
+  );
+  return response.data;
+}
+
+// src/modules/users/deleteBlock.ts
+async function deleteBlock(client, data) {
+  const { userId } = data;
+  await client.projectInstance.delete(`/users/${userId}/block`);
+}
+
+// src/modules/users/fetchBlockStatus.ts
+async function fetchBlockStatus(client, data) {
+  const { userId } = data;
+  const response = await client.projectInstance.get(
+    `/users/${userId}/block`
+  );
+  return response.data;
+}
+
+// src/modules/users/fetchBlockedUsers.ts
+async function fetchBlockedUsers(client, data = {}) {
+  const response = await client.projectInstance.get("/blocks", { params: data });
+  return response.data;
+}
+
 // src/modules/entities/index.ts
 var entities_exports = {};
 __export(entities_exports, {

package/dist/index.mjs

@@ -280,8 +280,12 @@ async function confirmAccountDeletion(client, data) {
 var users_exports = {};
 __export(users_exports, {
   checkUsernameAvailability: () => checkUsernameAvailability,
+  createBlock: () => createBlock,
   createFollow: () => createFollow,
+  deleteBlock: () => deleteBlock,
   deleteFollow: () => deleteFollow,
+  fetchBlockStatus: () => fetchBlockStatus,
+  fetchBlockedUsers: () => fetchBlockedUsers,
   fetchConnectionStatus: () => fetchConnectionStatus,
   fetchConnectionsByUserId: () => fetchConnectionsByUserId,
   fetchConnectionsCountByUserId: () => fetchConnectionsCountByUserId,
@@ -625,6 +629,37 @@ async function removeConnectionByUserId(client, data) {
   return response.data;
 }
 
+// src/modules/users/createBlock.ts
+async function createBlock(client, data) {
+  const { userId } = data;
+  const response = await client.projectInstance.post(
+    `/users/${userId}/block`,
+    {}
+  );
+  return response.data;
+}
+
+// src/modules/users/deleteBlock.ts
+async function deleteBlock(client, data) {
+  const { userId } = data;
+  await client.projectInstance.delete(`/users/${userId}/block`);
+}
+
+// src/modules/users/fetchBlockStatus.ts
+async function fetchBlockStatus(client, data) {
+  const { userId } = data;
+  const response = await client.projectInstance.get(
+    `/users/${userId}/block`
+  );
+  return response.data;
+}
+
+// src/modules/users/fetchBlockedUsers.ts
+async function fetchBlockedUsers(client, data = {}) {
+  const response = await client.projectInstance.get("/blocks", { params: data });
+  return response.data;
+}
+
 // src/modules/entities/index.ts
 var entities_exports = {};
 __export(entities_exports, {

package/dist/modules/comments/fetchManyComments.d.ts

@@ -21,5 +21,6 @@ export interface FetchManyCommentsProps extends SpaceReputationContextParams {
     sortDir?: "asc" | "desc";
     include?: string;
     sourceId?: string;
+    blockedFilter?: "exclude" | "include-outbound-blocked";
 }
 export declare function fetchManyComments(client: SublayHttpClient, data: FetchManyCommentsProps): Promise<PaginatedResponse<Comment>>;

package/dist/modules/entities/fetchManyEntities.d.ts

@@ -60,5 +60,6 @@ export interface FetchManyEntitiesProps extends SpaceReputationContextParams {
     attachmentsFilters?: AttachmentsFilters;
     locationFilters?: LocationFilters;
     nsfwFilter?: "include-all" | "exclude" | "only";
+    blockedFilter?: "exclude" | "include-outbound-blocked";
 }
 export declare function fetchManyEntities(client: SublayHttpClient, data: FetchManyEntitiesProps): Promise<PaginatedResponse<Entity>>;

package/dist/modules/users/createBlock.d.ts

@@ -0,0 +1,19 @@
+import { SublayHttpClient } from "../../core/client";
+export interface CreateBlockProps {
+    /** The user being blocked (the target). The blocker is the token holder. */
+    userId: string;
+}
+export interface BlockResponse {
+    id: string;
+    blockerId: string;
+    blockedId: string;
+    createdAt: string;
+}
+/**
+ * POST /users/:userId/block — block `:userId`.
+ *
+ * The blocker is derived from the token (Rule A — no `actingUserId`). Idempotent:
+ * re-blocking an already-blocked user succeeds. Self-block is rejected server-side.
+ * On a new block the server tears down existing follows/connections both ways.
+ */
+export declare function createBlock(client: SublayHttpClient, data: CreateBlockProps): Promise<BlockResponse>;

package/dist/modules/users/deleteBlock.d.ts

@@ -0,0 +1,13 @@
+import { SublayHttpClient } from "../../core/client";
+export interface DeleteBlockProps {
+    /** The user being unblocked (the target). The blocker is the token holder. */
+    userId: string;
+}
+/**
+ * DELETE /users/:userId/block — unblock `:userId`.
+ *
+ * The blocker is derived from the token (Rule A — no `actingUserId`). Idempotent:
+ * unblocking a user who isn't blocked succeeds. Restores nothing (torn-down
+ * follows/connections are gone for good).
+ */
+export declare function deleteBlock(client: SublayHttpClient, data: DeleteBlockProps): Promise<void>;

package/dist/modules/users/fetchBlockStatus.d.ts

@@ -0,0 +1,23 @@
+import { SublayHttpClient } from "../../core/client";
+export interface FetchBlockStatusProps {
+    /**
+     * The user whose block status is being checked (the target). The status is the
+     * token holder's OUTBOUND state only: do *I* block `:userId`?
+     */
+    userId: string;
+}
+/**
+ * The block-status response is outbound-only by design: it reports whether the
+ * token holder blocks the target, and NEVER whether the target blocked the
+ * caller (the inbound direction is deliberately not disclosed).
+ */
+export interface BlockStatusResponse {
+    blocked: boolean;
+    blockId?: string;
+    createdAt?: string;
+}
+/**
+ * GET /users/:userId/block — the token holder's outbound block status toward
+ * `:userId` (Rule A — no `actingUserId`).
+ */
+export declare function fetchBlockStatus(client: SublayHttpClient, data: FetchBlockStatusProps): Promise<BlockStatusResponse>;

package/dist/modules/users/fetchBlockedUsers.d.ts

@@ -0,0 +1,19 @@
+import { SublayHttpClient } from "../../core/client";
+import { User } from "../../interfaces/User";
+import { PaginatedResponse } from "../../interfaces/IPaginatedResponse";
+export interface FetchBlockedUsersProps {
+    page?: number;
+    limit?: number;
+}
+/** An entry in the token holder's own block list (their outbound blocks). */
+export interface BlockedUserListItem {
+    id: string;
+    blockedUser: User | null;
+    createdAt: string;
+}
+/**
+ * GET /blocks — the token holder's own block list (their outbound blocks),
+ * paginated. This is the private "manage / way back to unblock" surface (Rule A
+ * — the subject is derived from the token, no `actingUserId`).
+ */
+export declare function fetchBlockedUsers(client: SublayHttpClient, data?: FetchBlockedUsersProps): Promise<PaginatedResponse<BlockedUserListItem>>;

package/dist/modules/users/index.d.ts

@@ -16,3 +16,7 @@ export { fetchFollowStatus } from "./fetchFollowStatus";
 export { requestConnection } from "./requestConnection";
 export { fetchConnectionStatus } from "./fetchConnectionStatus";
 export { removeConnectionByUserId } from "./removeConnectionByUserId";
+export { createBlock } from "./createBlock";
+export { deleteBlock } from "./deleteBlock";
+export { fetchBlockStatus } from "./fetchBlockStatus";
+export { fetchBlockedUsers } from "./fetchBlockedUsers";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sublay/js",
-  "version": "7.5.0",
+  "version": "7.6.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [