@meshagent/meshagent 0.53.1 → 0.53.2

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## [0.53.2]
+- Added project profile views, inheritance updates, typed profile models, and sysadmin global user search and profile administration.
+- Project updates now use project-local overrides and require `user_profile_editor`; global profile access is self-only and global annotations require sysadmin APIs.
+
 ## [0.53.1]
 - Stability
 
@@ -6,8 +10,10 @@
 - Added the `user_profile_editor` project role and support for partial profile updates with metadata, annotations, and project ID options.
 
 ## [Unreleased]
+- Added project-scoped profile reads and writes, `project`/`user`/`merged` views, and typed inheritance fields. Project user listings default to merged profiles.
+- Added sysadmin global user search, profile reads, and profile updates.
 - Added user profile metadata and string annotations to project-member models, plus `metadata`, `annotations`, and `projectId` options on `updateUserProfile`. Omitted fields are preserved; supplied maps replace their previous contents.
-- Added `user_profile_editor` to project role types and parsing. Project owners and admins inherit profile editing; ordinary users can edit their own names and metadata.
+- Added `user_profile_editor` to project role types and parsing. Project owners and admins inherit project profile editing; ordinary users can edit their own global names and metadata.
 
 ## [0.52.4]
 - Stability

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

@@ -126,6 +126,20 @@ export interface ResourcePolicyPage {
     accessGrants: ProjectRoomGrant[];
     continuationToken?: string | null;
 }
+export type UserProfileView = "project" | "user" | "merged";
+export type UserProfileField = "first_name" | "last_name" | "metadata" | "annotations";
+export interface UserProfile {
+    id: string;
+    email: string;
+    first_name: string | null;
+    last_name: string | null;
+    metadata: Record<string, unknown>;
+    annotations: Record<string, string>;
+}
+export interface UserProfilesPage {
+    users: UserProfile[];
+    continuation_token: string | null;
+}
 export interface ProjectMember {
     id: string;
     email: string;
@@ -659,14 +673,28 @@ export declare class Meshagent {
         continuationToken?: string;
         filter?: string;
         email?: string;
+        view?: UserProfileView;
     }): Promise<ProjectMembersPage>;
-    getUsersInProject(projectId: string): Promise<ProjectMember[]>;
-    getUserProfile(userId: string): Promise<Record<string, unknown>>;
-    updateUserProfile(userId: string, firstName?: string, lastName?: string, options?: {
+    getUsersInProject(projectId: string, options?: {
+        view?: UserProfileView;
+    }): Promise<ProjectMember[]>;
+    getUserProfile(userId: string, options?: {
+        projectId?: string;
+        view?: UserProfileView;
+    }): Promise<Record<string, unknown>>;
+    updateUserProfile(userId: string, firstName?: string | null, lastName?: string | null, options?: {
         metadata?: Record<string, unknown>;
         annotations?: Record<string, string>;
         projectId?: string;
+        inherit?: UserProfileField[];
     }): Promise<Record<string, unknown>>;
+    searchSysadminUsers(options?: {
+        filter?: string;
+        pageSize?: number;
+        continuationToken?: string;
+    }): Promise<UserProfilesPage>;
+    getSysadminUserProfile(userId: string): Promise<UserProfile>;
+    updateSysadminUserProfile(userId: string, fields: Partial<Pick<UserProfile, UserProfileField>>): Promise<Record<string, unknown>>;
     listProjects(): Promise<Record<string, unknown>>;
     getProject(projectId: string): Promise<Record<string, unknown>>;
     getProjectByKey(projectKey: string): Promise<Record<string, unknown>>;

package/dist/browser/meshagent-client.js

@@ -1001,36 +1001,69 @@ class Meshagent {
         });
     }
     async getUsersInProjectPage(projectId, options = {}) {
-        const { pageSize = 100, continuationToken, filter, email } = options;
+        const { pageSize = 100, continuationToken, filter, email, view = "merged" } = options;
         const data = await this.request(`/accounts/projects/${projectId}/users`, {
-            query: { page_size: pageSize, continuation_token: continuationToken, filter, email },
+            query: { page_size: pageSize, continuation_token: continuationToken, filter, email, view },
             action: "fetch project users",
         });
         const users = Array.isArray(data?.users) ? data.users : [];
         return { users: users.map((user) => this.parseProjectMember(user)), continuationToken: data?.continuation_token ?? null };
     }
-    async getUsersInProject(projectId) {
-        const page = await this.getUsersInProjectPage(projectId);
+    async getUsersInProject(projectId, options = {}) {
+        const page = await this.getUsersInProjectPage(projectId, options);
         return page.users;
     }
-    async getUserProfile(userId) {
-        return await this.request(`/accounts/profiles/${userId}`, {
+    async getUserProfile(userId, options = {}) {
+        if (options.projectId === undefined && options.view === "project") {
+            throw new Error("projectId is required for the project view");
+        }
+        const userPath = encodeURIComponent(userId);
+        const path = options.projectId === undefined
+            ? `/accounts/profiles/${userPath}`
+            : `/accounts/projects/${encodeURIComponent(options.projectId)}/users/${userPath}/profile`;
+        return await this.request(path, {
+            query: options.projectId === undefined ? undefined : { view: options.view ?? "merged" },
             action: "fetch user profile",
         });
     }
     async updateUserProfile(userId, firstName, lastName, options = {}) {
-        const query = options.projectId === undefined ? "" : `?project_id=${encodeURIComponent(options.projectId)}`;
-        return await this.request(`/accounts/profiles/${encodeURIComponent(userId)}${query}`, {
+        if (options.projectId === undefined && options.inherit !== undefined) {
+            throw new Error("projectId is required to inherit profile fields");
+        }
+        const userPath = encodeURIComponent(userId);
+        const path = options.projectId === undefined
+            ? `/accounts/profiles/${userPath}`
+            : `/accounts/projects/${encodeURIComponent(options.projectId)}/users/${userPath}/profile`;
+        return await this.request(path, {
             method: "PUT",
             json: {
                 ...(firstName !== undefined ? { first_name: firstName } : {}),
                 ...(lastName !== undefined ? { last_name: lastName } : {}),
                 ...(options.metadata !== undefined ? { metadata: options.metadata } : {}),
                 ...(options.annotations !== undefined ? { annotations: options.annotations } : {}),
+                ...(options.inherit !== undefined ? { inherit: options.inherit } : {}),
             },
             action: "update user profile",
         });
     }
+    async searchSysadminUsers(options = {}) {
+        return await this.request(`/accounts/sysadmin/users`, {
+            query: { filter: options.filter, page_size: options.pageSize ?? 100, continuation_token: options.continuationToken },
+            action: "search global users",
+        });
+    }
+    async getSysadminUserProfile(userId) {
+        return await this.request(`/accounts/sysadmin/users/${encodeURIComponent(userId)}`, {
+            action: "fetch global user profile",
+        });
+    }
+    async updateSysadminUserProfile(userId, fields) {
+        return await this.request(`/accounts/sysadmin/users/${encodeURIComponent(userId)}`, {
+            method: "PUT",
+            json: fields,
+            action: "update global user profile",
+        });
+    }
     async listProjects() {
         return await this.request(`/accounts/projects`, {
             action: "list projects",

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

@@ -126,6 +126,20 @@ export interface ResourcePolicyPage {
     accessGrants: ProjectRoomGrant[];
     continuationToken?: string | null;
 }
+export type UserProfileView = "project" | "user" | "merged";
+export type UserProfileField = "first_name" | "last_name" | "metadata" | "annotations";
+export interface UserProfile {
+    id: string;
+    email: string;
+    first_name: string | null;
+    last_name: string | null;
+    metadata: Record<string, unknown>;
+    annotations: Record<string, string>;
+}
+export interface UserProfilesPage {
+    users: UserProfile[];
+    continuation_token: string | null;
+}
 export interface ProjectMember {
     id: string;
     email: string;
@@ -659,14 +673,28 @@ export declare class Meshagent {
         continuationToken?: string;
         filter?: string;
         email?: string;
+        view?: UserProfileView;
     }): Promise<ProjectMembersPage>;
-    getUsersInProject(projectId: string): Promise<ProjectMember[]>;
-    getUserProfile(userId: string): Promise<Record<string, unknown>>;
-    updateUserProfile(userId: string, firstName?: string, lastName?: string, options?: {
+    getUsersInProject(projectId: string, options?: {
+        view?: UserProfileView;
+    }): Promise<ProjectMember[]>;
+    getUserProfile(userId: string, options?: {
+        projectId?: string;
+        view?: UserProfileView;
+    }): Promise<Record<string, unknown>>;
+    updateUserProfile(userId: string, firstName?: string | null, lastName?: string | null, options?: {
         metadata?: Record<string, unknown>;
         annotations?: Record<string, string>;
         projectId?: string;
+        inherit?: UserProfileField[];
     }): Promise<Record<string, unknown>>;
+    searchSysadminUsers(options?: {
+        filter?: string;
+        pageSize?: number;
+        continuationToken?: string;
+    }): Promise<UserProfilesPage>;
+    getSysadminUserProfile(userId: string): Promise<UserProfile>;
+    updateSysadminUserProfile(userId: string, fields: Partial<Pick<UserProfile, UserProfileField>>): Promise<Record<string, unknown>>;
     listProjects(): Promise<Record<string, unknown>>;
     getProject(projectId: string): Promise<Record<string, unknown>>;
     getProjectByKey(projectKey: string): Promise<Record<string, unknown>>;

package/dist/esm/meshagent-client.js

@@ -996,36 +996,69 @@ export class Meshagent {
         });
     }
     async getUsersInProjectPage(projectId, options = {}) {
-        const { pageSize = 100, continuationToken, filter, email } = options;
+        const { pageSize = 100, continuationToken, filter, email, view = "merged" } = options;
         const data = await this.request(`/accounts/projects/${projectId}/users`, {
-            query: { page_size: pageSize, continuation_token: continuationToken, filter, email },
+            query: { page_size: pageSize, continuation_token: continuationToken, filter, email, view },
             action: "fetch project users",
         });
         const users = Array.isArray(data?.users) ? data.users : [];
         return { users: users.map((user) => this.parseProjectMember(user)), continuationToken: data?.continuation_token ?? null };
     }
-    async getUsersInProject(projectId) {
-        const page = await this.getUsersInProjectPage(projectId);
+    async getUsersInProject(projectId, options = {}) {
+        const page = await this.getUsersInProjectPage(projectId, options);
         return page.users;
     }
-    async getUserProfile(userId) {
-        return await this.request(`/accounts/profiles/${userId}`, {
+    async getUserProfile(userId, options = {}) {
+        if (options.projectId === undefined && options.view === "project") {
+            throw new Error("projectId is required for the project view");
+        }
+        const userPath = encodeURIComponent(userId);
+        const path = options.projectId === undefined
+            ? `/accounts/profiles/${userPath}`
+            : `/accounts/projects/${encodeURIComponent(options.projectId)}/users/${userPath}/profile`;
+        return await this.request(path, {
+            query: options.projectId === undefined ? undefined : { view: options.view ?? "merged" },
             action: "fetch user profile",
         });
     }
     async updateUserProfile(userId, firstName, lastName, options = {}) {
-        const query = options.projectId === undefined ? "" : `?project_id=${encodeURIComponent(options.projectId)}`;
-        return await this.request(`/accounts/profiles/${encodeURIComponent(userId)}${query}`, {
+        if (options.projectId === undefined && options.inherit !== undefined) {
+            throw new Error("projectId is required to inherit profile fields");
+        }
+        const userPath = encodeURIComponent(userId);
+        const path = options.projectId === undefined
+            ? `/accounts/profiles/${userPath}`
+            : `/accounts/projects/${encodeURIComponent(options.projectId)}/users/${userPath}/profile`;
+        return await this.request(path, {
             method: "PUT",
             json: {
                 ...(firstName !== undefined ? { first_name: firstName } : {}),
                 ...(lastName !== undefined ? { last_name: lastName } : {}),
                 ...(options.metadata !== undefined ? { metadata: options.metadata } : {}),
                 ...(options.annotations !== undefined ? { annotations: options.annotations } : {}),
+                ...(options.inherit !== undefined ? { inherit: options.inherit } : {}),
             },
             action: "update user profile",
         });
     }
+    async searchSysadminUsers(options = {}) {
+        return await this.request(`/accounts/sysadmin/users`, {
+            query: { filter: options.filter, page_size: options.pageSize ?? 100, continuation_token: options.continuationToken },
+            action: "search global users",
+        });
+    }
+    async getSysadminUserProfile(userId) {
+        return await this.request(`/accounts/sysadmin/users/${encodeURIComponent(userId)}`, {
+            action: "fetch global user profile",
+        });
+    }
+    async updateSysadminUserProfile(userId, fields) {
+        return await this.request(`/accounts/sysadmin/users/${encodeURIComponent(userId)}`, {
+            method: "PUT",
+            json: fields,
+            action: "update global user profile",
+        });
+    }
     async listProjects() {
         return await this.request(`/accounts/projects`, {
             action: "list projects",

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

@@ -126,6 +126,20 @@ export interface ResourcePolicyPage {
     accessGrants: ProjectRoomGrant[];
     continuationToken?: string | null;
 }
+export type UserProfileView = "project" | "user" | "merged";
+export type UserProfileField = "first_name" | "last_name" | "metadata" | "annotations";
+export interface UserProfile {
+    id: string;
+    email: string;
+    first_name: string | null;
+    last_name: string | null;
+    metadata: Record<string, unknown>;
+    annotations: Record<string, string>;
+}
+export interface UserProfilesPage {
+    users: UserProfile[];
+    continuation_token: string | null;
+}
 export interface ProjectMember {
     id: string;
     email: string;
@@ -659,14 +673,28 @@ export declare class Meshagent {
         continuationToken?: string;
         filter?: string;
         email?: string;
+        view?: UserProfileView;
     }): Promise<ProjectMembersPage>;
-    getUsersInProject(projectId: string): Promise<ProjectMember[]>;
-    getUserProfile(userId: string): Promise<Record<string, unknown>>;
-    updateUserProfile(userId: string, firstName?: string, lastName?: string, options?: {
+    getUsersInProject(projectId: string, options?: {
+        view?: UserProfileView;
+    }): Promise<ProjectMember[]>;
+    getUserProfile(userId: string, options?: {
+        projectId?: string;
+        view?: UserProfileView;
+    }): Promise<Record<string, unknown>>;
+    updateUserProfile(userId: string, firstName?: string | null, lastName?: string | null, options?: {
         metadata?: Record<string, unknown>;
         annotations?: Record<string, string>;
         projectId?: string;
+        inherit?: UserProfileField[];
     }): Promise<Record<string, unknown>>;
+    searchSysadminUsers(options?: {
+        filter?: string;
+        pageSize?: number;
+        continuationToken?: string;
+    }): Promise<UserProfilesPage>;
+    getSysadminUserProfile(userId: string): Promise<UserProfile>;
+    updateSysadminUserProfile(userId: string, fields: Partial<Pick<UserProfile, UserProfileField>>): Promise<Record<string, unknown>>;
     listProjects(): Promise<Record<string, unknown>>;
     getProject(projectId: string): Promise<Record<string, unknown>>;
     getProjectByKey(projectKey: string): Promise<Record<string, unknown>>;

package/dist/node/meshagent-client.js

@@ -1001,36 +1001,69 @@ class Meshagent {
         });
     }
     async getUsersInProjectPage(projectId, options = {}) {
-        const { pageSize = 100, continuationToken, filter, email } = options;
+        const { pageSize = 100, continuationToken, filter, email, view = "merged" } = options;
         const data = await this.request(`/accounts/projects/${projectId}/users`, {
-            query: { page_size: pageSize, continuation_token: continuationToken, filter, email },
+            query: { page_size: pageSize, continuation_token: continuationToken, filter, email, view },
             action: "fetch project users",
         });
         const users = Array.isArray(data?.users) ? data.users : [];
         return { users: users.map((user) => this.parseProjectMember(user)), continuationToken: data?.continuation_token ?? null };
     }
-    async getUsersInProject(projectId) {
-        const page = await this.getUsersInProjectPage(projectId);
+    async getUsersInProject(projectId, options = {}) {
+        const page = await this.getUsersInProjectPage(projectId, options);
         return page.users;
     }
-    async getUserProfile(userId) {
-        return await this.request(`/accounts/profiles/${userId}`, {
+    async getUserProfile(userId, options = {}) {
+        if (options.projectId === undefined && options.view === "project") {
+            throw new Error("projectId is required for the project view");
+        }
+        const userPath = encodeURIComponent(userId);
+        const path = options.projectId === undefined
+            ? `/accounts/profiles/${userPath}`
+            : `/accounts/projects/${encodeURIComponent(options.projectId)}/users/${userPath}/profile`;
+        return await this.request(path, {
+            query: options.projectId === undefined ? undefined : { view: options.view ?? "merged" },
             action: "fetch user profile",
         });
     }
     async updateUserProfile(userId, firstName, lastName, options = {}) {
-        const query = options.projectId === undefined ? "" : `?project_id=${encodeURIComponent(options.projectId)}`;
-        return await this.request(`/accounts/profiles/${encodeURIComponent(userId)}${query}`, {
+        if (options.projectId === undefined && options.inherit !== undefined) {
+            throw new Error("projectId is required to inherit profile fields");
+        }
+        const userPath = encodeURIComponent(userId);
+        const path = options.projectId === undefined
+            ? `/accounts/profiles/${userPath}`
+            : `/accounts/projects/${encodeURIComponent(options.projectId)}/users/${userPath}/profile`;
+        return await this.request(path, {
             method: "PUT",
             json: {
                 ...(firstName !== undefined ? { first_name: firstName } : {}),
                 ...(lastName !== undefined ? { last_name: lastName } : {}),
                 ...(options.metadata !== undefined ? { metadata: options.metadata } : {}),
                 ...(options.annotations !== undefined ? { annotations: options.annotations } : {}),
+                ...(options.inherit !== undefined ? { inherit: options.inherit } : {}),
             },
             action: "update user profile",
         });
     }
+    async searchSysadminUsers(options = {}) {
+        return await this.request(`/accounts/sysadmin/users`, {
+            query: { filter: options.filter, page_size: options.pageSize ?? 100, continuation_token: options.continuationToken },
+            action: "search global users",
+        });
+    }
+    async getSysadminUserProfile(userId) {
+        return await this.request(`/accounts/sysadmin/users/${encodeURIComponent(userId)}`, {
+            action: "fetch global user profile",
+        });
+    }
+    async updateSysadminUserProfile(userId, fields) {
+        return await this.request(`/accounts/sysadmin/users/${encodeURIComponent(userId)}`, {
+            method: "PUT",
+            json: fields,
+            action: "update global user profile",
+        });
+    }
     async listProjects() {
         return await this.request(`/accounts/projects`, {
             action: "list projects",

package/package.json

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