@meshagent/meshagent 0.39.0 → 0.39.1

package/CHANGELOG.md

@@ -1,3 +1,8 @@
+## [0.39.1]
+- Added `*Page` interfaces and new `Meshagent` TypeScript methods for paged listing (e.g., `getUsersInProjectPage`, `listMailboxesPage`, `listFeedsPage`, `listRoutesPage`, `listUniqueUsersWithGrantsPage`, `listOAuthClientsPage`, etc.) returning `{ items, total }`-style page payloads.
+- Updated existing list methods to accept `count`/`offset`/`filter` options and to default to paged fetching (default page-size behavior updated).
+- Improved payload parsing/validation for mailboxes (including mapping `room_id` into the Dart/JS-facing `roomId` shape).
+
 ## [0.39.0]
 - Expanded TypeScript datasets client support for dataset index management (index configuration/remapping and index metadata).
 - Added TypeScript datasets SQL cancellation API with typed cancel status/results.

package/dist/browser/meshagent-client.d.ts

@@ -41,6 +41,14 @@ export interface ProjectUserGrantCount {
     lastName?: string | null;
     email: string;
 }
+export interface ProjectMembersPage {
+    users: Record<string, unknown>[];
+    total: number;
+}
+export interface ProjectUserGrantCountsPage {
+    users: ProjectUserGrantCount[];
+    total: number;
+}
 export interface EnvironmentVariable {
     name: string;
     value: string;
@@ -202,6 +210,10 @@ export interface Mailbox {
     roomId?: string;
     queue: string;
 }
+export interface MailboxesPage {
+    mailboxes: Mailbox[];
+    total: number;
+}
 export type FeedVisibility = "public" | "project" | "private";
 export interface Feed {
     id: string;
@@ -214,6 +226,10 @@ export interface Feed {
     annotations: Record<string, string>;
     messageSchema?: Record<string, unknown> | boolean | null;
 }
+export interface FeedsPage {
+    feeds: Feed[];
+    total: number;
+}
 export interface FeedSubscription {
     id: string;
     feedId: string;
@@ -268,6 +284,10 @@ export interface OAuthClient {
     projectId: string;
     metadata: Record<string, string>;
 }
+export interface OAuthClientsPage {
+    clients: OAuthClient[];
+    total: number;
+}
 export interface BaseSecret {
     id?: string;
     name: string;
@@ -365,6 +385,11 @@ export declare class Meshagent {
     }): Promise<Record<string, unknown>>;
     removeUserFromProject(projectId: string, userId: string): Promise<Record<string, unknown>>;
     updateProjectSettings(projectId: string, settings: Record<string, unknown>): Promise<Record<string, unknown>>;
+    getUsersInProjectPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<ProjectMembersPage>;
     getUsersInProject(projectId: string): Promise<Record<string, unknown>>;
     getUserProfile(userId: string): Promise<Record<string, unknown>>;
     updateUserProfile(userId: string, firstName: string, lastName: string): Promise<Record<string, unknown>>;
@@ -446,7 +471,17 @@ export declare class Meshagent {
         queue: string;
         isPublic: boolean;
     }): Promise<void>;
-    listMailboxes(projectId: string): Promise<Mailbox[]>;
+    private parseMailbox;
+    listMailboxesPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<MailboxesPage>;
+    listMailboxes(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<Mailbox[]>;
     deleteMailbox(projectId: string, address: string): Promise<void>;
     createFeed(params: {
         projectId: string;
@@ -467,8 +502,26 @@ export declare class Meshagent {
         messageSchema?: Record<string, unknown> | boolean | null;
     }): Promise<void>;
     getFeed(projectId: string, feedId: string): Promise<Feed>;
-    listFeeds(projectId: string): Promise<Feed[]>;
-    listRoomFeeds(projectId: string, roomName: string): Promise<Feed[]>;
+    listFeedsPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<FeedsPage>;
+    listFeeds(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<Feed[]>;
+    listRoomFeedsPage(projectId: string, roomName: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<FeedsPage>;
+    listRoomFeeds(projectId: string, roomName: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<Feed[]>;
     deleteFeed(projectId: string, feedId: string): Promise<void>;
     publishFeedMessage(params: {
         projectId: string;
@@ -713,9 +766,15 @@ export declare class Meshagent {
         limit?: number;
         offset?: number;
     }): Promise<ProjectRoomGrantCount[]>;
+    listUniqueUsersWithGrantsPage(projectId: string, options?: {
+        limit?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<ProjectUserGrantCountsPage>;
     listUniqueUsersWithGrants(projectId: string, options?: {
         limit?: number;
         offset?: number;
+        filter?: string;
     }): Promise<ProjectUserGrantCount[]>;
     createOAuthClient(projectId: string, params: {
         grantTypes: string[];
@@ -731,7 +790,16 @@ export declare class Meshagent {
         scope?: string;
         metadata?: Record<string, any>;
     }): Promise<Record<string, unknown>>;
-    listOAuthClients(projectId: string): Promise<OAuthClient[]>;
+    listOAuthClientsPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<OAuthClientsPage>;
+    listOAuthClients(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<OAuthClient[]>;
     getOAuthClient(projectId: string, clientId: string): Promise<OAuthClient>;
     deleteOAuthClient(projectId: string, clientId: string): Promise<void>;
 }

package/dist/browser/meshagent-client.js

@@ -774,10 +774,18 @@ class Meshagent {
             action: "update project settings",
         });
     }
-    async getUsersInProject(projectId) {
-        return await this.request(`/accounts/projects/${projectId}/users`, {
+    async getUsersInProjectPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
+        const data = await this.request(`/accounts/projects/${projectId}/users`, {
+            query: { count, offset, filter },
             action: "fetch project users",
         });
+        const users = Array.isArray(data?.users) ? data.users : [];
+        return { users, total: typeof data?.total === "number" ? data.total : users.length };
+    }
+    async getUsersInProject(projectId) {
+        const page = await this.getUsersInProjectPage(projectId);
+        return { users: page.users, total: page.total };
     }
     async getUserProfile(userId) {
         return await this.request(`/accounts/profiles/${userId}`, {
@@ -1002,24 +1010,32 @@ class Meshagent {
             responseType: "void",
         });
     }
-    async listMailboxes(projectId) {
+    parseMailbox(item) {
+        if (!item || typeof item !== "object") {
+            throw new requirement_1.RoomException("Invalid mailbox payload");
+        }
+        const { address, room, room_id, queue } = item;
+        if (typeof address !== "string" || typeof room !== "string" || typeof queue !== "string") {
+            throw new requirement_1.RoomException("Invalid mailbox payload: missing fields");
+        }
+        if (room_id !== undefined && typeof room_id !== "string") {
+            throw new requirement_1.RoomException("Invalid mailbox payload: invalid room_id");
+        }
+        return { address, room, roomId: room_id, queue };
+    }
+    async listMailboxesPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/mailboxes`, {
+            query: { count, offset, filter },
             action: "list mailboxes",
         });
         const mailboxes = Array.isArray(data?.mailboxes) ? data.mailboxes : [];
-        return mailboxes.map((item) => {
-            if (!item || typeof item !== "object") {
-                throw new requirement_1.RoomException("Invalid mailbox payload");
-            }
-            const { address, room, room_id, queue } = item;
-            if (typeof address !== "string" || typeof room !== "string" || typeof queue !== "string") {
-                throw new requirement_1.RoomException("Invalid mailbox payload: missing fields");
-            }
-            if (room_id !== undefined && typeof room_id !== "string") {
-                throw new requirement_1.RoomException("Invalid mailbox payload: invalid room_id");
-            }
-            return { address, room, roomId: room_id, queue };
-        });
+        const parsed = mailboxes.map((item) => this.parseMailbox(item));
+        return { mailboxes: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listMailboxes(projectId, options = {}) {
+        const page = await this.listMailboxesPage(projectId, options);
+        return page.mailboxes;
     }
     async deleteMailbox(projectId, address) {
         await this.request(`/accounts/projects/${projectId}/mailboxes/${address}`, {
@@ -1065,19 +1081,33 @@ class Meshagent {
         });
         return this.parseFeed(data.feed);
     }
-    async listFeeds(projectId) {
+    async listFeedsPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/feeds`, {
+            query: { count, offset, filter },
             action: "list feeds",
         });
         const feeds = Array.isArray(data?.feeds) ? data.feeds : [];
-        return feeds.map((item) => this.parseFeed(item));
+        const parsed = feeds.map((item) => this.parseFeed(item));
+        return { feeds: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
     }
-    async listRoomFeeds(projectId, roomName) {
+    async listFeeds(projectId, options = {}) {
+        const page = await this.listFeedsPage(projectId, options);
+        return page.feeds;
+    }
+    async listRoomFeedsPage(projectId, roomName, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/rooms/${roomName}/feeds`, {
+            query: { count, offset, filter },
             action: "list room feeds",
         });
         const feeds = Array.isArray(data?.feeds) ? data.feeds : [];
-        return feeds.map((item) => this.parseFeed(item));
+        const parsed = feeds.map((item) => this.parseFeed(item));
+        return { feeds: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listRoomFeeds(projectId, roomName, options = {}) {
+        const page = await this.listRoomFeedsPage(projectId, roomName, options);
+        return page.feeds;
     }
     async deleteFeed(projectId, feedId) {
         await this.request(`/accounts/projects/${projectId}/feeds/${feedId}`, {
@@ -1729,14 +1759,19 @@ class Meshagent {
         const rooms = Array.isArray(data?.rooms) ? data.rooms : [];
         return rooms.map((item) => this.parseProjectRoomGrantCount(item));
     }
-    async listUniqueUsersWithGrants(projectId, options = {}) {
-        const { limit = 50, offset = 0 } = options;
+    async listUniqueUsersWithGrantsPage(projectId, options = {}) {
+        const { limit = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/room-grants/by-user`, {
-            query: { limit, offset },
+            query: { limit, offset, filter },
             action: "list unique users with grants",
         });
         const users = Array.isArray(data?.users) ? data.users : [];
-        return users.map((item) => this.parseProjectUserGrantCount(item));
+        const parsed = users.map((item) => this.parseProjectUserGrantCount(item));
+        return { users: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listUniqueUsersWithGrants(projectId, options = {}) {
+        const page = await this.listUniqueUsersWithGrantsPage(projectId, options);
+        return page.users;
     }
     async createOAuthClient(projectId, params) {
         const { grantTypes, responseTypes, redirectUris, scope, metadata = {} } = params;
@@ -1765,12 +1800,19 @@ class Meshagent {
             action: "update oauth client",
         });
     }
-    async listOAuthClients(projectId) {
+    async listOAuthClientsPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/oauth/clients`, {
+            query: { count, offset, filter },
             action: "list oauth clients",
         });
         const clients = Array.isArray(data?.clients) ? data.clients : [];
-        return clients.map((item) => this.parseOAuthClient(item));
+        const parsed = clients.map((item) => this.parseOAuthClient(item));
+        return { clients: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listOAuthClients(projectId, options = {}) {
+        const page = await this.listOAuthClientsPage(projectId, options);
+        return page.clients;
     }
     async getOAuthClient(projectId, clientId) {
         const data = await this.request(`/accounts/projects/${projectId}/oauth/clients/${clientId}`, {

package/dist/esm/meshagent-client.d.ts

@@ -41,6 +41,14 @@ export interface ProjectUserGrantCount {
     lastName?: string | null;
     email: string;
 }
+export interface ProjectMembersPage {
+    users: Record<string, unknown>[];
+    total: number;
+}
+export interface ProjectUserGrantCountsPage {
+    users: ProjectUserGrantCount[];
+    total: number;
+}
 export interface EnvironmentVariable {
     name: string;
     value: string;
@@ -202,6 +210,10 @@ export interface Mailbox {
     roomId?: string;
     queue: string;
 }
+export interface MailboxesPage {
+    mailboxes: Mailbox[];
+    total: number;
+}
 export type FeedVisibility = "public" | "project" | "private";
 export interface Feed {
     id: string;
@@ -214,6 +226,10 @@ export interface Feed {
     annotations: Record<string, string>;
     messageSchema?: Record<string, unknown> | boolean | null;
 }
+export interface FeedsPage {
+    feeds: Feed[];
+    total: number;
+}
 export interface FeedSubscription {
     id: string;
     feedId: string;
@@ -268,6 +284,10 @@ export interface OAuthClient {
     projectId: string;
     metadata: Record<string, string>;
 }
+export interface OAuthClientsPage {
+    clients: OAuthClient[];
+    total: number;
+}
 export interface BaseSecret {
     id?: string;
     name: string;
@@ -365,6 +385,11 @@ export declare class Meshagent {
     }): Promise<Record<string, unknown>>;
     removeUserFromProject(projectId: string, userId: string): Promise<Record<string, unknown>>;
     updateProjectSettings(projectId: string, settings: Record<string, unknown>): Promise<Record<string, unknown>>;
+    getUsersInProjectPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<ProjectMembersPage>;
     getUsersInProject(projectId: string): Promise<Record<string, unknown>>;
     getUserProfile(userId: string): Promise<Record<string, unknown>>;
     updateUserProfile(userId: string, firstName: string, lastName: string): Promise<Record<string, unknown>>;
@@ -446,7 +471,17 @@ export declare class Meshagent {
         queue: string;
         isPublic: boolean;
     }): Promise<void>;
-    listMailboxes(projectId: string): Promise<Mailbox[]>;
+    private parseMailbox;
+    listMailboxesPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<MailboxesPage>;
+    listMailboxes(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<Mailbox[]>;
     deleteMailbox(projectId: string, address: string): Promise<void>;
     createFeed(params: {
         projectId: string;
@@ -467,8 +502,26 @@ export declare class Meshagent {
         messageSchema?: Record<string, unknown> | boolean | null;
     }): Promise<void>;
     getFeed(projectId: string, feedId: string): Promise<Feed>;
-    listFeeds(projectId: string): Promise<Feed[]>;
-    listRoomFeeds(projectId: string, roomName: string): Promise<Feed[]>;
+    listFeedsPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<FeedsPage>;
+    listFeeds(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<Feed[]>;
+    listRoomFeedsPage(projectId: string, roomName: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<FeedsPage>;
+    listRoomFeeds(projectId: string, roomName: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<Feed[]>;
     deleteFeed(projectId: string, feedId: string): Promise<void>;
     publishFeedMessage(params: {
         projectId: string;
@@ -713,9 +766,15 @@ export declare class Meshagent {
         limit?: number;
         offset?: number;
     }): Promise<ProjectRoomGrantCount[]>;
+    listUniqueUsersWithGrantsPage(projectId: string, options?: {
+        limit?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<ProjectUserGrantCountsPage>;
     listUniqueUsersWithGrants(projectId: string, options?: {
         limit?: number;
         offset?: number;
+        filter?: string;
     }): Promise<ProjectUserGrantCount[]>;
     createOAuthClient(projectId: string, params: {
         grantTypes: string[];
@@ -731,7 +790,16 @@ export declare class Meshagent {
         scope?: string;
         metadata?: Record<string, any>;
     }): Promise<Record<string, unknown>>;
-    listOAuthClients(projectId: string): Promise<OAuthClient[]>;
+    listOAuthClientsPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<OAuthClientsPage>;
+    listOAuthClients(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<OAuthClient[]>;
     getOAuthClient(projectId: string, clientId: string): Promise<OAuthClient>;
     deleteOAuthClient(projectId: string, clientId: string): Promise<void>;
 }

package/dist/esm/meshagent-client.js

@@ -771,10 +771,18 @@ export class Meshagent {
             action: "update project settings",
         });
     }
-    async getUsersInProject(projectId) {
-        return await this.request(`/accounts/projects/${projectId}/users`, {
+    async getUsersInProjectPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
+        const data = await this.request(`/accounts/projects/${projectId}/users`, {
+            query: { count, offset, filter },
             action: "fetch project users",
         });
+        const users = Array.isArray(data?.users) ? data.users : [];
+        return { users, total: typeof data?.total === "number" ? data.total : users.length };
+    }
+    async getUsersInProject(projectId) {
+        const page = await this.getUsersInProjectPage(projectId);
+        return { users: page.users, total: page.total };
     }
     async getUserProfile(userId) {
         return await this.request(`/accounts/profiles/${userId}`, {
@@ -999,24 +1007,32 @@ export class Meshagent {
             responseType: "void",
         });
     }
-    async listMailboxes(projectId) {
+    parseMailbox(item) {
+        if (!item || typeof item !== "object") {
+            throw new RoomException("Invalid mailbox payload");
+        }
+        const { address, room, room_id, queue } = item;
+        if (typeof address !== "string" || typeof room !== "string" || typeof queue !== "string") {
+            throw new RoomException("Invalid mailbox payload: missing fields");
+        }
+        if (room_id !== undefined && typeof room_id !== "string") {
+            throw new RoomException("Invalid mailbox payload: invalid room_id");
+        }
+        return { address, room, roomId: room_id, queue };
+    }
+    async listMailboxesPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/mailboxes`, {
+            query: { count, offset, filter },
             action: "list mailboxes",
         });
         const mailboxes = Array.isArray(data?.mailboxes) ? data.mailboxes : [];
-        return mailboxes.map((item) => {
-            if (!item || typeof item !== "object") {
-                throw new RoomException("Invalid mailbox payload");
-            }
-            const { address, room, room_id, queue } = item;
-            if (typeof address !== "string" || typeof room !== "string" || typeof queue !== "string") {
-                throw new RoomException("Invalid mailbox payload: missing fields");
-            }
-            if (room_id !== undefined && typeof room_id !== "string") {
-                throw new RoomException("Invalid mailbox payload: invalid room_id");
-            }
-            return { address, room, roomId: room_id, queue };
-        });
+        const parsed = mailboxes.map((item) => this.parseMailbox(item));
+        return { mailboxes: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listMailboxes(projectId, options = {}) {
+        const page = await this.listMailboxesPage(projectId, options);
+        return page.mailboxes;
     }
     async deleteMailbox(projectId, address) {
         await this.request(`/accounts/projects/${projectId}/mailboxes/${address}`, {
@@ -1062,19 +1078,33 @@ export class Meshagent {
         });
         return this.parseFeed(data.feed);
     }
-    async listFeeds(projectId) {
+    async listFeedsPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/feeds`, {
+            query: { count, offset, filter },
             action: "list feeds",
         });
         const feeds = Array.isArray(data?.feeds) ? data.feeds : [];
-        return feeds.map((item) => this.parseFeed(item));
+        const parsed = feeds.map((item) => this.parseFeed(item));
+        return { feeds: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
     }
-    async listRoomFeeds(projectId, roomName) {
+    async listFeeds(projectId, options = {}) {
+        const page = await this.listFeedsPage(projectId, options);
+        return page.feeds;
+    }
+    async listRoomFeedsPage(projectId, roomName, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/rooms/${roomName}/feeds`, {
+            query: { count, offset, filter },
             action: "list room feeds",
         });
         const feeds = Array.isArray(data?.feeds) ? data.feeds : [];
-        return feeds.map((item) => this.parseFeed(item));
+        const parsed = feeds.map((item) => this.parseFeed(item));
+        return { feeds: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listRoomFeeds(projectId, roomName, options = {}) {
+        const page = await this.listRoomFeedsPage(projectId, roomName, options);
+        return page.feeds;
     }
     async deleteFeed(projectId, feedId) {
         await this.request(`/accounts/projects/${projectId}/feeds/${feedId}`, {
@@ -1726,14 +1756,19 @@ export class Meshagent {
         const rooms = Array.isArray(data?.rooms) ? data.rooms : [];
         return rooms.map((item) => this.parseProjectRoomGrantCount(item));
     }
-    async listUniqueUsersWithGrants(projectId, options = {}) {
-        const { limit = 50, offset = 0 } = options;
+    async listUniqueUsersWithGrantsPage(projectId, options = {}) {
+        const { limit = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/room-grants/by-user`, {
-            query: { limit, offset },
+            query: { limit, offset, filter },
             action: "list unique users with grants",
         });
         const users = Array.isArray(data?.users) ? data.users : [];
-        return users.map((item) => this.parseProjectUserGrantCount(item));
+        const parsed = users.map((item) => this.parseProjectUserGrantCount(item));
+        return { users: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listUniqueUsersWithGrants(projectId, options = {}) {
+        const page = await this.listUniqueUsersWithGrantsPage(projectId, options);
+        return page.users;
     }
     async createOAuthClient(projectId, params) {
         const { grantTypes, responseTypes, redirectUris, scope, metadata = {} } = params;
@@ -1762,12 +1797,19 @@ export class Meshagent {
             action: "update oauth client",
         });
     }
-    async listOAuthClients(projectId) {
+    async listOAuthClientsPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/oauth/clients`, {
+            query: { count, offset, filter },
             action: "list oauth clients",
         });
         const clients = Array.isArray(data?.clients) ? data.clients : [];
-        return clients.map((item) => this.parseOAuthClient(item));
+        const parsed = clients.map((item) => this.parseOAuthClient(item));
+        return { clients: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listOAuthClients(projectId, options = {}) {
+        const page = await this.listOAuthClientsPage(projectId, options);
+        return page.clients;
     }
     async getOAuthClient(projectId, clientId) {
         const data = await this.request(`/accounts/projects/${projectId}/oauth/clients/${clientId}`, {

package/dist/node/meshagent-client.d.ts

@@ -41,6 +41,14 @@ export interface ProjectUserGrantCount {
     lastName?: string | null;
     email: string;
 }
+export interface ProjectMembersPage {
+    users: Record<string, unknown>[];
+    total: number;
+}
+export interface ProjectUserGrantCountsPage {
+    users: ProjectUserGrantCount[];
+    total: number;
+}
 export interface EnvironmentVariable {
     name: string;
     value: string;
@@ -202,6 +210,10 @@ export interface Mailbox {
     roomId?: string;
     queue: string;
 }
+export interface MailboxesPage {
+    mailboxes: Mailbox[];
+    total: number;
+}
 export type FeedVisibility = "public" | "project" | "private";
 export interface Feed {
     id: string;
@@ -214,6 +226,10 @@ export interface Feed {
     annotations: Record<string, string>;
     messageSchema?: Record<string, unknown> | boolean | null;
 }
+export interface FeedsPage {
+    feeds: Feed[];
+    total: number;
+}
 export interface FeedSubscription {
     id: string;
     feedId: string;
@@ -268,6 +284,10 @@ export interface OAuthClient {
     projectId: string;
     metadata: Record<string, string>;
 }
+export interface OAuthClientsPage {
+    clients: OAuthClient[];
+    total: number;
+}
 export interface BaseSecret {
     id?: string;
     name: string;
@@ -365,6 +385,11 @@ export declare class Meshagent {
     }): Promise<Record<string, unknown>>;
     removeUserFromProject(projectId: string, userId: string): Promise<Record<string, unknown>>;
     updateProjectSettings(projectId: string, settings: Record<string, unknown>): Promise<Record<string, unknown>>;
+    getUsersInProjectPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<ProjectMembersPage>;
     getUsersInProject(projectId: string): Promise<Record<string, unknown>>;
     getUserProfile(userId: string): Promise<Record<string, unknown>>;
     updateUserProfile(userId: string, firstName: string, lastName: string): Promise<Record<string, unknown>>;
@@ -446,7 +471,17 @@ export declare class Meshagent {
         queue: string;
         isPublic: boolean;
     }): Promise<void>;
-    listMailboxes(projectId: string): Promise<Mailbox[]>;
+    private parseMailbox;
+    listMailboxesPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<MailboxesPage>;
+    listMailboxes(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<Mailbox[]>;
     deleteMailbox(projectId: string, address: string): Promise<void>;
     createFeed(params: {
         projectId: string;
@@ -467,8 +502,26 @@ export declare class Meshagent {
         messageSchema?: Record<string, unknown> | boolean | null;
     }): Promise<void>;
     getFeed(projectId: string, feedId: string): Promise<Feed>;
-    listFeeds(projectId: string): Promise<Feed[]>;
-    listRoomFeeds(projectId: string, roomName: string): Promise<Feed[]>;
+    listFeedsPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<FeedsPage>;
+    listFeeds(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<Feed[]>;
+    listRoomFeedsPage(projectId: string, roomName: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<FeedsPage>;
+    listRoomFeeds(projectId: string, roomName: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<Feed[]>;
     deleteFeed(projectId: string, feedId: string): Promise<void>;
     publishFeedMessage(params: {
         projectId: string;
@@ -713,9 +766,15 @@ export declare class Meshagent {
         limit?: number;
         offset?: number;
     }): Promise<ProjectRoomGrantCount[]>;
+    listUniqueUsersWithGrantsPage(projectId: string, options?: {
+        limit?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<ProjectUserGrantCountsPage>;
     listUniqueUsersWithGrants(projectId: string, options?: {
         limit?: number;
         offset?: number;
+        filter?: string;
     }): Promise<ProjectUserGrantCount[]>;
     createOAuthClient(projectId: string, params: {
         grantTypes: string[];
@@ -731,7 +790,16 @@ export declare class Meshagent {
         scope?: string;
         metadata?: Record<string, any>;
     }): Promise<Record<string, unknown>>;
-    listOAuthClients(projectId: string): Promise<OAuthClient[]>;
+    listOAuthClientsPage(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<OAuthClientsPage>;
+    listOAuthClients(projectId: string, options?: {
+        count?: number;
+        offset?: number;
+        filter?: string;
+    }): Promise<OAuthClient[]>;
     getOAuthClient(projectId: string, clientId: string): Promise<OAuthClient>;
     deleteOAuthClient(projectId: string, clientId: string): Promise<void>;
 }

package/dist/node/meshagent-client.js

@@ -774,10 +774,18 @@ class Meshagent {
             action: "update project settings",
         });
     }
-    async getUsersInProject(projectId) {
-        return await this.request(`/accounts/projects/${projectId}/users`, {
+    async getUsersInProjectPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
+        const data = await this.request(`/accounts/projects/${projectId}/users`, {
+            query: { count, offset, filter },
             action: "fetch project users",
         });
+        const users = Array.isArray(data?.users) ? data.users : [];
+        return { users, total: typeof data?.total === "number" ? data.total : users.length };
+    }
+    async getUsersInProject(projectId) {
+        const page = await this.getUsersInProjectPage(projectId);
+        return { users: page.users, total: page.total };
     }
     async getUserProfile(userId) {
         return await this.request(`/accounts/profiles/${userId}`, {
@@ -1002,24 +1010,32 @@ class Meshagent {
             responseType: "void",
         });
     }
-    async listMailboxes(projectId) {
+    parseMailbox(item) {
+        if (!item || typeof item !== "object") {
+            throw new requirement_1.RoomException("Invalid mailbox payload");
+        }
+        const { address, room, room_id, queue } = item;
+        if (typeof address !== "string" || typeof room !== "string" || typeof queue !== "string") {
+            throw new requirement_1.RoomException("Invalid mailbox payload: missing fields");
+        }
+        if (room_id !== undefined && typeof room_id !== "string") {
+            throw new requirement_1.RoomException("Invalid mailbox payload: invalid room_id");
+        }
+        return { address, room, roomId: room_id, queue };
+    }
+    async listMailboxesPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/mailboxes`, {
+            query: { count, offset, filter },
             action: "list mailboxes",
         });
         const mailboxes = Array.isArray(data?.mailboxes) ? data.mailboxes : [];
-        return mailboxes.map((item) => {
-            if (!item || typeof item !== "object") {
-                throw new requirement_1.RoomException("Invalid mailbox payload");
-            }
-            const { address, room, room_id, queue } = item;
-            if (typeof address !== "string" || typeof room !== "string" || typeof queue !== "string") {
-                throw new requirement_1.RoomException("Invalid mailbox payload: missing fields");
-            }
-            if (room_id !== undefined && typeof room_id !== "string") {
-                throw new requirement_1.RoomException("Invalid mailbox payload: invalid room_id");
-            }
-            return { address, room, roomId: room_id, queue };
-        });
+        const parsed = mailboxes.map((item) => this.parseMailbox(item));
+        return { mailboxes: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listMailboxes(projectId, options = {}) {
+        const page = await this.listMailboxesPage(projectId, options);
+        return page.mailboxes;
     }
     async deleteMailbox(projectId, address) {
         await this.request(`/accounts/projects/${projectId}/mailboxes/${address}`, {
@@ -1065,19 +1081,33 @@ class Meshagent {
         });
         return this.parseFeed(data.feed);
     }
-    async listFeeds(projectId) {
+    async listFeedsPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/feeds`, {
+            query: { count, offset, filter },
             action: "list feeds",
         });
         const feeds = Array.isArray(data?.feeds) ? data.feeds : [];
-        return feeds.map((item) => this.parseFeed(item));
+        const parsed = feeds.map((item) => this.parseFeed(item));
+        return { feeds: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
     }
-    async listRoomFeeds(projectId, roomName) {
+    async listFeeds(projectId, options = {}) {
+        const page = await this.listFeedsPage(projectId, options);
+        return page.feeds;
+    }
+    async listRoomFeedsPage(projectId, roomName, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/rooms/${roomName}/feeds`, {
+            query: { count, offset, filter },
             action: "list room feeds",
         });
         const feeds = Array.isArray(data?.feeds) ? data.feeds : [];
-        return feeds.map((item) => this.parseFeed(item));
+        const parsed = feeds.map((item) => this.parseFeed(item));
+        return { feeds: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listRoomFeeds(projectId, roomName, options = {}) {
+        const page = await this.listRoomFeedsPage(projectId, roomName, options);
+        return page.feeds;
     }
     async deleteFeed(projectId, feedId) {
         await this.request(`/accounts/projects/${projectId}/feeds/${feedId}`, {
@@ -1729,14 +1759,19 @@ class Meshagent {
         const rooms = Array.isArray(data?.rooms) ? data.rooms : [];
         return rooms.map((item) => this.parseProjectRoomGrantCount(item));
     }
-    async listUniqueUsersWithGrants(projectId, options = {}) {
-        const { limit = 50, offset = 0 } = options;
+    async listUniqueUsersWithGrantsPage(projectId, options = {}) {
+        const { limit = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/room-grants/by-user`, {
-            query: { limit, offset },
+            query: { limit, offset, filter },
             action: "list unique users with grants",
         });
         const users = Array.isArray(data?.users) ? data.users : [];
-        return users.map((item) => this.parseProjectUserGrantCount(item));
+        const parsed = users.map((item) => this.parseProjectUserGrantCount(item));
+        return { users: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listUniqueUsersWithGrants(projectId, options = {}) {
+        const page = await this.listUniqueUsersWithGrantsPage(projectId, options);
+        return page.users;
     }
     async createOAuthClient(projectId, params) {
         const { grantTypes, responseTypes, redirectUris, scope, metadata = {} } = params;
@@ -1765,12 +1800,19 @@ class Meshagent {
             action: "update oauth client",
         });
     }
-    async listOAuthClients(projectId) {
+    async listOAuthClientsPage(projectId, options = {}) {
+        const { count = 100, offset = 0, filter } = options;
         const data = await this.request(`/accounts/projects/${projectId}/oauth/clients`, {
+            query: { count, offset, filter },
             action: "list oauth clients",
         });
         const clients = Array.isArray(data?.clients) ? data.clients : [];
-        return clients.map((item) => this.parseOAuthClient(item));
+        const parsed = clients.map((item) => this.parseOAuthClient(item));
+        return { clients: parsed, total: typeof data?.total === "number" ? data.total : parsed.length };
+    }
+    async listOAuthClients(projectId, options = {}) {
+        const page = await this.listOAuthClientsPage(projectId, options);
+        return page.clients;
     }
     async getOAuthClient(projectId, clientId) {
         const data = await this.request(`/accounts/projects/${projectId}/oauth/clients/${clientId}`, {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@meshagent/meshagent",
-    "version": "0.39.0",
+    "version": "0.39.1",
     "description": "Meshagent Client",
     "homepage": "https://github.com/meshagent/meshagent-ts",
     "scripts": {