@meshtrade/api-web 1.40.0 → 1.42.0

package/dist/meshtrade/iam/user_profile/v1/service_pb.d.ts

@@ -0,0 +1,197 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { UserProfile, UserProfileSchema } from "./user_profile_pb";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file meshtrade/iam/user_profile/v1/service.proto.
+ */
+export declare const file_meshtrade_iam_user_profile_v1_service: GenFile;
+/**
+ *
+ * Request message for GetUserProfileByUser.
+ *
+ * Retrieves a user profile by specifying the associated user resource name.
+ *
+ * @generated from message meshtrade.iam.user_profile.v1.GetUserProfileByUserRequest
+ */
+export type GetUserProfileByUserRequest = Message<"meshtrade.iam.user_profile.v1.GetUserProfileByUserRequest"> & {
+    /**
+     *
+     * The resource name of the user whose profile should be retrieved.
+     * Format: users/{ULIDv2}.
+     * This field is required.
+     *
+     * @generated from field: string user = 1;
+     */
+    user: string;
+};
+/**
+ * Describes the message meshtrade.iam.user_profile.v1.GetUserProfileByUserRequest.
+ * Use `create(GetUserProfileByUserRequestSchema)` to create a new message.
+ */
+export declare const GetUserProfileByUserRequestSchema: GenMessage<GetUserProfileByUserRequest>;
+/**
+ *
+ * Request message for UpdateUserProfile.
+ *
+ * Updates an existing user profile. Only the fields provided
+ * in the user_profile will be updated; omitted fields remain unchanged.
+ *
+ * @generated from message meshtrade.iam.user_profile.v1.UpdateUserProfileRequest
+ */
+export type UpdateUserProfileRequest = Message<"meshtrade.iam.user_profile.v1.UpdateUserProfileRequest"> & {
+    /**
+     *
+     * The user profile with updated values.
+     * The name field must be set to identify which profile to update.
+     * Only provided fields will be modified.
+     *
+     * @generated from field: meshtrade.iam.user_profile.v1.UserProfile user_profile = 1;
+     */
+    userProfile?: UserProfile;
+};
+/**
+ * Describes the message meshtrade.iam.user_profile.v1.UpdateUserProfileRequest.
+ * Use `create(UpdateUserProfileRequestSchema)` to create a new message.
+ */
+export declare const UpdateUserProfileRequestSchema: GenMessage<UpdateUserProfileRequest>;
+/**
+ *
+ *
+ * Request message for GetUserProfile.
+ *
+ * Retrieves a specific user profile by its resource name.
+ *
+ * @generated from message meshtrade.iam.user_profile.v1.GetUserProfileRequest
+ */
+export type GetUserProfileRequest = Message<"meshtrade.iam.user_profile.v1.GetUserProfileRequest"> & {
+    /**
+     *
+     * The resource name of the user profile to retrieve.
+     * Format: user_profiles/{ULIDv2}.
+     * This field is required.
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+};
+/**
+ * Describes the message meshtrade.iam.user_profile.v1.GetUserProfileRequest.
+ * Use `create(GetUserProfileRequestSchema)` to create a new message.
+ */
+export declare const GetUserProfileRequestSchema: GenMessage<GetUserProfileRequest>;
+/**
+ *
+ * Request message for ListUserProfiles.
+ *
+ * Lists all user profiles accessible to the caller based on
+ * their role permissions and group ownership.
+ *
+ * @generated from message meshtrade.iam.user_profile.v1.ListUserProfilesRequest
+ */
+export type ListUserProfilesRequest = Message<"meshtrade.iam.user_profile.v1.ListUserProfilesRequest"> & {};
+/**
+ * Describes the message meshtrade.iam.user_profile.v1.ListUserProfilesRequest.
+ * Use `create(ListUserProfilesRequestSchema)` to create a new message.
+ */
+export declare const ListUserProfilesRequestSchema: GenMessage<ListUserProfilesRequest>;
+/**
+ *
+ * Response message for ListUserProfiles.
+ *
+ * Contains the collection of user profiles accessible to the caller.
+ *
+ * @generated from message meshtrade.iam.user_profile.v1.ListUserProfilesResponse
+ */
+export type ListUserProfilesResponse = Message<"meshtrade.iam.user_profile.v1.ListUserProfilesResponse"> & {
+    /**
+     *
+     * The list of user profiles.
+     * Ordered by creation time, with most recent first.
+     *
+     * @generated from field: repeated meshtrade.iam.user_profile.v1.UserProfile user_profiles = 1;
+     */
+    userProfiles: UserProfile[];
+};
+/**
+ * Describes the message meshtrade.iam.user_profile.v1.ListUserProfilesResponse.
+ * Use `create(ListUserProfilesResponseSchema)` to create a new message.
+ */
+export declare const ListUserProfilesResponseSchema: GenMessage<ListUserProfilesResponse>;
+/**
+ *
+ * UserProfileService manages user profile information and preferences.
+ *
+ * User profiles contain display preferences, localization settings, and
+ * personalization data for authenticated users in the IAM system.
+ * Each profile is linked to a specific user and owned by a group.
+ *
+ * @generated from service meshtrade.iam.user_profile.v1.UserProfileService
+ */
+export declare const UserProfileService: GenService<{
+    /**
+     *
+     * Updates an existing user profile.
+     *
+     * Allows modification of profile information including display name,
+     * profile picture, locale preferences, and currency settings.
+     * Only the fields provided in the request will be updated.
+     *
+     * Returns the updated UserProfile resource.
+     *
+     * @generated from rpc meshtrade.iam.user_profile.v1.UserProfileService.UpdateUserProfile
+     */
+    updateUserProfile: {
+        methodKind: "unary";
+        input: typeof UpdateUserProfileRequestSchema;
+        output: typeof UserProfileSchema;
+    };
+    /**
+     *
+     * Retrieves a user profile by its resource name.
+     *
+     * Fetches the complete user profile information including all
+     * preferences and settings for the specified user profile ID.
+     *
+     * Returns the requested UserProfile resource.
+     *
+     * @generated from rpc meshtrade.iam.user_profile.v1.UserProfileService.GetUserProfile
+     */
+    getUserProfile: {
+        methodKind: "unary";
+        input: typeof GetUserProfileRequestSchema;
+        output: typeof UserProfileSchema;
+    };
+    /**
+     *
+     * Retrieves a user profile by the associated user resource name.
+     *
+     * Looks up and returns the user profile linked to a specific user ID.
+     * This is useful when you have a user resource and need to find
+     * their associated profile information.
+     *
+     * Returns the UserProfile resource associated with the specified user.
+     *
+     * @generated from rpc meshtrade.iam.user_profile.v1.UserProfileService.GetUserProfileByUser
+     */
+    getUserProfileByUser: {
+        methodKind: "unary";
+        input: typeof GetUserProfileByUserRequestSchema;
+        output: typeof UserProfileSchema;
+    };
+    /**
+     *
+     * Lists all user_profiles accessible to the caller.
+     *
+     * Returns a collection of all user_profiles within the caller's
+     * access scope based on group ownership and role permissions.
+     *
+     * Returns a ListUserProfilesResponse containing all accessible user_profiles.
+     *
+     * @generated from rpc meshtrade.iam.user_profile.v1.UserProfileService.ListUserProfiles
+     */
+    listUserProfiles: {
+        methodKind: "unary";
+        input: typeof ListUserProfilesRequestSchema;
+        output: typeof ListUserProfilesResponseSchema;
+    };
+}>;

package/dist/meshtrade/iam/user_profile/v1/service_pb.js

@@ -0,0 +1,50 @@
+"use strict";
+// @generated by protoc-gen-es v2.10.1 with parameter "target=ts"
+// @generated from file meshtrade/iam/user_profile/v1/service.proto (package meshtrade.iam.user_profile.v1, syntax proto3)
+/* eslint-disable */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserProfileService = exports.ListUserProfilesResponseSchema = exports.ListUserProfilesRequestSchema = exports.GetUserProfileRequestSchema = exports.UpdateUserProfileRequestSchema = exports.GetUserProfileByUserRequestSchema = exports.file_meshtrade_iam_user_profile_v1_service = void 0;
+const codegenv2_1 = require("@bufbuild/protobuf/codegenv2");
+const validate_pb_1 = require("../../../../buf/validate/validate_pb");
+const user_profile_pb_1 = require("./user_profile_pb");
+const method_options_pb_1 = require("../../../option/method_options/v1/method_options_pb");
+/**
+ * Describes the file meshtrade/iam/user_profile/v1/service.proto.
+ */
+exports.file_meshtrade_iam_user_profile_v1_service = (0, codegenv2_1.fileDesc)("CittZXNodHJhZGUvaWFtL3VzZXJfcHJvZmlsZS92MS9zZXJ2aWNlLnByb3RvEh1tZXNodHJhZGUuaWFtLnVzZXJfcHJvZmlsZS52MSL4AgobR2V0VXNlclByb2ZpbGVCeVVzZXJSZXF1ZXN0EtgCCgR1c2VyGAEgASgJQskCukjFAroBVgoNdXNlci5yZXF1aXJlZBI1dXNlciBpcyByZXF1aXJlZCBhbmQgbXVzdCBiZSBpbiBmb3JtYXQgdXNlcnMve1VMSUR2Mn0aDnNpemUodGhpcykgPiAwugGxAQoLdXNlci5mb3JtYXQSYm5hbWUgbXVzdCBiZSBpbiBmb3JtYXQgdXNlcnMve1VMSUR2Mn0gd2hlcmUgdWxpZHYyIGlzIGV4YWN0bHkgMjYgdXBwZXJjYXNlIGFscGhhbnVtZXJpYyBjaGFyYWN0ZXJzGj50aGlzLm1hdGNoZXMoJ151c2Vycy9bMDEyMzQ1Njc4OUFCQ0RFRkdISktNTlBRUlNUVldYWVpdezI2fSQnKcgBAXIyEAEyLl51c2Vycy9bMDEyMzQ1Njc4OUFCQ0RFRkdISktNTlBRUlNUVldYWVpdezI2fSQiZAoYVXBkYXRlVXNlclByb2ZpbGVSZXF1ZXN0EkgKDHVzZXJfcHJvZmlsZRgBIAEoCzIqLm1lc2h0cmFkZS5pYW0udXNlcl9wcm9maWxlLnYxLlVzZXJQcm9maWxlQga6SAPIAQEikgMKFUdldFVzZXJQcm9maWxlUmVxdWVzdBL4AgoEbmFtZRgBIAEoCULpArpI5QK6AV4KDW5hbWUucmVxdWlyZWQSPW5hbWUgaXMgcmVxdWlyZWQgYW5kIG11c3QgYmUgaW4gZm9ybWF0IHVzZXJfcHJvZmlsZXMve1VMSUR2Mn0aDnNpemUodGhpcykgPiAwugHBAQoLbmFtZS5mb3JtYXQSam5hbWUgbXVzdCBiZSBpbiBmb3JtYXQgdXNlcl9wcm9maWxlcy97VUxJRHYyfSB3aGVyZSB1bGlkdjIgaXMgZXhhY3RseSAyNiB1cHBlcmNhc2UgYWxwaGFudW1lcmljIGNoYXJhY3RlcnMaRnRoaXMubWF0Y2hlcygnXnVzZXJfcHJvZmlsZXMvWzAxMjM0NTY3ODlBQkNERUZHSEpLTU5QUVJTVFZXWFlaXXsyNn0kJynIAQFyOhABMjZedXNlcl9wcm9maWxlcy9bMDEyMzQ1Njc4OUFCQ0RFRkdISktNTlBRUlNUVldYWVpdezI2fSQiGQoXTGlzdFVzZXJQcm9maWxlc1JlcXVlc3QiXQoYTGlzdFVzZXJQcm9maWxlc1Jlc3BvbnNlEkEKDXVzZXJfcHJvZmlsZXMYASADKAsyKi5tZXNodHJhZGUuaWFtLnVzZXJfcHJvZmlsZS52MS5Vc2VyUHJvZmlsZTLzBAoSVXNlclByb2ZpbGVTZXJ2aWNlEowBChFVcGRhdGVVc2VyUHJvZmlsZRI3Lm1lc2h0cmFkZS5pYW0udXNlcl9wcm9maWxlLnYxLlVwZGF0ZVVzZXJQcm9maWxlUmVxdWVzdBoqLm1lc2h0cmFkZS5pYW0udXNlcl9wcm9maWxlLnYxLlVzZXJQcm9maWxlIhKytRgOCAIQAhoIwI23AciNtwESjgEKDkdldFVzZXJQcm9maWxlEjQubWVzaHRyYWRlLmlhbS51c2VyX3Byb2ZpbGUudjEuR2V0VXNlclByb2ZpbGVSZXF1ZXN0GioubWVzaHRyYWRlLmlhbS51c2VyX3Byb2ZpbGUudjEuVXNlclByb2ZpbGUiGrK1GBYIARACGhDAjbcBwY23AciNtwHJjbcBEpoBChRHZXRVc2VyUHJvZmlsZUJ5VXNlchI6Lm1lc2h0cmFkZS5pYW0udXNlcl9wcm9maWxlLnYxLkdldFVzZXJQcm9maWxlQnlVc2VyUmVxdWVzdBoqLm1lc2h0cmFkZS5pYW0udXNlcl9wcm9maWxlLnYxLlVzZXJQcm9maWxlIhqytRgWCAEQAhoQwI23AcGNtwHIjbcByY23ARKfAQoQTGlzdFVzZXJQcm9maWxlcxI2Lm1lc2h0cmFkZS5pYW0udXNlcl9wcm9maWxlLnYxLkxpc3RVc2VyUHJvZmlsZXNSZXF1ZXN0GjcubWVzaHRyYWRlLmlhbS51c2VyX3Byb2ZpbGUudjEuTGlzdFVzZXJQcm9maWxlc1Jlc3BvbnNlIhqytRgWCAEQAhoQwI23AcGNtwHIjbcByY23AUJnCiRjby5tZXNodHJhZGUuYXBpLmlhbS51c2VyX3Byb2ZpbGUudjFaP2dpdGh1Yi5jb20vbWVzaHRyYWRlL2FwaS9nby9pYW0vdXNlcl9wcm9maWxlL3YxO3VzZXJfcHJvZmlsZV92MWIGcHJvdG8z", [validate_pb_1.file_buf_validate_validate, user_profile_pb_1.file_meshtrade_iam_user_profile_v1_user_profile, method_options_pb_1.file_meshtrade_option_method_options_v1_method_options]);
+/**
+ * Describes the message meshtrade.iam.user_profile.v1.GetUserProfileByUserRequest.
+ * Use `create(GetUserProfileByUserRequestSchema)` to create a new message.
+ */
+exports.GetUserProfileByUserRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_user_profile_v1_service, 0);
+/**
+ * Describes the message meshtrade.iam.user_profile.v1.UpdateUserProfileRequest.
+ * Use `create(UpdateUserProfileRequestSchema)` to create a new message.
+ */
+exports.UpdateUserProfileRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_user_profile_v1_service, 1);
+/**
+ * Describes the message meshtrade.iam.user_profile.v1.GetUserProfileRequest.
+ * Use `create(GetUserProfileRequestSchema)` to create a new message.
+ */
+exports.GetUserProfileRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_user_profile_v1_service, 2);
+/**
+ * Describes the message meshtrade.iam.user_profile.v1.ListUserProfilesRequest.
+ * Use `create(ListUserProfilesRequestSchema)` to create a new message.
+ */
+exports.ListUserProfilesRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_user_profile_v1_service, 3);
+/**
+ * Describes the message meshtrade.iam.user_profile.v1.ListUserProfilesResponse.
+ * Use `create(ListUserProfilesResponseSchema)` to create a new message.
+ */
+exports.ListUserProfilesResponseSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_user_profile_v1_service, 4);
+/**
+ *
+ * UserProfileService manages user profile information and preferences.
+ *
+ * User profiles contain display preferences, localization settings, and
+ * personalization data for authenticated users in the IAM system.
+ * Each profile is linked to a specific user and owned by a group.
+ *
+ * @generated from service meshtrade.iam.user_profile.v1.UserProfileService
+ */
+exports.UserProfileService = (0, codegenv2_1.serviceDesc)(exports.file_meshtrade_iam_user_profile_v1_service, 0);

package/dist/meshtrade/iam/user_profile/v1/service_web_meshts.d.ts

@@ -0,0 +1,109 @@
+import { GetUserProfileByUserRequest, GetUserProfileRequest, ListUserProfilesRequest, ListUserProfilesResponse, UpdateUserProfileRequest } from "./service_pb";
+import { UserProfile } from "./user_profile_pb";
+import { ClientOption } from "../../../config";
+/**
+ * Web client for interacting with the meshtrade.iam.user_profile.v1 user profile v1 API resource service.
+ * Uses Connect-ES with gRPC-Web transport for browser-based communication.
+ *
+ * Supports flexible authentication modes using functional options pattern:
+ *
+ * 1. **No Authentication** (public APIs):
+ *    ```typescript
+ *    const client = new UserProfileServiceWeb(
+ *      WithServerUrl("http://localhost:10000")
+ *    );
+ *    ```
+ *
+ * 2. **API Key Authentication** (backend services):
+ *    ```typescript
+ *    const client = new UserProfileServiceWeb(
+ *      WithAPIKey("your-api-key"),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 3. **JWT Token Authentication** (Next.js frontend with user session):
+ *    ```typescript
+ *    const client = new UserProfileServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 4. **JWT with Group Context** (user session with specific group):
+ *    ```typescript
+ *    const client = new UserProfileServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * Available options:
+ * - `WithAPIKey(key)` - API key authentication (mutually exclusive with JWT)
+ * - `WithJWTAccessToken(token)` - JWT authentication (mutually exclusive with API key)
+ * - `WithGroup(group)` - Group context (optional, works with both auth modes)
+ * - `WithServerUrl(url)` - Custom server URL (optional, defaults to production)
+ */
+export declare class UserProfileServiceWeb {
+    private _client;
+    private readonly _config;
+    private readonly _interceptors;
+    private readonly _validator;
+    /**
+     * Constructs an instance of UserProfileServiceWeb.
+     *
+     * Uses functional options pattern for flexible configuration:
+     * - `WithAPIKey(key)` - API key authentication
+     * - `WithJWTAccessToken(token)` - JWT authentication
+     * - `WithGroup(group)` - Group context (optional)
+     * - `WithServerUrl(url)` - Custom server URL (optional)
+     *
+     * @param {...ClientOption} opts - Variable number of configuration options
+     */
+    constructor(...opts: ClientOption[]);
+    /**
+     * Returns a new client instance configured to send the specified group
+     * resource name in the request headers for subsequent API calls.
+     *
+     * This method creates a new client with the same authentication configuration
+     * but with the group context updated to the specified value.
+     *
+     * **Compatibility**: Works with all authentication modes:
+     * - **API key auth**: Creates new client with API key + new group
+     * - **JWT auth**: Creates new client with JWT + new group
+     * - **No auth**: Creates new client with standalone group interceptor
+     *
+     * @param {string} group - The operating group context to inject into the request
+     *                         in the format `groups/{ulid}` where {ulid} is a 26-character ULID.
+     *                         Example: 'groups/01ARZ3NDEKTSV4YWVF8F5BH32'
+     * @returns {UserProfileServiceWeb} A new, configured instance of the client.
+     * @throws {Error} If the group format is invalid
+     */
+    withGroup(group: string): UserProfileServiceWeb;
+    /**
+     * Updates an existing user profile.
+     * @param {UpdateUserProfileRequest} request - The request object for updateuserprofile.
+     * @returns {Promise<UserProfile>} A promise that resolves with the user profile.
+     */
+    updateUserProfile(request: UpdateUserProfileRequest): Promise<UserProfile>;
+    /**
+     * Retrieves an user profile.
+     * @param {GetUserProfileRequest} request - The request object for getuserprofile.
+     * @returns {Promise<UserProfile>} A promise that resolves with the user profile.
+     */
+    getUserProfile(request: GetUserProfileRequest): Promise<UserProfile>;
+    /**
+     * Retrieves an user profile.
+     * @param {GetUserProfileByUserRequest} request - The request object for getuserprofilebyuser.
+     * @returns {Promise<UserProfile>} A promise that resolves with the user profile.
+     */
+    getUserProfileByUser(request: GetUserProfileByUserRequest): Promise<UserProfile>;
+    /**
+     * Retrieves a list of user profiles.
+     * @param {ListUserProfilesRequest} request - The request object for listuserprofiles.
+     * @returns {Promise<ListUserProfilesResponse>} A promise that resolves with the list of user profiles.
+     */
+    listUserProfiles(request: ListUserProfilesRequest): Promise<ListUserProfilesResponse>;
+}

package/dist/meshtrade/iam/user_profile/v1/service_web_meshts.js

@@ -0,0 +1,202 @@
+"use strict";
+// Code generated by protoc-gen-meshts. DO NOT EDIT.
+// @generated by protoc-gen-meshts v1
+// @generated from file meshtrade/iam/user_profile/v1/service.proto (package meshtrade.iam.user_profile.v1, syntax proto3)
+/* eslint-disable */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserProfileServiceWeb = void 0;
+const connect_1 = require("@connectrpc/connect");
+const connect_web_1 = require("@connectrpc/connect-web");
+const service_pb_1 = require("./service_pb");
+const service_pb_2 = require("./service_pb");
+const config_1 = require("../../../config");
+const protovalidate_1 = require("@bufbuild/protovalidate");
+const interceptors_1 = require("../../../interceptors");
+/**
+ * Web client for interacting with the meshtrade.iam.user_profile.v1 user profile v1 API resource service.
+ * Uses Connect-ES with gRPC-Web transport for browser-based communication.
+ *
+ * Supports flexible authentication modes using functional options pattern:
+ *
+ * 1. **No Authentication** (public APIs):
+ *    ```typescript
+ *    const client = new UserProfileServiceWeb(
+ *      WithServerUrl("http://localhost:10000")
+ *    );
+ *    ```
+ *
+ * 2. **API Key Authentication** (backend services):
+ *    ```typescript
+ *    const client = new UserProfileServiceWeb(
+ *      WithAPIKey("your-api-key"),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 3. **JWT Token Authentication** (Next.js frontend with user session):
+ *    ```typescript
+ *    const client = new UserProfileServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * 4. **JWT with Group Context** (user session with specific group):
+ *    ```typescript
+ *    const client = new UserProfileServiceWeb(
+ *      WithJWTAccessToken("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."),
+ *      WithGroup("groups/01ARZ3NDEKTSV4YWVF8F5BH32"),
+ *      WithServerUrl("https://api.example.com")
+ *    );
+ *    ```
+ *
+ * Available options:
+ * - `WithAPIKey(key)` - API key authentication (mutually exclusive with JWT)
+ * - `WithJWTAccessToken(token)` - JWT authentication (mutually exclusive with API key)
+ * - `WithGroup(group)` - Group context (optional, works with both auth modes)
+ * - `WithServerUrl(url)` - Custom server URL (optional, defaults to production)
+ */
+class UserProfileServiceWeb {
+    /**
+     * Constructs an instance of UserProfileServiceWeb.
+     *
+     * Uses functional options pattern for flexible configuration:
+     * - `WithAPIKey(key)` - API key authentication
+     * - `WithJWTAccessToken(token)` - JWT authentication
+     * - `WithGroup(group)` - Group context (optional)
+     * - `WithServerUrl(url)` - Custom server URL (optional)
+     *
+     * @param {...ClientOption} opts - Variable number of configuration options
+     */
+    constructor(...opts) {
+        // Build configuration from options
+        this._config = (0, config_1.buildConfigFromOptions)(...opts);
+        // Initialize validator for request validation
+        this._validator = (0, protovalidate_1.createValidator)();
+        this._interceptors = [];
+        this._interceptors.push((0, interceptors_1.createLoggingInterceptor)());
+        if (this._config.apiKey) {
+            this._interceptors.push((0, interceptors_1.createApiKeyInterceptor)(this._config.apiKey));
+        }
+        if (this._config.jwtToken) {
+            this._interceptors.push((0, interceptors_1.createJwtInterceptor)(this._config.jwtToken));
+        }
+        if (this._config.group) {
+            this._interceptors.push((0, interceptors_1.createGroupInterceptor)(this._config.group));
+        }
+        // Create the gRPC-Web transport for browser with interceptors
+        // Custom fetch wrapper to include credentials for cookie-based authentication
+        const transport = (0, connect_web_1.createGrpcWebTransport)({
+            baseUrl: this._config.apiServerURL,
+            interceptors: this._interceptors,
+            fetch: (input, init) => fetch(input, { ...init, credentials: "include" }),
+        });
+        // Construct the Connect-ES client
+        this._client = (0, connect_1.createClient)(service_pb_1.UserProfileService, transport);
+    }
+    /**
+     * Returns a new client instance configured to send the specified group
+     * resource name in the request headers for subsequent API calls.
+     *
+     * This method creates a new client with the same authentication configuration
+     * but with the group context updated to the specified value.
+     *
+     * **Compatibility**: Works with all authentication modes:
+     * - **API key auth**: Creates new client with API key + new group
+     * - **JWT auth**: Creates new client with JWT + new group
+     * - **No auth**: Creates new client with standalone group interceptor
+     *
+     * @param {string} group - The operating group context to inject into the request
+     *                         in the format `groups/{ulid}` where {ulid} is a 26-character ULID.
+     *                         Example: 'groups/01ARZ3NDEKTSV4YWVF8F5BH32'
+     * @returns {UserProfileServiceWeb} A new, configured instance of the client.
+     * @throws {Error} If the group format is invalid
+     */
+    withGroup(group) {
+        // Build new options array with existing auth and updated group
+        const newOpts = [];
+        // Add server URL
+        newOpts.push((0, config_1.WithServerUrl)(this._config.apiServerURL));
+        // Add authentication (preserve existing mode)
+        if (this._config.apiKey) {
+            newOpts.push((0, config_1.WithAPIKey)(this._config.apiKey));
+        }
+        else if (this._config.jwtToken) {
+            newOpts.push((0, config_1.WithJWTAccessToken)(this._config.jwtToken));
+        }
+        // Add the new group
+        newOpts.push((0, config_1.WithGroup)(group));
+        // Return a new client instance with updated configuration
+        return new UserProfileServiceWeb(...newOpts);
+    }
+    /**
+     * Updates an existing user profile.
+     * @param {UpdateUserProfileRequest} request - The request object for updateuserprofile.
+     * @returns {Promise<UserProfile>} A promise that resolves with the user profile.
+     */
+    updateUserProfile(request) {
+        // Validate request
+        const result = this._validator.validate(service_pb_2.UpdateUserProfileRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
+        return this._client.updateUserProfile(request);
+    }
+    /**
+     * Retrieves an user profile.
+     * @param {GetUserProfileRequest} request - The request object for getuserprofile.
+     * @returns {Promise<UserProfile>} A promise that resolves with the user profile.
+     */
+    getUserProfile(request) {
+        // Validate request
+        const result = this._validator.validate(service_pb_2.GetUserProfileRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
+        return this._client.getUserProfile(request);
+    }
+    /**
+     * Retrieves an user profile.
+     * @param {GetUserProfileByUserRequest} request - The request object for getuserprofilebyuser.
+     * @returns {Promise<UserProfile>} A promise that resolves with the user profile.
+     */
+    getUserProfileByUser(request) {
+        // Validate request
+        const result = this._validator.validate(service_pb_2.GetUserProfileByUserRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
+        return this._client.getUserProfileByUser(request);
+    }
+    /**
+     * Retrieves a list of user profiles.
+     * @param {ListUserProfilesRequest} request - The request object for listuserprofiles.
+     * @returns {Promise<ListUserProfilesResponse>} A promise that resolves with the list of user profiles.
+     */
+    listUserProfiles(request) {
+        // Validate request
+        const result = this._validator.validate(service_pb_2.ListUserProfilesRequestSchema, request);
+        if (result.kind === "invalid") {
+            const violations = result.violations.map(v => `${v.field.toString()}: ${v.message}`).join("; ");
+            throw new Error(`Validation failed: ${violations}`);
+        }
+        else if (result.kind === "error") {
+            throw result.error;
+        }
+        return this._client.listUserProfiles(request);
+    }
+}
+exports.UserProfileServiceWeb = UserProfileServiceWeb;

package/dist/meshtrade/iam/user_profile/v1/user_profile_pb.d.ts

@@ -0,0 +1,106 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Token } from "../../../type/v1/token_pb";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file meshtrade/iam/user_profile/v1/user_profile.proto.
+ */
+export declare const file_meshtrade_iam_user_profile_v1_user_profile: GenFile;
+/**
+ *
+ * A user_profile in the IAM user_profile service.
+ *
+ * Each User Profile belongs to a specific user
+ *
+ * @generated from message meshtrade.iam.user_profile.v1.UserProfile
+ */
+export type UserProfile = Message<"meshtrade.iam.user_profile.v1.UserProfile"> & {
+    /**
+     *
+     * The unique resource name for the user_profiles.
+     * Format: user_profiles/{ULIDv2}.
+     * This field is system-generated and immutable upon creation.
+     * Any value provided on creation is ignored.
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+    /**
+     *
+     * The resource name of the parent group that owns this user_profile.
+     * This field is required on creation and establishes the direct ownership link.
+     * Format: groups/{ULIDv2}.
+     *
+     * @generated from field: string owner = 2;
+     */
+    owner: string;
+    /**
+     *
+     * Ownership hiearchy of groups that have access to this resource in the format groups/{group_id}.
+     * System set on creation.
+     *
+     * @generated from field: repeated string owners = 3;
+     */
+    owners: string[];
+    /**
+     *
+     * The resource name of the user associated with this profile.
+     * Format: users/{ULIDv2}.
+     * This field links the user profile to a specific user resource.
+     * This field is required.
+     *
+     * @generated from field: string user = 4;
+     */
+    user: string;
+    /**
+     *
+     * The locale/language preference for this user profile.
+     * Format: IETF BCP 47 language tag (e.g., "en", "en-US", "fr-FR", "zh-Hans-CN").
+     * Used for internationalization and localization of the user interface.
+     * This field is optional but must be a valid BCP 47 tag when provided.
+     *
+     * @generated from field: string locale = 5;
+     */
+    locale: string;
+    /**
+     *
+     * URL to the user's profile picture or avatar image.
+     * Should be a valid HTTPS URL pointing to an accessible image resource.
+     * Used for displaying user identity in the application interface.
+     * This field is optional but must be a valid URI when provided.
+     *
+     * @generated from field: string profile_picture_url = 6;
+     */
+    profilePictureUrl: string;
+    /**
+     *
+     * The display name shown for this user in the application.
+     * This field is required and represents how the user is identified to others.
+     * May be the user's full name, nickname, or preferred identifier.
+     *
+     * @generated from field: string display_name = 7;
+     */
+    displayName: string;
+    /**
+     *
+     * The preferred currency token for displaying monetary values to this user.
+     * Used as the default currency for presenting prices, balances, and trading values.
+     * References a token from the meshtrade.type.v1.Token definition.
+     *
+     * @generated from field: meshtrade.type.v1.Token display_currency = 8;
+     */
+    displayCurrency?: Token;
+    /**
+     *
+     * The currency token used for financial reporting and accounting purposes.
+     * This may differ from display_currency and is used for official records and statements.
+     * References a token from the meshtrade.type.v1.Token definition.
+     *
+     * @generated from field: meshtrade.type.v1.Token reporting_currency = 9;
+     */
+    reportingCurrency?: Token;
+};
+/**
+ * Describes the message meshtrade.iam.user_profile.v1.UserProfile.
+ * Use `create(UserProfileSchema)` to create a new message.
+ */
+export declare const UserProfileSchema: GenMessage<UserProfile>;