@foru-ms/sdk 1.2.3 → 1.2.5

package/README.md

@@ -43,7 +43,6 @@ client.setToken('user_jwt_token');
 const thread = await client.threads.create({
   title: 'My First Thread',
   body: 'Hello, Foru.ms!',
-  userId: 'user-123',
 });
 
 // List threads with auto-pagination
@@ -97,7 +96,7 @@ The SDK provides multiple ways to handle pagination:
 ```typescript
 // Auto-pagination with async iterator
 for await (const thread of client.pagination.paginateAll(
-  (cursor) => client.threads.list({ cursor, filter: 'newest' })
+  (cursor) => client.threads.list({ cursor, filter: 'newest', limit: 25 })
 )) {
   console.log(thread.title);
 }
@@ -108,15 +107,38 @@ const allThreads = await client.pagination.fetchAllPages(
   5 // max pages
 );
 
-// Manual pagination
+// Manual pagination with custom page size
 let cursor: string | undefined;
 do {
-  const response = await client.threads.list({ cursor });
+  const response = await client.threads.list({ 
+    cursor, 
+    limit: 50 // Request up to 50 items per page (max)
+  });
   // Process threads...
   cursor = response.nextThreadCursor;
 } while (cursor);
 ```
 
+### Pagination Limit Parameter
+
+All paginated endpoints support an optional `limit` parameter to control page size:
+
+- **Min**: 1
+- **Max**: 50
+- **Default**: 15
+
+```typescript
+// Get 50 threads per page (maximum)
+const threads = await client.threads.list({ limit: 50 });
+
+// Get 10 users per page
+const users = await client.users.list({ limit: 10 });
+
+// Limit applies to all paginated endpoints
+const posts = await client.posts.list({ limit: 25 });
+const notifications = await client.notifications.list({ limit: 30 });
+```
+
 ## Webhooks
 
 Verify webhook signatures for security. All webhooks include:
@@ -188,31 +210,31 @@ Check the `/examples` directory for detailed examples:
 ### Threads (`client.threads`)
 
 **Thread Management**
-*   `list(params: { query?: string; tagId?: string; filter?: 'newest' | 'oldest'; type?: 'created' | 'liked' | 'disliked' | 'upvoted' | 'downvoted' | 'subscribed'; cursor?: string; userId?: string })`: List threads with filtering options.
+*   `list(params: { query?: string; tagId?: string; filter?: 'newest' | 'oldest'; type?: 'created' | 'liked' | 'disliked' | 'upvoted' | 'downvoted' | 'subscribed'; cursor?: string; userId?: string; limit?: number })`: List threads with filtering options. `limit` controls page size (1-50, default: 15).
 *   `create(payload: CreateThreadPayload)`: Create a new thread.
 *   `retrieve(id: string)`: Get a thread by ID.
 *   `update(id: string, payload: UpdateThreadPayload)`: Update a thread.
 *   `delete(id: string)`: Delete a thread.
-*   `getPosts(id: string, params: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get posts in a thread.
+*   `getPosts(id: string, params: { query?: string; cursor?: string; filter?: 'newest' | 'oldest'; limit?: number })`: Get posts in a thread.
 
 **Thread Interactions**
 *   `like(id: string, userId?: string, extendedData?: any)`: Like a thread.
 *   `unlike(id: string, userId?: string)`: Unlike a thread.
-*   `getLikes(id: string, params?: { cursor?: string })`: Get users who liked a thread with pagination.
+*   `getLikes(id: string, params?: { cursor?: string; limit?: number })`: Get users who liked a thread with pagination.
 *   `dislike(id: string, userId?: string, extendedData?: any)`: Dislike a thread.
 *   `undislike(id: string, userId?: string)`: Remove dislike from a thread.
-*   `getDislikes(id: string, params?: { cursor?: string })`: Get users who disliked a thread with pagination.
+*   `getDislikes(id: string, params?: { cursor?: string; limit?: number })`: Get users who disliked a thread with pagination.
 *   `upvote(id: string, userId?: string, extendedData?: any)`: Upvote a thread.
 *   `unupvote(id: string, userId?: string)`: Remove upvote from a thread.
-*   `getUpvotes(id: string, params?: { cursor?: string })`: Get users who upvoted a thread with pagination.
+*   `getUpvotes(id: string, params?: { cursor?: string; limit?: number })`: Get users who upvoted a thread with pagination.
 *   `downvote(id: string, userId?: string, extendedData?: any)`: Downvote a thread.
 *   `undownvote(id: string, userId?: string)`: Remove downvote from a thread.
-*   `getDownvotes(id: string, params?: { cursor?: string })`: Get users who downvoted a thread with pagination.
+*   `getDownvotes(id: string, params?: { cursor?: string; limit?: number })`: Get users who downvoted a thread with pagination.
 
 **Thread Subscriptions**
 *   `subscribe(id: string, userId?: string, extendedData?: any)`: Subscribe to a thread.
 *   `unsubscribe(id: string, userId?: string)`: Unsubscribe from a thread.
-*   `getSubscribers(id: string, params?: { cursor?: string })`: Get users subscribed to a thread with pagination.
+*   `getSubscribers(id: string, params?: { cursor?: string; limit?: number })`: Get users subscribed to a thread with pagination.
 
 **Thread Polls**
 *   `createPoll(id: string, payload: { title?: string; expiresAt?: string; options: Array<{ title: string; color?: string; extendedData?: any }>, extendedData?: any })`: Create a poll for a thread.
@@ -227,59 +249,59 @@ Check the `/examples` directory for detailed examples:
 ### Posts (`client.posts`)
 
 **Post Management**
-*   `list(params: { query?: string; filter?: 'newest' | 'oldest'; type?: 'created' | 'liked' | 'disliked' | 'upvoted' | 'downvoted'; cursor?: string; userId?: string })`: List posts with filtering options.
+*   `list(params: { query?: string; filter?: 'newest' | 'oldest'; type?: 'created' | 'liked' | 'disliked' | 'upvoted' | 'downvoted'; cursor?: string; userId?: string; limit?: number })`: List posts with filtering options. `limit` controls page size (1-50, default: 15).
 *   `create(payload: CreatePostPayload)`: Create a new post/reply.
 *   `retrieve(id: string)`: Get a post by ID.
 *   `update(id: string, payload: UpdatePostPayload)`: Update a post.
 *   `delete(id: string, payload?: { userId?: string })`: Delete a post.
-*   `getChildren(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get child posts (nested replies).
+*   `getChildren(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest'; limit?: number })`: Get child posts (nested replies).
 
 **Post Interactions**
 *   `like(id: string, userId?: string, extendedData?: any)`: Like a post.
 *   `unlike(id: string, userId?: string)`: Unlike a post.
-*   `getLikes(id: string, params?: { cursor?: string })`: Get users who liked a post with pagination.
+*   `getLikes(id: string, params?: { cursor?: string; limit?: number })`: Get users who liked a post with pagination.
 *   `dislike(id: string, userId?: string, extendedData?: any)`: Dislike a post.
 *   `undislike(id: string, userId?: string)`: Remove dislike from a post.
-*   `getDislikes(id: string, params?: { cursor?: string })`: Get users who disliked a post with pagination.
+*   `getDislikes(id: string, params?: { cursor?: string; limit?: number })`: Get users who disliked a post with pagination.
 *   `upvote(id: string, userId?: string, extendedData?: any)`: Upvote a post.
 *   `unupvote(id: string, userId?: string)`: Remove upvote from a post.
-*   `getUpvotes(id: string, params?: { cursor?: string })`: Get users who upvoted a post with pagination.
+*   `getUpvotes(id: string, params?: { cursor?: string; limit?: number })`: Get users who upvoted a post with pagination.
 *   `downvote(id: string, userId?: string, extendedData?: any)`: Downvote a post.
 *   `undownvote(id: string, userId?: string)`: Remove downvote from a post.
-*   `getDownvotes(id: string, params?: { cursor?: string })`: Get users who downvoted a post with pagination.
+*   `getDownvotes(id: string, params?: { cursor?: string; limit?: number })`: Get users who downvoted a post with pagination.
 
 ### Users (`client.users`)
 
-*   `list(params?: { query?: string; filter?: 'newest' | 'oldest'; cursor?: string })`: List users.
+*   `list(params?: { query?: string; filter?: 'newest' | 'oldest'; cursor?: string; limit?: number })`: List users. `limit` controls page size (1-50, default: 15).
 *   `retrieve(userId: string)`: Get user by ID.
 *   `create(payload: { username: string; email: string; password: string; displayName?: string; emailVerified?: boolean; roles?: string[]; bio?: string; signature?: string; url?: string; extendedData?: Record<string, any> })`: Create a user (Admin).
 *   `update(id: string, payload: { username?: string; email?: string; password?: string; displayName?: string; emailVerified?: boolean; roles?: string[]; bio?: string; signature?: string; url?: string; extendedData?: Record<string, any> })`: Update a user.
 *   `delete(id: string)`: Delete a user.
-*   `getThreads(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get all threads created by a user.
-*   `getPosts(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get all posts created by a user.
-*   `getFollowers(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get user's followers.
-*   `getFollowing(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get who a user follows.
+*   `getThreads(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest'; limit?: number })`: Get all threads created by a user.
+*   `getPosts(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest'; limit?: number })`: Get all posts created by a user.
+*   `getFollowers(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest'; limit?: number })`: Get user's followers.
+*   `getFollowing(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest'; limit?: number })`: Get who a user follows.
 *   `follow(id: string, followerId?: string, extendedData?: any)`: Follow a user.
 *   `unfollow(id: string, followerId?: string)`: Unfollow a user.
 
 
 ### Tags (`client.tags`)
 
-*   `list(params?: { query?: string; cursor?: string })`: List all tags.
-*   `listSubscribed(params: { userId?: string; query?: string; cursor?: string })`: List tags a user is subscribed to.
+*   `list(params?: { query?: string; cursor?: string; limit?: number })`: List all tags. `limit` controls page size (1-50, default: 15).
+*   `listSubscribed(params: { userId?: string; query?: string; cursor?: string; limit?: number })`: List tags a user is subscribed to.
 *   `create(payload: { name: string; description?: string; color?: string; extendedData?: Record<string, any> })`: Create a tag.
 *   `retrieve(id: string, params?: { userId?: string })`: Get a tag with optional user context.
 *   `update(id: string, payload: { name?: string; description?: string; color?: string; extendedData?: Record<string, any> })`: Update a tag.
 *   `delete(id: string)`: Delete a tag.
-*   `getThreads(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest' })`: Get all threads with a specific tag.
+*   `getThreads(id: string, params?: { query?: string; cursor?: string; filter?: 'newest' | 'oldest'; limit?: number })`: Get all threads with a specific tag.
 *   `subscribe(id: string, userId?: string)`: Subscribe to a tag.
 *   `unsubscribe(id: string, userId?: string)`: Unsubscribe from a tag.
-*   `getSubscribers(id: string, params?: { cursor?: string })`: Get users subscribed to a tag with pagination.
+*   `getSubscribers(id: string, params?: { cursor?: string; limit?: number })`: Get users subscribed to a tag with pagination.
 
 
 ### Notifications (`client.notifications`)
 
-*   `list(params: { userId?: string; read?: boolean; filter?: 'newest' | 'oldest'; cursor?: string })`: List notifications for a user.
+*   `list(params: { userId?: string; read?: boolean; filter?: 'newest' | 'oldest'; cursor?: string; limit?: number })`: List notifications for a user. `limit` controls page size (1-50, default: 15).
 *   `create(payload: { threadId?: string; postId?: string; privateMessageId?: string; notifierId?: string; notifiedId: string; type: string; description?: string; extendedData?: Record<string, any> })`: Create a notification manually.
 *   `retrieve(id: string, userId?: string)`: Get a notification by ID.
 *   `update(id: string, payload: { userId?: string; read: boolean })`: Update a notification's read status.
@@ -288,7 +310,7 @@ Check the `/examples` directory for detailed examples:
 
 ### Search (`client.search`)
 
-*   `search(params: { query: string; type: 'threads' | 'posts' | 'users' | 'tags'; cursor?: string })`: Polymorphic search.
+*   `search(params: { query: string; type: 'threads' | 'posts' | 'users' | 'tags'; cursor?: string; limit?: number })`: Polymorphic search. `limit` controls page size (1-50, default: 15).
 
 ### Webhooks (`client.webhooks`)
 
@@ -297,7 +319,7 @@ Check the `/examples` directory for detailed examples:
 *   `retrieve(id: string)`: Get a webhook by ID.
 *   `update(id: string, payload: { name?: string; url?: string; events?: string[]; active?: boolean })`: Update a webhook configuration.
 *   `delete(id: string)`: Delete a webhook.
-*   `getDeliveries(id: string, params?: { cursor?: string })`: Get webhook delivery history with pagination. Track successful and failed deliveries.
+*   `getDeliveries(id: string, params?: { cursor?: string; limit?: number })`: Get webhook delivery history with pagination. Track successful and failed deliveries. `limit` controls page size (1-50, default: 15).
 *   `verifySignature(payload: any, signature: string, timestamp: string, secret: string, maxAge?: number)`: Verify webhook signature for security. Uses HMAC-SHA256. Default maxAge is 5 minutes to prevent replay attacks.
 
 ### Stats (`client.stats`)
@@ -317,7 +339,7 @@ Check the `/examples` directory for detailed examples:
 
 ### Private Messages (`client.privateMessages`)
 
-*   `list(params?: { query?: string; userId?: string; filter?: 'newest' | 'oldest'; cursor?: string })`: List private messages.
+*   `list(params?: { query?: string; userId?: string; filter?: 'newest' | 'oldest'; cursor?: string; limit?: number })`: List private messages. `limit` controls page size (1-50, default: 15).
 *   `create(payload: { title?: string; body: string; recipientId: string; senderId?: string; extendedData?: Record<string, any> })`: Send a new private message.
 *   `retrieve(id: string, userId?: string)`: Get a message by ID.
 *   `reply(id: string, payload: { body: string; senderId?: string; title?: string; extendedData?: Record<string, any> })`: Reply to a message thread.
@@ -326,7 +348,7 @@ Check the `/examples` directory for detailed examples:
 
 ### Reports (`client.reports`)
 
-*   `list(params?: { reporterId?: string; reportedId?: string; read?: boolean; cursor?: string; filter?: 'newest' | 'oldest' })`: List reports with filtering options.
+*   `list(params?: { reporterId?: string; reportedId?: string; read?: boolean; cursor?: string; filter?: 'newest' | 'oldest'; limit?: number })`: List reports with filtering options. `limit` controls page size (1-50, default: 15).
 *   `create(payload: { reporterId?: string; reportedId?: string; threadId?: string; postId?: string; privateMessageId?: string; type?: string; description?: string; extendedData?: Record<string, any> })`: Submit a new report.
 *   `retrieve(id: string)`: Get a report by ID.
 *   `update(id: string, payload: { threadId?: string; postId?: string; privateMessageId?: string; reportedId?: string; reporterId?: string; type?: string; description?: string; read?: boolean; extendedData?: Record<string, any> })`: Update report details (full update).
@@ -336,7 +358,7 @@ Check the `/examples` directory for detailed examples:
 
 ### Roles (`client.roles`)
 
-*   `list(params?: { filter?: 'newest' | 'oldest'; cursor?: string })`: List user roles.
+*   `list(params?: { filter?: 'newest' | 'oldest'; cursor?: string; limit?: number })`: List user roles. `limit` controls page size (1-50, default: 15).
 *   `create(payload: { name: string; description?: string; color?: string; extendedData?: Record<string, any> })`: Create a new role.
 *   `retrieve(id: string)`: Get a role by ID.
 *   `update(id: string, payload: { name?: string; description?: string; color?: string; extendedData?: Record<string, any> })`: Update a role.
@@ -525,11 +547,21 @@ We welcome contributions! Please see our contributing guidelines for more inform
 ## Support
 
 - Support: https://foru.ms/support
-- Documentation: https://docs.foru.ms
+- Documentation: https://foru.ms/docs
 - Issues: https://github.com/foru-ms/sdk/issues
 
 ## Changelog
 
+### v1.2.5
+- Added optional `userId` parameter to methods that accept it
+
+### v1.2.4
+- Pagination Enhancement: Added configurable `limit` query parameter to all paginated endpoints
+  - Allows clients to control page size (min: 1, max: 50, default: 15)
+  - Applied to all list operations across Threads, Posts, Users, Tags, Notifications, Private Messages, Reports, Roles, Search, and Webhooks
+  - Updated documentation with usage examples and parameter specifications
+  - Improves API flexibility for different use cases (mobile, desktop, batch processing)
+
 ### v1.2.3
 - README documentation update
 - Enhanced all API reference sections with:

package/dist/resources/Notifications.d.ts

@@ -4,12 +4,13 @@ export declare class NotificationsResource {
     private client;
     constructor(client: ForumClient);
     list(params: {
-        userId: string;
+        userId?: string;
         read?: boolean;
         filter?: 'newest' | 'oldest';
         cursor?: string;
+        limit?: number;
     }): Promise<NotificationListResponse>;
-    markAllAsRead(userId: string, read?: boolean): Promise<{
+    markAllAsRead(userId?: string, read?: boolean): Promise<{
         count: number;
     }>;
     retrieve(id: string): Promise<Notification>;
@@ -23,7 +24,7 @@ export declare class NotificationsResource {
         threadId?: string;
         postId?: string;
         privateMessageId?: string;
-        notifierId: string;
+        notifierId?: string;
         notifiedId: string;
         type: string;
         description?: string;

package/dist/resources/Posts.d.ts

@@ -9,12 +9,13 @@ export declare class PostsResource {
         type?: InteractionType;
         cursor?: string;
         userId?: string;
+        limit?: number;
     }): Promise<PostListResponse>;
     create(payload: import('../types').CreatePostPayload): Promise<import('../types').Post>;
     retrieve(postId: string): Promise<import('../types').Post>;
     update(postId: string, payload: import('../types').UpdatePostPayload): Promise<import('../types').Post>;
     delete(postId: string, payload?: {
-        userId: string;
+        userId?: string;
     }): Promise<import('../types').Post & {
         deleted: boolean;
     }>;
@@ -22,25 +23,30 @@ export declare class PostsResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<any>;
     like(id: string, userId?: string, extendedData?: any): Promise<any>;
-    unlike(id: string, userId: string): Promise<any>;
+    unlike(id: string, userId?: string): Promise<any>;
     getLikes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any>;
     dislike(id: string, userId?: string, extendedData?: any): Promise<any>;
-    undislike(id: string, userId: string): Promise<any>;
+    undislike(id: string, userId?: string): Promise<any>;
     getDislikes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any>;
     upvote(id: string, userId?: string, extendedData?: any): Promise<any>;
-    unupvote(id: string, userId: string): Promise<any>;
+    unupvote(id: string, userId?: string): Promise<any>;
     getUpvotes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any>;
     downvote(id: string, userId?: string, extendedData?: any): Promise<any>;
-    undownvote(id: string, userId: string): Promise<any>;
+    undownvote(id: string, userId?: string): Promise<any>;
     getDownvotes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any>;
 }

package/dist/resources/Posts.js

@@ -59,7 +59,9 @@ class PostsResource {
         });
     }
     async unlike(id, userId) {
-        return this.client.request(`/post/${id}/likes?userId=${userId}`, {
+        return userId ? this.client.request(`/post/${id}/likes?userId=${userId}`, {
+            method: 'DELETE',
+        }) : this.client.request(`/post/${id}/likes`, {
             method: 'DELETE',
         });
     }
@@ -81,7 +83,9 @@ class PostsResource {
         });
     }
     async undislike(id, userId) {
-        return this.client.request(`/post/${id}/dislikes?userId=${userId}`, {
+        return userId ? this.client.request(`/post/${id}/dislikes?userId=${userId}`, {
+            method: 'DELETE',
+        }) : this.client.request(`/post/${id}/dislikes`, {
             method: 'DELETE',
         });
     }
@@ -103,7 +107,9 @@ class PostsResource {
         });
     }
     async unupvote(id, userId) {
-        return this.client.request(`/post/${id}/upvotes?userId=${userId}`, {
+        return userId ? this.client.request(`/post/${id}/upvotes?userId=${userId}`, {
+            method: 'DELETE',
+        }) : this.client.request(`/post/${id}/upvotes`, {
             method: 'DELETE',
         });
     }
@@ -125,7 +131,9 @@ class PostsResource {
         });
     }
     async undownvote(id, userId) {
-        return this.client.request(`/post/${id}/downvotes?userId=${userId}`, {
+        return userId ? this.client.request(`/post/${id}/downvotes?userId=${userId}`, {
+            method: 'DELETE',
+        }) : this.client.request(`/post/${id}/downvotes`, {
             method: 'DELETE',
         });
     }

package/dist/resources/PrivateMessages.d.ts

@@ -8,6 +8,7 @@ export declare class PrivateMessagesResource {
         userId?: string;
         filter?: 'newest' | 'oldest';
         cursor?: string;
+        limit?: number;
     }): Promise<PrivateMessageListResponse>;
     create(payload: {
         title?: string;

package/dist/resources/Reports.d.ts

@@ -9,6 +9,7 @@ export declare class ReportsResource {
         read?: boolean;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<ReportListResponse>;
     create(payload: {
         reporterId: string;

package/dist/resources/Roles.d.ts

@@ -6,6 +6,7 @@ export declare class RolesResource {
     list(params?: {
         filter?: 'newest' | 'oldest';
         cursor?: string;
+        limit?: number;
     }): Promise<RoleListResponse>;
     create(payload: {
         name: string;

package/dist/resources/Search.d.ts

@@ -7,5 +7,6 @@ export declare class SearchResource {
         query: string;
         type: 'threads' | 'posts' | 'users' | 'tags';
         cursor?: string;
+        limit?: number;
     }): Promise<SearchResponse>;
 }

package/dist/resources/Tags.d.ts

@@ -6,6 +6,7 @@ export declare class TagsResource {
     list(params?: {
         query?: string;
         cursor?: string;
+        limit?: number;
     }): Promise<TagListResponse>;
     create(payload: {
         name: string;
@@ -31,15 +32,18 @@ export declare class TagsResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<import('../types').ThreadListResponse>;
-    subscribe(id: string, userId: string): Promise<any>;
-    unsubscribe(id: string, userId: string): Promise<any>;
+    subscribe(id: string, userId?: string): Promise<any>;
+    unsubscribe(id: string, userId?: string): Promise<any>;
     getSubscribers(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any>;
     listSubscribed(params: {
-        userId: string;
+        userId?: string;
         query?: string;
         cursor?: string;
+        limit?: number;
     }): Promise<TagListResponse>;
 }

package/dist/resources/Tags.js

@@ -63,8 +63,9 @@ class TagsResource {
         });
     }
     async unsubscribe(id, userId) {
-        return this.client.request(`/tag/${id}/subscribers?userId=${userId}`, {
+        return this.client.request(`/tag/${id}/subscribers`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
     async getSubscribers(id, params) {

package/dist/resources/Threads.d.ts

@@ -10,12 +10,13 @@ export declare class ThreadsResource {
         type?: InteractionType;
         cursor?: string;
         userId?: string;
+        limit?: number;
     }): Promise<ThreadListResponse>;
     create(payload: import('../types').CreateThreadPayload): Promise<import('../types').Thread>;
     retrieve(threadId: string): Promise<import('../types').Thread>;
     update(threadId: string, payload: import('../types').UpdateThreadPayload): Promise<import('../types').Thread>;
     delete(threadId: string, payload?: {
-        userId: string;
+        userId?: string;
     }): Promise<import('../types').Thread & {
         deleted: boolean;
     }>;
@@ -23,34 +24,40 @@ export declare class ThreadsResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<any>;
     like(id: string, userId?: string, extendedData?: any): Promise<any>;
-    unlike(id: string, userId: string): Promise<any>;
+    unlike(id: string, userId?: string): Promise<any>;
     getLikes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any>;
     dislike(id: string, userId?: string, extendedData?: any): Promise<any>;
-    undislike(id: string, userId: string): Promise<any>;
+    undislike(id: string, userId?: string): Promise<any>;
     getDislikes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any>;
-    subscribe(id: string, userId: string, extendedData?: any): Promise<any>;
-    unsubscribe(id: string, userId: string): Promise<any>;
+    subscribe(id: string, userId?: string, extendedData?: any): Promise<any>;
+    unsubscribe(id: string, userId?: string): Promise<any>;
     getSubscribers(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any>;
     upvote(id: string, userId?: string, extendedData?: any): Promise<any>;
-    unupvote(id: string, userId: string): Promise<any>;
+    unupvote(id: string, userId?: string): Promise<any>;
     getUpvotes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any>;
     downvote(id: string, userId?: string, extendedData?: any): Promise<any>;
-    undownvote(id: string, userId: string): Promise<any>;
+    undownvote(id: string, userId?: string): Promise<any>;
     getDownvotes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any>;
     getPoll(threadId: string, userId?: string): Promise<any>;
-    vote(id: string, optionId: string, userId: string): Promise<any>;
-    voteUpdate(id: string, optionId: string, userId: string): Promise<any>;
-    unvote(id: string, userId: string): Promise<any>;
+    vote(id: string, optionId: string, userId?: string): Promise<any>;
+    voteUpdate(id: string, optionId: string, userId?: string): Promise<any>;
+    unvote(id: string, userId?: string): Promise<any>;
 }

package/dist/resources/Threads.js

@@ -59,8 +59,9 @@ class ThreadsResource {
         });
     }
     async unlike(id, userId) {
-        return this.client.request(`/thread/${id}/likes?userId=${userId}`, {
+        return this.client.request(`/thread/${id}/likes`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
     async getLikes(id, params) {
@@ -81,8 +82,9 @@ class ThreadsResource {
         });
     }
     async undislike(id, userId) {
-        return this.client.request(`/thread/${id}/dislikes?userId=${userId}`, {
+        return this.client.request(`/thread/${id}/dislikes`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
     async getDislikes(id, params) {
@@ -103,8 +105,9 @@ class ThreadsResource {
         });
     }
     async unsubscribe(id, userId) {
-        return this.client.request(`/thread/${id}/subscribers?userId=${userId}`, {
+        return this.client.request(`/thread/${id}/subscribers`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
     async getSubscribers(id, params) {
@@ -125,8 +128,9 @@ class ThreadsResource {
         });
     }
     async unupvote(id, userId) {
-        return this.client.request(`/thread/${id}/upvotes?userId=${userId}`, {
+        return this.client.request(`/thread/${id}/upvotes`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
     async getUpvotes(id, params) {
@@ -147,8 +151,9 @@ class ThreadsResource {
         });
     }
     async undownvote(id, userId) {
-        return this.client.request(`/thread/${id}/downvotes?userId=${userId}`, {
+        return this.client.request(`/thread/${id}/downvotes`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
     async getDownvotes(id, params) {
@@ -183,8 +188,9 @@ class ThreadsResource {
         });
     }
     async unvote(id, userId) {
-        return this.client.request(`/thread/${id}/poll/votes?userId=${userId}`, {
+        return this.client.request(`/thread/${id}/poll/votes`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
 }

package/dist/resources/Users.d.ts

@@ -7,6 +7,7 @@ export declare class UsersResource {
         query?: string;
         filter?: 'newest' | 'oldest';
         cursor?: string;
+        limit?: number;
     }): Promise<UserListResponse>;
     retrieve(userId: string): Promise<User>;
     create(payload: {
@@ -40,16 +41,19 @@ export declare class UsersResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<import('../types').ThreadListResponse>;
     getPosts(id: string, params?: {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<import('../types').PostListResponse>;
     getFollowers(id: string, params?: {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<{
         followers: User[];
         nextUserCursor?: string;
@@ -61,6 +65,7 @@ export declare class UsersResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<{
         following: any[];
         nextUserCursor?: string;

package/dist/resources/Webhooks.d.ts

@@ -61,6 +61,7 @@ export declare class WebhooksResource {
      */
     getDeliveries(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<{
         deliveries: any[];
         total: number;

package/dist/resources/Webhooks.js

@@ -70,6 +70,8 @@ class WebhooksResource {
         const searchParams = new URLSearchParams();
         if (params === null || params === void 0 ? void 0 : params.cursor)
             searchParams.append('cursor', params.cursor);
+        if (params === null || params === void 0 ? void 0 : params.limit)
+            searchParams.append('limit', params.limit.toString());
         return this.client.request(`/webhooks/${id}/deliveries?${searchParams.toString()}`, {
             method: 'GET',
         });

package/examples/error-handling.ts

@@ -59,7 +59,6 @@ async function main() {
         await client.threads.create({
             title: '', // Invalid: empty title
             body: 'Test',
-            userId: 'user-123',
         });
     } catch (error) {
         if (error instanceof ValidationError) {

package/examples/managing-threads.ts

@@ -79,7 +79,6 @@ async function main() {
     const post = await client.posts.create({
         threadId: newThread.id,
         body: 'Thanks for posting! Check out our documentation.',
-        userId: 'moderator-123',
     });
     console.log('Post created:', post.id);
 
@@ -87,7 +86,6 @@ async function main() {
     const reply = await client.posts.create({
         threadId: newThread.id,
         body: 'Thank you! That helps a lot.',
-        userId,
         parentId: post.id, // This makes it a reply
     });
     console.log('Reply created:', reply.id);

package/examples/pagination.ts

@@ -58,8 +58,7 @@ async function main() {
         const response = await client.posts.list({
             cursor,
             filter: 'newest',
-            type: 'created', // Only posts created by user
-            userId: 'user-123',
+            type: 'created',
         });
 
         console.log(`Page ${++pageCount}:`, response.posts.length, 'posts');

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@foru-ms/sdk",
-    "version": "1.2.3",
+    "version": "1.2.5",
     "description": "JavaScript SDK for Foru.ms",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",

package/src/resources/Notifications.ts

@@ -9,10 +9,11 @@ export class NotificationsResource {
     }
 
     async list(params: {
-        userId: string;
+        userId?: string;
         read?: boolean;
         filter?: 'newest' | 'oldest';
         cursor?: string;
+        limit?: number;
     }): Promise<NotificationListResponse> {
         const searchParams = new URLSearchParams();
         Object.entries(params).forEach(([key, value]) => {
@@ -26,7 +27,7 @@ export class NotificationsResource {
         });
     }
 
-    async markAllAsRead(userId: string, read: boolean = true): Promise<{ count: number }> {
+    async markAllAsRead(userId?: string, read: boolean = true): Promise<{ count: number }> {
         return this.client.request<{ count: number }>('/notifications', {
             method: 'PATCH',
             body: JSON.stringify({ userId, read }),
@@ -55,7 +56,7 @@ export class NotificationsResource {
         threadId?: string;
         postId?: string;
         privateMessageId?: string;
-        notifierId: string;
+        notifierId?: string;
         notifiedId: string;
         type: string;
         description?: string;

package/src/resources/Posts.ts

@@ -14,6 +14,7 @@ export class PostsResource {
         type?: InteractionType;
         cursor?: string;
         userId?: string;
+        limit?: number;
     }): Promise<PostListResponse> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -49,7 +50,7 @@ export class PostsResource {
         });
     }
 
-    async delete(postId: string, payload?: { userId: string }): Promise<import('../types').Post & { deleted: boolean }> {
+    async delete(postId: string, payload?: { userId?: string }): Promise<import('../types').Post & { deleted: boolean }> {
         return this.client.request<import('../types').Post & { deleted: boolean }>(`/post/${postId}`, {
             method: 'DELETE',
             body: payload ? JSON.stringify(payload) : undefined,
@@ -59,6 +60,7 @@ export class PostsResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -78,14 +80,17 @@ export class PostsResource {
         });
     }
 
-    async unlike(id: string, userId: string): Promise<any> {
-        return this.client.request(`/post/${id}/likes?userId=${userId}`, {
+    async unlike(id: string, userId?: string): Promise<any> {
+        return userId ? this.client.request(`/post/${id}/likes?userId=${userId}`, {
+            method: 'DELETE',
+        }) : this.client.request(`/post/${id}/likes`, {
             method: 'DELETE',
         });
     }
 
     async getLikes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -105,14 +110,17 @@ export class PostsResource {
         });
     }
 
-    async undislike(id: string, userId: string): Promise<any> {
-        return this.client.request(`/post/${id}/dislikes?userId=${userId}`, {
+    async undislike(id: string, userId?: string): Promise<any> {
+        return userId ? this.client.request(`/post/${id}/dislikes?userId=${userId}`, {
+            method: 'DELETE',
+        }) : this.client.request(`/post/${id}/dislikes`, {
             method: 'DELETE',
         });
     }
 
     async getDislikes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -132,14 +140,17 @@ export class PostsResource {
         });
     }
 
-    async unupvote(id: string, userId: string): Promise<any> {
-        return this.client.request(`/post/${id}/upvotes?userId=${userId}`, {
+    async unupvote(id: string, userId?: string): Promise<any> {
+        return userId ? this.client.request(`/post/${id}/upvotes?userId=${userId}`, {
+            method: 'DELETE',
+        }) : this.client.request(`/post/${id}/upvotes`, {
             method: 'DELETE',
         });
     }
 
     async getUpvotes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -159,14 +170,17 @@ export class PostsResource {
         });
     }
 
-    async undownvote(id: string, userId: string): Promise<any> {
-        return this.client.request(`/post/${id}/downvotes?userId=${userId}`, {
+    async undownvote(id: string, userId?: string): Promise<any> {
+        return userId ? this.client.request(`/post/${id}/downvotes?userId=${userId}`, {
+            method: 'DELETE',
+        }) : this.client.request(`/post/${id}/downvotes`, {
             method: 'DELETE',
         });
     }
 
     async getDownvotes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {

package/src/resources/PrivateMessages.ts

@@ -13,6 +13,7 @@ export class PrivateMessagesResource {
         userId?: string;
         filter?: 'newest' | 'oldest';
         cursor?: string;
+        limit?: number;
     }): Promise<PrivateMessageListResponse> {
         const searchParams = new URLSearchParams();
         if (params) {

package/src/resources/Reports.ts

@@ -14,6 +14,7 @@ export class ReportsResource {
         read?: boolean;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<ReportListResponse> {
         const searchParams = new URLSearchParams();
         if (params) {

package/src/resources/Roles.ts

@@ -11,6 +11,7 @@ export class RolesResource {
     async list(params?: {
         filter?: 'newest' | 'oldest';
         cursor?: string;
+        limit?: number;
     }): Promise<RoleListResponse> {
         const searchParams = new URLSearchParams();
         if (params) {

package/src/resources/Search.ts

@@ -12,6 +12,7 @@ export class SearchResource {
         query: string;
         type: 'threads' | 'posts' | 'users' | 'tags';
         cursor?: string;
+        limit?: number;
     }): Promise<SearchResponse> {
         const searchParams = new URLSearchParams();
         Object.entries(params).forEach(([key, value]) => {

package/src/resources/Tags.ts

@@ -11,6 +11,7 @@ export class TagsResource {
     async list(params?: {
         query?: string;
         cursor?: string;
+        limit?: number;
     }): Promise<TagListResponse> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -68,6 +69,7 @@ export class TagsResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<import('../types').ThreadListResponse> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -82,21 +84,23 @@ export class TagsResource {
         });
     }
 
-    async subscribe(id: string, userId: string): Promise<any> {
+    async subscribe(id: string, userId?: string): Promise<any> {
         return this.client.request(`/tag/${id}/subscribers`, {
             method: 'POST',
             body: JSON.stringify({ userId }),
         });
     }
 
-    async unsubscribe(id: string, userId: string): Promise<any> {
-        return this.client.request(`/tag/${id}/subscribers?userId=${userId}`, {
+    async unsubscribe(id: string, userId?: string): Promise<any> {
+        return this.client.request(`/tag/${id}/subscribers`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
 
     async getSubscribers(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -110,9 +114,10 @@ export class TagsResource {
     }
 
     async listSubscribed(params: {
-        userId: string;
+        userId?: string;
         query?: string;
         cursor?: string;
+        limit?: number;
     }): Promise<TagListResponse> {
         const searchParams = new URLSearchParams();
         Object.entries(params).forEach(([key, value]) => {

package/src/resources/Threads.ts

@@ -15,6 +15,7 @@ export class ThreadsResource {
         type?: InteractionType;
         cursor?: string;
         userId?: string;
+        limit?: number;
     }): Promise<ThreadListResponse> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -50,7 +51,7 @@ export class ThreadsResource {
         });
     }
 
-    async delete(threadId: string, payload?: { userId: string }): Promise<import('../types').Thread & { deleted: boolean }> {
+    async delete(threadId: string, payload?: { userId?: string }): Promise<import('../types').Thread & { deleted: boolean }> {
         return this.client.request<import('../types').Thread & { deleted: boolean }>(`/thread/${threadId}`, {
             method: 'DELETE',
             body: payload ? JSON.stringify(payload) : undefined,
@@ -60,6 +61,7 @@ export class ThreadsResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -79,14 +81,16 @@ export class ThreadsResource {
         });
     }
 
-    async unlike(id: string, userId: string): Promise<any> {
-        return this.client.request(`/thread/${id}/likes?userId=${userId}`, {
+    async unlike(id: string, userId?: string): Promise<any> {
+        return this.client.request(`/thread/${id}/likes`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
 
     async getLikes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -106,14 +110,16 @@ export class ThreadsResource {
         });
     }
 
-    async undislike(id: string, userId: string): Promise<any> {
-        return this.client.request(`/thread/${id}/dislikes?userId=${userId}`, {
+    async undislike(id: string, userId?: string): Promise<any> {
+        return this.client.request(`/thread/${id}/dislikes`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
 
     async getDislikes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -126,21 +132,23 @@ export class ThreadsResource {
         return this.client.request(`/thread/${id}/dislikes?${searchParams.toString()}`, { method: 'GET' });
     }
 
-    async subscribe(id: string, userId: string, extendedData?: any): Promise<any> {
+    async subscribe(id: string, userId?: string, extendedData?: any): Promise<any> {
         return this.client.request(`/thread/${id}/subscribers`, {
             method: 'POST',
             body: JSON.stringify({ userId, extendedData }),
         });
     }
 
-    async unsubscribe(id: string, userId: string): Promise<any> {
-        return this.client.request(`/thread/${id}/subscribers?userId=${userId}`, {
+    async unsubscribe(id: string, userId?: string): Promise<any> {
+        return this.client.request(`/thread/${id}/subscribers`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
 
     async getSubscribers(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -160,14 +168,16 @@ export class ThreadsResource {
         });
     }
 
-    async unupvote(id: string, userId: string): Promise<any> {
-        return this.client.request(`/thread/${id}/upvotes?userId=${userId}`, {
+    async unupvote(id: string, userId?: string): Promise<any> {
+        return this.client.request(`/thread/${id}/upvotes`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
 
     async getUpvotes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -187,14 +197,16 @@ export class ThreadsResource {
         });
     }
 
-    async undownvote(id: string, userId: string): Promise<any> {
-        return this.client.request(`/thread/${id}/downvotes?userId=${userId}`, {
+    async undownvote(id: string, userId?: string): Promise<any> {
+        return this.client.request(`/thread/${id}/downvotes`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
 
     async getDownvotes(id: string, params?: {
         cursor?: string;
+        limit?: number;
     }): Promise<any> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -220,23 +232,24 @@ export class ThreadsResource {
         );
     }
 
-    async vote(id: string, optionId: string, userId: string): Promise<any> {
+    async vote(id: string, optionId: string, userId?: string): Promise<any> {
         return this.client.request(`/thread/${id}/poll/votes`, {
             method: 'POST',
             body: JSON.stringify({ optionId, userId }),
         });
     }
 
-    async voteUpdate(id: string, optionId: string, userId: string): Promise<any> {
+    async voteUpdate(id: string, optionId: string, userId?: string): Promise<any> {
         return this.client.request(`/thread/${id}/poll/votes`, {
             method: 'PUT',
             body: JSON.stringify({ optionId, userId }),
         });
     }
 
-    async unvote(id: string, userId: string): Promise<any> {
-        return this.client.request(`/thread/${id}/poll/votes?userId=${userId}`, {
+    async unvote(id: string, userId?: string): Promise<any> {
+        return this.client.request(`/thread/${id}/poll/votes`, {
             method: 'DELETE',
+            body: JSON.stringify({ userId }),
         });
     }
 }

package/src/resources/Users.ts

@@ -12,6 +12,7 @@ export class UsersResource {
         query?: string;
         filter?: 'newest' | 'oldest';
         cursor?: string;
+        limit?: number;
     }): Promise<UserListResponse> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -79,6 +80,7 @@ export class UsersResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<import('../types').ThreadListResponse> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -97,6 +99,7 @@ export class UsersResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<import('../types').PostListResponse> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -115,6 +118,7 @@ export class UsersResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<{ followers: User[]; nextUserCursor?: string; count: number }> {
         const searchParams = new URLSearchParams();
         if (params) {
@@ -146,6 +150,7 @@ export class UsersResource {
         query?: string;
         cursor?: string;
         filter?: 'newest' | 'oldest';
+        limit?: number;
     }): Promise<{ following: any[]; nextUserCursor?: string; count: number }> {
         const searchParams = new URLSearchParams();
         if (params) {

package/src/resources/Webhooks.ts

@@ -83,9 +83,10 @@ export class WebhooksResource {
      * @param params - Query parameters
      * @returns Promise resolving to delivery history
      */
-    async getDeliveries(id: string, params?: { cursor?: string }): Promise<{ deliveries: any[]; total: number; nextCursor?: string }> {
+    async getDeliveries(id: string, params?: { cursor?: string; limit?: number }): Promise<{ deliveries: any[]; total: number; nextCursor?: string }> {
         const searchParams = new URLSearchParams();
         if (params?.cursor) searchParams.append('cursor', params.cursor);
+        if (params?.limit) searchParams.append('limit', params.limit.toString());
 
         return this.client.request<{ deliveries: any[]; total: number; nextCursor?: string }>(`/webhooks/${id}/deliveries?${searchParams.toString()}`, {
             method: 'GET',