@meshtrade/api-node 1.30.0

package/dist/meshtrade/iam/group/v1/group_pb.d.ts

@@ -0,0 +1,58 @@
+import type { GenFile, GenMessage } from "@bufbuild/protobuf/codegenv2";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file meshtrade/iam/group/v1/group.proto.
+ */
+export declare const file_meshtrade_iam_group_v1_group: GenFile;
+/**
+ *
+ * Organizational group resource representing a multi-tenancy boundary.
+ *
+ * Groups form hierarchical ownership structures within Mesh, enabling resource
+ * isolation, permission inheritance, and organizational modeling. Each group
+ * can own sub-groups, users, API users, accounts, and trading resources,
+ * providing a complete tenant separation model.
+ *
+ * @generated from message meshtrade.iam.group.v1.Group
+ */
+export type Group = Message<"meshtrade.iam.group.v1.Group"> & {
+    /**
+     *
+     * The unique resource name for the group.
+     * Format: groups/{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 group.
+     * This field is required on creation and establishes the direct ownership link.
+     * Format: groups/{ULIDv2}.
+     *
+     * @generated from field: string owner = 2;
+     */
+    owner: string;
+    /**
+     *
+     * Human-readable name for organizational identification and display.
+     * User-configurable and non-unique across the system.
+     *
+     * @generated from field: string display_name = 4;
+     */
+    displayName: string;
+    /**
+     *
+     * Optional contextual information describing the group's organizational purpose.
+     *
+     * @generated from field: string description = 5;
+     */
+    description: string;
+};
+/**
+ * Describes the message meshtrade.iam.group.v1.Group.
+ * Use `create(GroupSchema)` to create a new message.
+ */
+export declare const GroupSchema: GenMessage<Group>;

package/dist/meshtrade/iam/group/v1/group_pb.js

@@ -0,0 +1,17 @@
+"use strict";
+// @generated by protoc-gen-es v2.10.1 with parameter "target=ts"
+// @generated from file meshtrade/iam/group/v1/group.proto (package meshtrade.iam.group.v1, syntax proto3)
+/* eslint-disable */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupSchema = exports.file_meshtrade_iam_group_v1_group = void 0;
+const codegenv2_1 = require("@bufbuild/protobuf/codegenv2");
+const validate_pb_1 = require("../../../../buf/validate/validate_pb");
+/**
+ * Describes the file meshtrade/iam/group/v1/group.proto.
+ */
+exports.file_meshtrade_iam_group_v1_group = (0, codegenv2_1.fileDesc)("CiJtZXNodHJhZGUvaWFtL2dyb3VwL3YxL2dyb3VwLnByb3RvEhZtZXNodHJhZGUuaWFtLmdyb3VwLnYxItECCgVHcm91cBK2AQoEbmFtZRgBIAEoCUKnAbpIowG6AZ8BChRuYW1lLmZvcm1hdC5vcHRpb25hbBIzbmFtZSBtdXN0IGJlIGVtcHR5IG9yIGluIHRoZSBmb3JtYXQgZ3JvdXBzL3tVTElEdjJ9GlJzaXplKHRoaXMpID09IDAgfHwgdGhpcy5tYXRjaGVzKCdeZ3JvdXBzL1swMTIzNDU2Nzg5QUJDREVGR0hKS01OUFFSU1RWV1hZWl17MjZ9JCcpEksKBW93bmVyGAIgASgJQjy6SDnIAQFyNDIvXmdyb3Vwcy9bMDEyMzQ1Njc4OUFCQ0RFRkdISktNTlBRUlNUVldYWVpdezI2fSSYASESIwoMZGlzcGxheV9uYW1lGAQgASgJQg26SArIAQFyBRABGP8BEh0KC2Rlc2NyaXB0aW9uGAUgASgJQgi6SAVyAxjoB0JSCh1jby5tZXNodHJhZGUuYXBpLmlhbS5ncm91cC52MVoxZ2l0aHViLmNvbS9tZXNodHJhZGUvYXBpL2dvL2lhbS9ncm91cC92MTtncm91cF92MWIGcHJvdG8z", [validate_pb_1.file_buf_validate_validate]);
+/**
+ * Describes the message meshtrade.iam.group.v1.Group.
+ * Use `create(GroupSchema)` to create a new message.
+ */
+exports.GroupSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_group_v1_group, 0);

package/dist/meshtrade/iam/group/v1/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./group_pb";
+export * from "./service_node_meshts";
+export * from "./service_pb";

package/dist/meshtrade/iam/group/v1/index.js

@@ -0,0 +1,44 @@
+"use strict";
+// ===================================================================
+// AUTO-GENERATED SECTION - ONLY EDIT BELOW THE CLOSING COMMENT BLOCK
+// ===================================================================
+// This section is automatically managed by protoc-gen-meshts.
+//
+// DO NOT EDIT ANYTHING IN THIS SECTION MANUALLY!
+// Your changes will be overwritten during code generation.
+//
+// To add custom exports, scroll down to the
+// "MANUAL EXPORTS" section indicated below.
+// ===================================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Generated exports
+__exportStar(require("./group_pb"), exports);
+__exportStar(require("./service_node_meshts"), exports);
+__exportStar(require("./service_pb"), exports);
+// ===================================================================
+// END OF AUTO-GENERATED SECTION
+// ===================================================================
+//
+// MANUAL EXPORTS - ADD YOUR CUSTOM EXPORTS BELOW
+//
+// You can safely add your own export statements in this section.
+// They will be preserved across code generation.
+//
+// Example:
+//   export * from "./my_custom_module";
+//   export { MyCustomClass } from "./another_module";
+// ===================================================================

package/dist/meshtrade/iam/group/v1/service_node_meshts.d.ts

@@ -0,0 +1,90 @@
+import { Interceptor } from "@connectrpc/connect";
+import { CreateGroupRequest, GetGroupRequest, ListGroupsRequest, ListGroupsResponse, SearchGroupsRequest, SearchGroupsResponse, UpdateGroupRequest } from "./service_pb";
+import { Group } from "./group_pb";
+import { ConfigOpts } from "../../../common/config";
+/**
+ * Node.js client for interacting with the meshtrade.iam.group.v1 group v1 API resource service.
+ * Uses Connect-ES with gRPC transport for Node.js gRPC communication.
+ *
+ * Supports three authentication modes:
+ *
+ * 1. **No Authentication** (public APIs):
+ *    ```typescript
+ *    const client = new GroupServiceNode({ apiServerURL: "http://localhost:10000" });
+ *    ```
+ *
+ * 2. **API Key Authentication** (backend services):
+ *    ```typescript
+ *    const client = new GroupServiceNode({
+ *      apiServerURL: "https://api.example.com",
+ *      apiKey: "your-api-key",
+ *      group: "groups/01ARZ3NDEKTSV4YWVF8F5BH32"
+ *    });
+ *    ```
+ *
+ * 3. **JWT Token Authentication** (Next.js backend with user session):
+ *    ```typescript
+ *    const client = new GroupServiceNode({
+ *      apiServerURL: "https://api.example.com",
+ *      jwtToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+ *    });
+ *    ```
+ */
+export declare class GroupServiceNode {
+    private _client;
+    private readonly _config;
+    private readonly _interceptors;
+    /**
+     * Constructs an instance of GroupServiceNode.
+     * @param {ConfigOpts} [config] - Optional configuration for the client.
+     * @param {Interceptor[]} [interceptors] - For internal use by `withGroup`.
+     */
+    constructor(config?: ConfigOpts, interceptors?: Interceptor[]);
+    /**
+     * Returns a new client instance configured to send the specified group
+     * resource name in the request headers for subsequent API calls.
+     *
+     * **Important**: This method only works with API key authentication.
+     * - For **API key auth**: Creates a new client with updated group context
+     * - For **JWT auth**: Throws error (group comes from JWT token claims)
+     * - For **no auth**: Throws error (group requires authentication)
+     *
+     * @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 {GroupServiceNode} A new, configured instance of the client.
+     * @throws {Error} If used with JWT authentication or no authentication
+     * @throws {Error} If the group format is invalid
+     */
+    withGroup(group: string): GroupServiceNode;
+    /**
+     * Creates a new group.
+     * @param {CreateGroupRequest} request - The request object for creategroup.
+     * @returns {Promise<Group>} A promise that resolves with the group.
+     */
+    createGroup(request: CreateGroupRequest): Promise<Group>;
+    /**
+     * Updates an existing group.
+     * @param {UpdateGroupRequest} request - The request object for updategroup.
+     * @returns {Promise<Group>} A promise that resolves with the group.
+     */
+    updateGroup(request: UpdateGroupRequest): Promise<Group>;
+    /**
+     * Retrieves a list of groups.
+     * @param {ListGroupsRequest} request - The request object for listgroups.
+     * @returns {Promise<ListGroupsResponse>} A promise that resolves with the list of groups.
+     */
+    listGroups(request: ListGroupsRequest): Promise<ListGroupsResponse>;
+    /**
+     * Searches for groups.
+     * @param {SearchGroupsRequest} request - The request object for searchgroups.
+     * @returns {Promise<SearchGroupsResponse>} A promise that resolves with the search results.
+     */
+    searchGroups(request: SearchGroupsRequest): Promise<SearchGroupsResponse>;
+    /**
+     * Retrieves a group.
+     * @param {GetGroupRequest} request - The request object for getgroup.
+     * @returns {Promise<Group>} A promise that resolves with the group.
+     */
+    getGroup(request: GetGroupRequest): Promise<Group>;
+}

package/dist/meshtrade/iam/group/v1/service_node_meshts.js

@@ -0,0 +1,161 @@
+"use strict";
+// @generated by protoc-gen-meshts v1
+// @generated from file meshtrade/iam/group/v1/service.proto (package meshtrade.iam.group.v1, syntax proto3)
+/* eslint-disable */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupServiceNode = void 0;
+const connect_1 = require("@connectrpc/connect");
+const connect_node_1 = require("@connectrpc/connect-node");
+const service_pb_1 = require("./service_pb");
+const config_1 = require("../../../common/config");
+const validation_1 = require("../../../common/validation");
+const connectInterceptors_1 = require("../../../common/connectInterceptors");
+/**
+ * Node.js client for interacting with the meshtrade.iam.group.v1 group v1 API resource service.
+ * Uses Connect-ES with gRPC transport for Node.js gRPC communication.
+ *
+ * Supports three authentication modes:
+ *
+ * 1. **No Authentication** (public APIs):
+ *    ```typescript
+ *    const client = new GroupServiceNode({ apiServerURL: "http://localhost:10000" });
+ *    ```
+ *
+ * 2. **API Key Authentication** (backend services):
+ *    ```typescript
+ *    const client = new GroupServiceNode({
+ *      apiServerURL: "https://api.example.com",
+ *      apiKey: "your-api-key",
+ *      group: "groups/01ARZ3NDEKTSV4YWVF8F5BH32"
+ *    });
+ *    ```
+ *
+ * 3. **JWT Token Authentication** (Next.js backend with user session):
+ *    ```typescript
+ *    const client = new GroupServiceNode({
+ *      apiServerURL: "https://api.example.com",
+ *      jwtToken: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
+ *    });
+ *    ```
+ */
+class GroupServiceNode {
+    /**
+     * Constructs an instance of GroupServiceNode.
+     * @param {ConfigOpts} [config] - Optional configuration for the client.
+     * @param {Interceptor[]} [interceptors] - For internal use by `withGroup`.
+     */
+    constructor(config, interceptors) {
+        this._config = (0, config_1.getConfigFromOpts)(config);
+        // If interceptors are provided (from withGroup), use them
+        // Otherwise, create auth interceptors based on config
+        if (interceptors) {
+            this._interceptors = interceptors;
+        }
+        else {
+            this._interceptors = [];
+            // Add authentication interceptor based on configuration
+            if (this._config.apiKey && this._config.group) {
+                // API Key authentication mode
+                this._interceptors.push((0, connectInterceptors_1.createApiKeyInterceptor)(this._config.apiKey, this._config.group));
+            }
+            else if (this._config.jwtToken) {
+                // JWT authentication mode
+                this._interceptors.push((0, connectInterceptors_1.createJwtInterceptor)(this._config.jwtToken));
+            }
+            // If neither is configured, no authentication (public API mode)
+        }
+        // Create the gRPC transport for Node.js with interceptors
+        // Note: gRPC transport uses HTTP/2 by default
+        const transport = (0, connect_node_1.createGrpcTransport)({
+            baseUrl: this._config.apiServerURL,
+            interceptors: this._interceptors,
+        });
+        // Construct the Connect-ES client
+        this._client = (0, connect_1.createClient)(service_pb_1.GroupService, transport);
+    }
+    /**
+     * Returns a new client instance configured to send the specified group
+     * resource name in the request headers for subsequent API calls.
+     *
+     * **Important**: This method only works with API key authentication.
+     * - For **API key auth**: Creates a new client with updated group context
+     * - For **JWT auth**: Throws error (group comes from JWT token claims)
+     * - For **no auth**: Throws error (group requires authentication)
+     *
+     * @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 {GroupServiceNode} A new, configured instance of the client.
+     * @throws {Error} If used with JWT authentication or no authentication
+     * @throws {Error} If the group format is invalid
+     */
+    withGroup(group) {
+        // Check authentication mode
+        if (this._config.jwtToken) {
+            throw new Error("Cannot use withGroup() with JWT authentication. " +
+                "The group context is determined by the JWT token claims.");
+        }
+        if (!this._config.apiKey) {
+            throw new Error("Cannot use withGroup() without authentication. " +
+                "Please configure API key authentication to use group context.");
+        }
+        // For API key authentication, create new client with updated group
+        // Replace the existing API key interceptor with one that has the new group
+        const newInterceptors = [
+            (0, connectInterceptors_1.createApiKeyInterceptor)(this._config.apiKey, group)
+        ];
+        // Return a new client instance with updated group context
+        return new GroupServiceNode(this._config, newInterceptors);
+    }
+    /**
+     * Creates a new group.
+     * @param {CreateGroupRequest} request - The request object for creategroup.
+     * @returns {Promise<Group>} A promise that resolves with the group.
+     */
+    createGroup(request) {
+        // Validate request
+        (0, validation_1.validateRequest)(request);
+        return this._client.createGroup(request);
+    }
+    /**
+     * Updates an existing group.
+     * @param {UpdateGroupRequest} request - The request object for updategroup.
+     * @returns {Promise<Group>} A promise that resolves with the group.
+     */
+    updateGroup(request) {
+        // Validate request
+        (0, validation_1.validateRequest)(request);
+        return this._client.updateGroup(request);
+    }
+    /**
+     * Retrieves a list of groups.
+     * @param {ListGroupsRequest} request - The request object for listgroups.
+     * @returns {Promise<ListGroupsResponse>} A promise that resolves with the list of groups.
+     */
+    listGroups(request) {
+        // Validate request
+        (0, validation_1.validateRequest)(request);
+        return this._client.listGroups(request);
+    }
+    /**
+     * Searches for groups.
+     * @param {SearchGroupsRequest} request - The request object for searchgroups.
+     * @returns {Promise<SearchGroupsResponse>} A promise that resolves with the search results.
+     */
+    searchGroups(request) {
+        // Validate request
+        (0, validation_1.validateRequest)(request);
+        return this._client.searchGroups(request);
+    }
+    /**
+     * Retrieves a group.
+     * @param {GetGroupRequest} request - The request object for getgroup.
+     * @returns {Promise<Group>} A promise that resolves with the group.
+     */
+    getGroup(request) {
+        // Validate request
+        (0, validation_1.validateRequest)(request);
+        return this._client.getGroup(request);
+    }
+}
+exports.GroupServiceNode = GroupServiceNode;

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

@@ -0,0 +1,306 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2";
+import type { Group, GroupSchema } from "./group_pb";
+import type { SortingOrder } from "../../../type/v1/sorting_pb";
+import type { Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file meshtrade/iam/group/v1/service.proto.
+ */
+export declare const file_meshtrade_iam_group_v1_service: GenFile;
+/**
+ *
+ * Request to create a new group.
+ *
+ * @generated from message meshtrade.iam.group.v1.CreateGroupRequest
+ */
+export type CreateGroupRequest = Message<"meshtrade.iam.group.v1.CreateGroupRequest"> & {
+    /**
+     *
+     * The group configuration for creation.
+     * The name field will be ignored and assigned by the system.
+     *
+     * @generated from field: meshtrade.iam.group.v1.Group group = 1;
+     */
+    group?: Group;
+};
+/**
+ * Describes the message meshtrade.iam.group.v1.CreateGroupRequest.
+ * Use `create(CreateGroupRequestSchema)` to create a new message.
+ */
+export declare const CreateGroupRequestSchema: GenMessage<CreateGroupRequest>;
+/**
+ *
+ * Request to update an existing group.
+ *
+ * @generated from message meshtrade.iam.group.v1.UpdateGroupRequest
+ */
+export type UpdateGroupRequest = Message<"meshtrade.iam.group.v1.UpdateGroupRequest"> & {
+    /**
+     *
+     * Complete group resource with updated fields.
+     * Only display_name and description can be modified.
+     *
+     * @generated from field: meshtrade.iam.group.v1.Group group = 1;
+     */
+    group?: Group;
+};
+/**
+ * Describes the message meshtrade.iam.group.v1.UpdateGroupRequest.
+ * Use `create(UpdateGroupRequestSchema)` to create a new message.
+ */
+export declare const UpdateGroupRequestSchema: GenMessage<UpdateGroupRequest>;
+/**
+ *
+ * Request to list all groups in the hierarchy.
+ *
+ * @generated from message meshtrade.iam.group.v1.ListGroupsRequest
+ */
+export type ListGroupsRequest = Message<"meshtrade.iam.group.v1.ListGroupsRequest"> & {
+    /**
+     *
+     * Optional sorting configuration.
+     *
+     * @generated from field: meshtrade.iam.group.v1.ListGroupsRequest.Sorting sorting = 1;
+     */
+    sorting?: ListGroupsRequest_Sorting;
+};
+/**
+ * Describes the message meshtrade.iam.group.v1.ListGroupsRequest.
+ * Use `create(ListGroupsRequestSchema)` to create a new message.
+ */
+export declare const ListGroupsRequestSchema: GenMessage<ListGroupsRequest>;
+/**
+ *
+ * Sorting configuration for organizing results.
+ *
+ * @generated from message meshtrade.iam.group.v1.ListGroupsRequest.Sorting
+ */
+export type ListGroupsRequest_Sorting = Message<"meshtrade.iam.group.v1.ListGroupsRequest.Sorting"> & {
+    /**
+     *
+     * Field to sort by (e.g., "name", "display_name").
+     *
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     *
+     * Sort order for results.
+     *
+     * @generated from field: meshtrade.type.v1.SortingOrder order = 2;
+     */
+    order: SortingOrder;
+};
+/**
+ * Describes the message meshtrade.iam.group.v1.ListGroupsRequest.Sorting.
+ * Use `create(ListGroupsRequest_SortingSchema)` to create a new message.
+ */
+export declare const ListGroupsRequest_SortingSchema: GenMessage<ListGroupsRequest_Sorting>;
+/**
+ *
+ * Response containing a list of groups.
+ *
+ * @generated from message meshtrade.iam.group.v1.ListGroupsResponse
+ */
+export type ListGroupsResponse = Message<"meshtrade.iam.group.v1.ListGroupsResponse"> & {
+    /**
+     *
+     * Collection of groups in the hierarchy.
+     *
+     * @generated from field: repeated meshtrade.iam.group.v1.Group groups = 1;
+     */
+    groups: Group[];
+};
+/**
+ * Describes the message meshtrade.iam.group.v1.ListGroupsResponse.
+ * Use `create(ListGroupsResponseSchema)` to create a new message.
+ */
+export declare const ListGroupsResponseSchema: GenMessage<ListGroupsResponse>;
+/**
+ *
+ * Request to search groups with filtering criteria.
+ *
+ * @generated from message meshtrade.iam.group.v1.SearchGroupsRequest
+ */
+export type SearchGroupsRequest = Message<"meshtrade.iam.group.v1.SearchGroupsRequest"> & {
+    /**
+     *
+     * Optional substring to search for in group display names.
+     * Case-insensitive partial matching.
+     *
+     * @generated from field: string display_name = 1;
+     */
+    displayName: string;
+    /**
+     *
+     * Optional substring to search for in group descriptions.
+     * Case-insensitive partial matching.
+     *
+     * @generated from field: string description = 2;
+     */
+    description: string;
+    /**
+     *
+     * Optional sorting configuration.
+     *
+     * @generated from field: meshtrade.iam.group.v1.SearchGroupsRequest.Sorting sorting = 3;
+     */
+    sorting?: SearchGroupsRequest_Sorting;
+};
+/**
+ * Describes the message meshtrade.iam.group.v1.SearchGroupsRequest.
+ * Use `create(SearchGroupsRequestSchema)` to create a new message.
+ */
+export declare const SearchGroupsRequestSchema: GenMessage<SearchGroupsRequest>;
+/**
+ *
+ * Sorting configuration for organizing results.
+ *
+ * @generated from message meshtrade.iam.group.v1.SearchGroupsRequest.Sorting
+ */
+export type SearchGroupsRequest_Sorting = Message<"meshtrade.iam.group.v1.SearchGroupsRequest.Sorting"> & {
+    /**
+     *
+     * Field to sort by ("name" or "display_name").
+     *
+     * @generated from field: string field = 1;
+     */
+    field: string;
+    /**
+     *
+     * Sort order for results.
+     *
+     * @generated from field: meshtrade.type.v1.SortingOrder order = 2;
+     */
+    order: SortingOrder;
+};
+/**
+ * Describes the message meshtrade.iam.group.v1.SearchGroupsRequest.Sorting.
+ * Use `create(SearchGroupsRequest_SortingSchema)` to create a new message.
+ */
+export declare const SearchGroupsRequest_SortingSchema: GenMessage<SearchGroupsRequest_Sorting>;
+/**
+ *
+ * Response containing search results.
+ *
+ * @generated from message meshtrade.iam.group.v1.SearchGroupsResponse
+ */
+export type SearchGroupsResponse = Message<"meshtrade.iam.group.v1.SearchGroupsResponse"> & {
+    /**
+     *
+     * Collection of groups matching the search criteria.
+     *
+     * @generated from field: repeated meshtrade.iam.group.v1.Group groups = 1;
+     */
+    groups: Group[];
+};
+/**
+ * Describes the message meshtrade.iam.group.v1.SearchGroupsResponse.
+ * Use `create(SearchGroupsResponseSchema)` to create a new message.
+ */
+export declare const SearchGroupsResponseSchema: GenMessage<SearchGroupsResponse>;
+/**
+ *
+ * Request to retrieve a specific group.
+ *
+ * @generated from message meshtrade.iam.group.v1.GetGroupRequest
+ */
+export type GetGroupRequest = Message<"meshtrade.iam.group.v1.GetGroupRequest"> & {
+    /**
+     *
+     * The resource name of the group to retrieve in format groups/{group_id}.
+     *
+     * @generated from field: string name = 1;
+     */
+    name: string;
+};
+/**
+ * Describes the message meshtrade.iam.group.v1.GetGroupRequest.
+ * Use `create(GetGroupRequestSchema)` to create a new message.
+ */
+export declare const GetGroupRequestSchema: GenMessage<GetGroupRequest>;
+/**
+ *
+ * GroupService manages organizational group hierarchy and lifecycle operations.
+ *
+ * Groups are the fundamental multi-tenancy units in Mesh that own resources,
+ * define permission boundaries, and enable hierarchical access control.
+ * Each group can own sub-groups, users, API users, and platform resources,
+ * forming tree structures for inherited permissions and resource isolation.
+ *
+ * All operations are scoped to the authenticated group's hierarchy and
+ * require appropriate IAM domain permissions.
+ *
+ * @generated from service meshtrade.iam.group.v1.GroupService
+ */
+export declare const GroupService: GenService<{
+    /**
+     *
+     * Creates a new child group within the authenticated group's hierarchy.
+     *
+     * The new group inherits access from its parent and becomes part of the
+     * organizational structure. Group ownership must match the executing context.
+     *
+     * @generated from rpc meshtrade.iam.group.v1.GroupService.CreateGroup
+     */
+    createGroup: {
+        methodKind: "unary";
+        input: typeof CreateGroupRequestSchema;
+        output: typeof GroupSchema;
+    };
+    /**
+     *
+     * Updates an existing group's display name and description metadata.
+     *
+     * Only mutable fields can be modified while preserving the group's
+     * identity and ownership within the hierarchy.
+     *
+     * @generated from rpc meshtrade.iam.group.v1.GroupService.UpdateGroup
+     */
+    updateGroup: {
+        methodKind: "unary";
+        input: typeof UpdateGroupRequestSchema;
+        output: typeof GroupSchema;
+    };
+    /**
+     *
+     * Retrieves all groups within the authenticated group's hierarchical scope.
+     *
+     * Returns the complete organizational structure accessible to the executing
+     * context, including the root group and all descendant groups.
+     *
+     * @generated from rpc meshtrade.iam.group.v1.GroupService.ListGroups
+     */
+    listGroups: {
+        methodKind: "unary";
+        input: typeof ListGroupsRequestSchema;
+        output: typeof ListGroupsResponseSchema;
+    };
+    /**
+     *
+     * Searches groups using flexible text criteria within the hierarchy.
+     *
+     * Performs case-insensitive substring matching on display names and
+     * descriptions using OR logic across search terms.
+     *
+     * @generated from rpc meshtrade.iam.group.v1.GroupService.SearchGroups
+     */
+    searchGroups: {
+        methodKind: "unary";
+        input: typeof SearchGroupsRequestSchema;
+        output: typeof SearchGroupsResponseSchema;
+    };
+    /**
+     *
+     * Retrieves a specific group by its resource identifier within the hierarchy.
+     *
+     * Provides access to a single group's complete metadata and organizational
+     * context if accessible within the executing group's scope.
+     *
+     * @generated from rpc meshtrade.iam.group.v1.GroupService.GetGroup
+     */
+    getGroup: {
+        methodKind: "unary";
+        input: typeof GetGroupRequestSchema;
+        output: typeof GroupSchema;
+    };
+}>;