@meshtrade/api-node 1.30.0

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

@@ -0,0 +1,75 @@
+"use strict";
+// @generated by protoc-gen-es v2.10.1 with parameter "target=ts"
+// @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.GroupService = exports.GetGroupRequestSchema = exports.SearchGroupsResponseSchema = exports.SearchGroupsRequest_SortingSchema = exports.SearchGroupsRequestSchema = exports.ListGroupsResponseSchema = exports.ListGroupsRequest_SortingSchema = exports.ListGroupsRequestSchema = exports.UpdateGroupRequestSchema = exports.CreateGroupRequestSchema = exports.file_meshtrade_iam_group_v1_service = void 0;
+const codegenv2_1 = require("@bufbuild/protobuf/codegenv2");
+const validate_pb_1 = require("../../../../buf/validate/validate_pb");
+const group_pb_1 = require("./group_pb");
+const method_options_pb_1 = require("../../../option/method_options/v1/method_options_pb");
+const sorting_pb_1 = require("../../../type/v1/sorting_pb");
+/**
+ * Describes the file meshtrade/iam/group/v1/service.proto.
+ */
+exports.file_meshtrade_iam_group_v1_service = (0, codegenv2_1.fileDesc)("CiRtZXNodHJhZGUvaWFtL2dyb3VwL3YxL3NlcnZpY2UucHJvdG8SFm1lc2h0cmFkZS5pYW0uZ3JvdXAudjEiSgoSQ3JlYXRlR3JvdXBSZXF1ZXN0EjQKBWdyb3VwGAEgASgLMh0ubWVzaHRyYWRlLmlhbS5ncm91cC52MS5Hcm91cEIGukgDyAEBIkoKElVwZGF0ZUdyb3VwUmVxdWVzdBI0CgVncm91cBgBIAEoCzIdLm1lc2h0cmFkZS5pYW0uZ3JvdXAudjEuR3JvdXBCBrpIA8gBASKsAgoRTGlzdEdyb3Vwc1JlcXVlc3QSQgoHc29ydGluZxgBIAEoCzIxLm1lc2h0cmFkZS5pYW0uZ3JvdXAudjEuTGlzdEdyb3Vwc1JlcXVlc3QuU29ydGluZxrSAQoHU29ydGluZxKWAQoFZmllbGQYASABKAlChgG6SIIBugFnCgtmaWVsZC52YWxpZBIyZmllbGQgbXVzdCBiZSBvbmUgb2Y6IG5hbWUsIGRpc3BsYXlfbmFtZSwgb3IgZW1wdHkaJHRoaXMgaW4gWycnLCAnbmFtZScsICdkaXNwbGF5X25hbWUnXXIWUgBSBG5hbWVSDGRpc3BsYXlfbmFtZRIuCgVvcmRlchgCIAEoDjIfLm1lc2h0cmFkZS50eXBlLnYxLlNvcnRpbmdPcmRlciJDChJMaXN0R3JvdXBzUmVzcG9uc2USLQoGZ3JvdXBzGAEgAygLMh0ubWVzaHRyYWRlLmlhbS5ncm91cC52MS5Hcm91cCK/BAoTU2VhcmNoR3JvdXBzUmVxdWVzdBKGAQoMZGlzcGxheV9uYW1lGAEgASgJQnC6SG26AWUKF2Rpc3BsYXlfbmFtZS5tYXhfbGVuZ3RoEjdkaXNwbGF5X25hbWUgc2VhcmNoIHRlcm0gbXVzdCBub3QgZXhjZWVkIDI1NSBjaGFyYWN0ZXJzGhFzaXplKHRoaXMpIDw9IDI1NXIDGP8BEoMBCgtkZXNjcmlwdGlvbhgCIAEoCUJuukhrugFjChZkZXNjcmlwdGlvbi5tYXhfbGVuZ3RoEjZkZXNjcmlwdGlvbiBzZWFyY2ggdGVybSBtdXN0IG5vdCBleGNlZWQgMjU1IGNoYXJhY3RlcnMaEXNpemUodGhpcykgPD0gMjU1cgMY/wESRAoHc29ydGluZxgDIAEoCzIzLm1lc2h0cmFkZS5pYW0uZ3JvdXAudjEuU2VhcmNoR3JvdXBzUmVxdWVzdC5Tb3J0aW5nGtIBCgdTb3J0aW5nEpYBCgVmaWVsZBgBIAEoCUKGAbpIggG6AWcKC2ZpZWxkLnZhbGlkEjJmaWVsZCBtdXN0IGJlIG9uZSBvZjogbmFtZSwgZGlzcGxheV9uYW1lLCBvciBlbXB0eRokdGhpcyBpbiBbJycsICduYW1lJywgJ2Rpc3BsYXlfbmFtZSddchZSAFIEbmFtZVIMZGlzcGxheV9uYW1lEi4KBW9yZGVyGAIgASgOMh8ubWVzaHRyYWRlLnR5cGUudjEuU29ydGluZ09yZGVyIkUKFFNlYXJjaEdyb3Vwc1Jlc3BvbnNlEi0KBmdyb3VwcxgBIAMoCzIdLm1lc2h0cmFkZS5pYW0uZ3JvdXAudjEuR3JvdXAi8AIKD0dldEdyb3VwUmVxdWVzdBLcAgoEbmFtZRgBIAEoCULNArpIyQK6AVcKDW5hbWUucmVxdWlyZWQSNm5hbWUgaXMgcmVxdWlyZWQgYW5kIG11c3QgYmUgaW4gZm9ybWF0IGdyb3Vwcy97VUxJRHYyfRoOc2l6ZSh0aGlzKSA+IDC6AbMBCgtuYW1lLmZvcm1hdBJjbmFtZSBtdXN0IGJlIGluIGZvcm1hdCBncm91cHMve1VMSUR2Mn0gd2hlcmUgdWxpZHYyIGlzIGV4YWN0bHkgMjYgdXBwZXJjYXNlIGFscGhhbnVtZXJpYyBjaGFyYWN0ZXJzGj90aGlzLm1hdGNoZXMoJ15ncm91cHMvWzAxMjM0NTY3ODlBQkNERUZHSEpLTU5QUVJTVFZXWFlaXXsyNn0kJynIAQFyMxABMi9eZ3JvdXBzL1swMTIzNDU2Nzg5QUJDREVGR0hKS01OUFFSU1RWV1hZWl17MjZ9JDLjBAoMR3JvdXBTZXJ2aWNlEmwKC0NyZWF0ZUdyb3VwEioubWVzaHRyYWRlLmlhbS5ncm91cC52MS5DcmVhdGVHcm91cFJlcXVlc3QaHS5tZXNodHJhZGUuaWFtLmdyb3VwLnYxLkdyb3VwIhKytRgOCAIQAhoIwI23AcSNtwESbAoLVXBkYXRlR3JvdXASKi5tZXNodHJhZGUuaWFtLmdyb3VwLnYxLlVwZGF0ZUdyb3VwUmVxdWVzdBodLm1lc2h0cmFkZS5pYW0uZ3JvdXAudjEuR3JvdXAiErK1GA4IAhACGgjAjbcBxI23ARJ/CgpMaXN0R3JvdXBzEikubWVzaHRyYWRlLmlhbS5ncm91cC52MS5MaXN0R3JvdXBzUmVxdWVzdBoqLm1lc2h0cmFkZS5pYW0uZ3JvdXAudjEuTGlzdEdyb3Vwc1Jlc3BvbnNlIhqytRgWCAEQAhoQwI23AcGNtwHEjbcBxY23ARKFAQoMU2VhcmNoR3JvdXBzEisubWVzaHRyYWRlLmlhbS5ncm91cC52MS5TZWFyY2hHcm91cHNSZXF1ZXN0GiwubWVzaHRyYWRlLmlhbS5ncm91cC52MS5TZWFyY2hHcm91cHNSZXNwb25zZSIasrUYFggBEAIaEMCNtwHBjbcBxI23AcWNtwESbgoIR2V0R3JvdXASJy5tZXNodHJhZGUuaWFtLmdyb3VwLnYxLkdldEdyb3VwUmVxdWVzdBodLm1lc2h0cmFkZS5pYW0uZ3JvdXAudjEuR3JvdXAiGrK1GBYIARACGhDAjbcBwY23AcSNtwHFjbcBQlIKHWNvLm1lc2h0cmFkZS5hcGkuaWFtLmdyb3VwLnYxWjFnaXRodWIuY29tL21lc2h0cmFkZS9hcGkvZ28vaWFtL2dyb3VwL3YxO2dyb3VwX3YxYgZwcm90bzM", [validate_pb_1.file_buf_validate_validate, group_pb_1.file_meshtrade_iam_group_v1_group, method_options_pb_1.file_meshtrade_option_method_options_v1_method_options, sorting_pb_1.file_meshtrade_type_v1_sorting]);
+/**
+ * Describes the message meshtrade.iam.group.v1.CreateGroupRequest.
+ * Use `create(CreateGroupRequestSchema)` to create a new message.
+ */
+exports.CreateGroupRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_group_v1_service, 0);
+/**
+ * Describes the message meshtrade.iam.group.v1.UpdateGroupRequest.
+ * Use `create(UpdateGroupRequestSchema)` to create a new message.
+ */
+exports.UpdateGroupRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_group_v1_service, 1);
+/**
+ * Describes the message meshtrade.iam.group.v1.ListGroupsRequest.
+ * Use `create(ListGroupsRequestSchema)` to create a new message.
+ */
+exports.ListGroupsRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_group_v1_service, 2);
+/**
+ * Describes the message meshtrade.iam.group.v1.ListGroupsRequest.Sorting.
+ * Use `create(ListGroupsRequest_SortingSchema)` to create a new message.
+ */
+exports.ListGroupsRequest_SortingSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_group_v1_service, 2, 0);
+/**
+ * Describes the message meshtrade.iam.group.v1.ListGroupsResponse.
+ * Use `create(ListGroupsResponseSchema)` to create a new message.
+ */
+exports.ListGroupsResponseSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_group_v1_service, 3);
+/**
+ * Describes the message meshtrade.iam.group.v1.SearchGroupsRequest.
+ * Use `create(SearchGroupsRequestSchema)` to create a new message.
+ */
+exports.SearchGroupsRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_group_v1_service, 4);
+/**
+ * Describes the message meshtrade.iam.group.v1.SearchGroupsRequest.Sorting.
+ * Use `create(SearchGroupsRequest_SortingSchema)` to create a new message.
+ */
+exports.SearchGroupsRequest_SortingSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_group_v1_service, 4, 0);
+/**
+ * Describes the message meshtrade.iam.group.v1.SearchGroupsResponse.
+ * Use `create(SearchGroupsResponseSchema)` to create a new message.
+ */
+exports.SearchGroupsResponseSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_group_v1_service, 5);
+/**
+ * Describes the message meshtrade.iam.group.v1.GetGroupRequest.
+ * Use `create(GetGroupRequestSchema)` to create a new message.
+ */
+exports.GetGroupRequestSchema = (0, codegenv2_1.messageDesc)(exports.file_meshtrade_iam_group_v1_service, 6);
+/**
+ *
+ * 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
+ */
+exports.GroupService = (0, codegenv2_1.serviceDesc)(exports.file_meshtrade_iam_group_v1_service, 0);

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

@@ -0,0 +1,2 @@
+export * from "./role_pb";
+export * from "./role";

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

@@ -0,0 +1,43 @@
+"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("./role_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";
+// ===================================================================
+__exportStar(require("./role"), exports);

package/dist/meshtrade/iam/role/v1/role.d.ts

@@ -0,0 +1,71 @@
+import { Role } from "./role_pb";
+export declare const allRoles: Role[];
+/**
+ * Converts a Role enum instance to a custom string representation.
+ * @param {Role} role - The role to convert.
+ * @returns {string} The custom string representation of the role.
+ */
+export declare function roleToString(role: Role): string;
+/**
+ * Converts a custom string representation to a Role enum instance.
+ * @param {string} roleStr - The custom string representation of the role.
+ * @returns {Role} The corresponding Role enum instance.
+ */
+export declare function stringToRole(roleStr: string): Role;
+/**
+ * Creates a role path resource name from a group ULID and role ID.
+ * @param {string} groupULID - The group ULID (26 characters).
+ * @param {number} roleId - The role ID enum value.
+ * @returns {string} The role path in format groups/{ULIDv2}/roles/{role_id}.
+ * @throws {Error} If the group ULID is invalid.
+ * @throws {Error} If the role ID is invalid.
+ *
+ * @example
+ * ```typescript
+ * createRolePath('01ARZ3NDEKTSV4YWVF8F5BH32', Role.ROLE_IAM_ADMIN);
+ * // Returns: 'groups/01ARZ3NDEKTSV4YWVF8F5BH32/roles/1000000'
+ * ```
+ */
+export declare function createRolePath(groupULID: string, roleId: number): string;
+/**
+ * Validates whether a role path is in the correct format.
+ * @param {string} rolePath - The role path to validate.
+ * @returns {boolean} True if the role path is valid, false otherwise.
+ *
+ * @example
+ * ```typescript
+ * isValidRolePath('groups/01ARZ3NDEKTSV4YWVF8F5BH32Q/roles/1000000'); // true
+ * isValidRolePath('groups/01ARZ3NDEKTSV4YWVF8F5BH32Q/1000000'); // false (old format)
+ * ```
+ */
+export declare function isValidRolePath(rolePath: string): boolean;
+/**
+ * Extracts the role ID from a role path.
+ * @param {string} rolePath - The role path in format groups/{ULIDv2}/roles/{role_id}.
+ * @returns {number | null} The role ID if valid, null otherwise.
+ *
+ * @example
+ * ```typescript
+ * extractRoleIdFromPath('groups/01ARZ3NDEKTSV4YWVF8F5BH32/roles/1000000');
+ * // Returns: 1000000
+ *
+ * extractRoleIdFromPath('invalid/path');
+ * // Returns: null
+ * ```
+ */
+export declare function extractRoleIdFromPath(rolePath: string): number | null;
+/**
+ * Extracts the group resource name from a role path.
+ * @param {string} rolePath - The role path in format groups/{ULIDv2}/roles/{role_id}.
+ * @returns {string | null} The group resource name (groups/{ULIDv2}) if valid, null otherwise.
+ *
+ * @example
+ * ```typescript
+ * extractGroupFromRolePath('groups/01ARZ3NDEKTSV4YWVF8F5BH32/roles/1000000');
+ * // Returns: 'groups/01ARZ3NDEKTSV4YWVF8F5BH32'
+ *
+ * extractGroupFromRolePath('invalid/path');
+ * // Returns: null
+ * ```
+ */
+export declare function extractGroupFromRolePath(rolePath: string): string | null;

package/dist/meshtrade/iam/role/v1/role.js

@@ -0,0 +1,192 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allRoles = void 0;
+exports.roleToString = roleToString;
+exports.stringToRole = stringToRole;
+exports.createRolePath = createRolePath;
+exports.isValidRolePath = isValidRolePath;
+exports.extractRoleIdFromPath = extractRoleIdFromPath;
+exports.extractGroupFromRolePath = extractGroupFromRolePath;
+const role_pb_1 = require("./role_pb");
+// Get all roles as enum values
+exports.allRoles = Object.values(role_pb_1.Role).filter((value) => typeof value === "number");
+// Define explicit mappings between Role enums and custom string representations
+const roleToStringMapping = {
+    [role_pb_1.Role.UNSPECIFIED]: "Unspecified",
+    [role_pb_1.Role.WALLET_ADMIN]: "Wallet Admin",
+    [role_pb_1.Role.WALLET_VIEWER]: "Wallet Viewer",
+    [role_pb_1.Role.WALLET_ACCOUNT_ADMIN]: "Wallet Account Admin",
+    [role_pb_1.Role.WALLET_ACCOUNT_VIEWER]: "Wallet Account Viewer",
+    [role_pb_1.Role.COMPLIANCE_ADMIN]: "Compliance Admin",
+    [role_pb_1.Role.COMPLIANCE_VIEWER]: "Compliance Viewer",
+    [role_pb_1.Role.COMPLIANCE_CLIENT_ADMIN]: "Compliance Client Admin",
+    [role_pb_1.Role.COMPLIANCE_CLIENT_VIEWER]: "Compliance Client Viewer",
+    [role_pb_1.Role.IAM_ADMIN]: "IAM Admin",
+    [role_pb_1.Role.IAM_VIEWER]: "IAM Viewer",
+    [role_pb_1.Role.IAM_API_USER_ADMIN]: "IAM API User Admin",
+    [role_pb_1.Role.IAM_API_USER_VIEWER]: "IAM API User Viewer",
+    [role_pb_1.Role.IAM_GROUP_ADMIN]: "IAM Group Admin",
+    [role_pb_1.Role.IAM_GROUP_VIEWER]: "IAM Group Viewer",
+    [role_pb_1.Role.IAM_USER_ADMIN]: "IAM User Admin",
+    [role_pb_1.Role.IAM_USER_VIEWER]: "IAM User Viewer",
+    [role_pb_1.Role.STUDIO_ADMIN]: "Studio Admin",
+    [role_pb_1.Role.STUDIO_VIEWER]: "Studio Viewer",
+    [role_pb_1.Role.STUDIO_INSTRUMENT_ADMIN]: "Studio Instrument Admin",
+    [role_pb_1.Role.STUDIO_INSTRUMENT_VIEWER]: "Studio Instrument Viewer",
+    [role_pb_1.Role.TRADING_ADMIN]: "Trading Admin",
+    [role_pb_1.Role.TRADING_VIEWER]: "Trading Viewer",
+    [role_pb_1.Role.TRADING_LIMIT_ORDER_ADMIN]: "Trading Limit Order Admin",
+    [role_pb_1.Role.TRADING_LIMIT_ORDER_VIEWER]: "Trading Limit Order Viewer",
+    [role_pb_1.Role.REPORTING_ADMIN]: "Reporting Admin",
+    [role_pb_1.Role.REPORTING_VIEWER]: "Reporting Viewer",
+    [role_pb_1.Role.LEDGER_ADMIN]: "Ledger Admin",
+    [role_pb_1.Role.LEDGER_VIEWER]: "Ledger Viewer",
+    [role_pb_1.Role.LEDGER_TRANSACTION_ADMIN]: "Ledger Transaction Admin",
+    [role_pb_1.Role.LEDGER_TRANSACTION_VIEWER]: "Ledger Transaction Viewer",
+    [role_pb_1.Role.MARKET_DATA_ADMIN]: "Market Data Admin",
+    [role_pb_1.Role.MARKET_DATA_VIEWER]: "Market Data Viewer",
+    [role_pb_1.Role.MARKET_DATA_PRICE_ADMIN]: "Market Data Price Admin",
+    [role_pb_1.Role.MARKET_DATA_PRICE_VIEWER]: "Market Data Price Viewer",
+};
+// Reverse mapping from string to Role enum
+const stringToRoleMapping = {};
+for (const [key, value] of Object.entries(roleToStringMapping)) {
+    stringToRoleMapping[value] = Number(key);
+}
+class UnsupportedRoleError extends Error {
+    constructor(role) {
+        const message = `Unsupported Role: ${role}`;
+        super(message);
+        this.role = role;
+    }
+}
+/**
+ * Converts a Role enum instance to a custom string representation.
+ * @param {Role} role - The role to convert.
+ * @returns {string} The custom string representation of the role.
+ */
+function roleToString(role) {
+    if (role in roleToStringMapping) {
+        return roleToStringMapping[role];
+    }
+    else {
+        throw new UnsupportedRoleError(role);
+    }
+}
+class UnsupportedRoleStringError extends Error {
+    constructor(roleStr) {
+        const message = `Unsupported role string: ${roleStr}`;
+        super(message);
+        this.roleStr = roleStr;
+    }
+}
+/**
+ * Converts a custom string representation to a Role enum instance.
+ * @param {string} roleStr - The custom string representation of the role.
+ * @returns {Role} The corresponding Role enum instance.
+ */
+function stringToRole(roleStr) {
+    if (roleStr in stringToRoleMapping) {
+        return stringToRoleMapping[roleStr];
+    }
+    else {
+        throw new UnsupportedRoleStringError(roleStr);
+    }
+}
+/**
+ * Validates whether a ULID string is in the correct format.
+ * ULIDs use Crockford's base32 alphabet (0-9, A-Z excluding I, L, O, U) and are 26 characters long.
+ * @param {string} ulid - The ULID to validate.
+ * @returns {boolean} True if the ULID is valid, false otherwise.
+ */
+function isValidULID(ulid) {
+    return /^[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}$/.test(ulid);
+}
+/**
+ * Validates whether a role ID is in the valid range.
+ * Role IDs must be 7 or 8 digits and cannot start with 0.
+ * @param {number} roleId - The role ID to validate.
+ * @returns {boolean} True if the role ID is valid, false otherwise.
+ */
+function isValidRoleId(roleId) {
+    return roleId >= 1000000 && roleId <= 99999999;
+}
+/**
+ * Creates a role path resource name from a group ULID and role ID.
+ * @param {string} groupULID - The group ULID (26 characters).
+ * @param {number} roleId - The role ID enum value.
+ * @returns {string} The role path in format groups/{ULIDv2}/roles/{role_id}.
+ * @throws {Error} If the group ULID is invalid.
+ * @throws {Error} If the role ID is invalid.
+ *
+ * @example
+ * ```typescript
+ * createRolePath('01ARZ3NDEKTSV4YWVF8F5BH32', Role.ROLE_IAM_ADMIN);
+ * // Returns: 'groups/01ARZ3NDEKTSV4YWVF8F5BH32/roles/1000000'
+ * ```
+ */
+function createRolePath(groupULID, roleId) {
+    if (!isValidULID(groupULID)) {
+        throw new Error(`Invalid group ULID: ${groupULID}. Must be 26 uppercase alphanumeric characters.`);
+    }
+    if (!isValidRoleId(roleId)) {
+        throw new Error(`Invalid role ID: ${roleId}. Must be between 1000000 and 99999999.`);
+    }
+    return `groups/${groupULID}/roles/${roleId}`;
+}
+/**
+ * Validates whether a role path is in the correct format.
+ * @param {string} rolePath - The role path to validate.
+ * @returns {boolean} True if the role path is valid, false otherwise.
+ *
+ * @example
+ * ```typescript
+ * isValidRolePath('groups/01ARZ3NDEKTSV4YWVF8F5BH32Q/roles/1000000'); // true
+ * isValidRolePath('groups/01ARZ3NDEKTSV4YWVF8F5BH32Q/1000000'); // false (old format)
+ * ```
+ */
+function isValidRolePath(rolePath) {
+    return /^groups\/[0123456789ABCDEFGHJKMNPQRSTVWXYZ]{26}\/roles\/[1-9][0-9]{6,7}$/.test(rolePath);
+}
+/**
+ * Extracts the role ID from a role path.
+ * @param {string} rolePath - The role path in format groups/{ULIDv2}/roles/{role_id}.
+ * @returns {number | null} The role ID if valid, null otherwise.
+ *
+ * @example
+ * ```typescript
+ * extractRoleIdFromPath('groups/01ARZ3NDEKTSV4YWVF8F5BH32/roles/1000000');
+ * // Returns: 1000000
+ *
+ * extractRoleIdFromPath('invalid/path');
+ * // Returns: null
+ * ```
+ */
+function extractRoleIdFromPath(rolePath) {
+    if (!isValidRolePath(rolePath)) {
+        return null;
+    }
+    const parts = rolePath.split("/");
+    return parseInt(parts[3], 10);
+}
+/**
+ * Extracts the group resource name from a role path.
+ * @param {string} rolePath - The role path in format groups/{ULIDv2}/roles/{role_id}.
+ * @returns {string | null} The group resource name (groups/{ULIDv2}) if valid, null otherwise.
+ *
+ * @example
+ * ```typescript
+ * extractGroupFromRolePath('groups/01ARZ3NDEKTSV4YWVF8F5BH32/roles/1000000');
+ * // Returns: 'groups/01ARZ3NDEKTSV4YWVF8F5BH32'
+ *
+ * extractGroupFromRolePath('invalid/path');
+ * // Returns: null
+ * ```
+ */
+function extractGroupFromRolePath(rolePath) {
+    if (!isValidRolePath(rolePath)) {
+        return null;
+    }
+    const parts = rolePath.split("/");
+    return `${parts[0]}/${parts[1]}`;
+}

package/dist/meshtrade/iam/role/v1/role_pb.d.ts

@@ -0,0 +1,164 @@
+import type { GenEnum, GenFile } from "@bufbuild/protobuf/codegenv2";
+/**
+ * Describes the file meshtrade/iam/role/v1/role.proto.
+ */
+export declare const file_meshtrade_iam_role_v1_role: GenFile;
+/**
+ *
+ * Role defines a named collection of permissions.
+ * This allows for the creation of business-level roles (e.g., "AccountReader", "AccountAdmin")
+ * that group a set of granular, string-based permissions. Roles are
+ * defined at the file level in a service's `.proto` file.
+ *
+ * @generated from enum meshtrade.iam.role.v1.Role
+ */
+export declare enum Role {
+    /**
+     *
+     * The default value, indicating the role is unknown or not specified.
+     * This should be treated as an error and not be used explicitly.
+     *
+     * @generated from enum value: ROLE_UNSPECIFIED = 0;
+     */
+    UNSPECIFIED = 0,
+    /**
+     * @generated from enum value: ROLE_WALLET_ADMIN = 1000000;
+     */
+    WALLET_ADMIN = 1000000,
+    /**
+     * @generated from enum value: ROLE_WALLET_VIEWER = 1000001;
+     */
+    WALLET_VIEWER = 1000001,
+    /**
+     * @generated from enum value: ROLE_WALLET_ACCOUNT_ADMIN = 1000002;
+     */
+    WALLET_ACCOUNT_ADMIN = 1000002,
+    /**
+     * @generated from enum value: ROLE_WALLET_ACCOUNT_VIEWER = 1000003;
+     */
+    WALLET_ACCOUNT_VIEWER = 1000003,
+    /**
+     * @generated from enum value: ROLE_COMPLIANCE_ADMIN = 2000000;
+     */
+    COMPLIANCE_ADMIN = 2000000,
+    /**
+     * @generated from enum value: ROLE_COMPLIANCE_VIEWER = 2000001;
+     */
+    COMPLIANCE_VIEWER = 2000001,
+    /**
+     * @generated from enum value: ROLE_COMPLIANCE_CLIENT_ADMIN = 2000002;
+     */
+    COMPLIANCE_CLIENT_ADMIN = 2000002,
+    /**
+     * @generated from enum value: ROLE_COMPLIANCE_CLIENT_VIEWER = 2000003;
+     */
+    COMPLIANCE_CLIENT_VIEWER = 2000003,
+    /**
+     * @generated from enum value: ROLE_IAM_ADMIN = 3000000;
+     */
+    IAM_ADMIN = 3000000,
+    /**
+     * @generated from enum value: ROLE_IAM_VIEWER = 3000001;
+     */
+    IAM_VIEWER = 3000001,
+    /**
+     * @generated from enum value: ROLE_IAM_API_USER_ADMIN = 3000002;
+     */
+    IAM_API_USER_ADMIN = 3000002,
+    /**
+     * @generated from enum value: ROLE_IAM_API_USER_VIEWER = 3000003;
+     */
+    IAM_API_USER_VIEWER = 3000003,
+    /**
+     * @generated from enum value: ROLE_IAM_GROUP_ADMIN = 3000004;
+     */
+    IAM_GROUP_ADMIN = 3000004,
+    /**
+     * @generated from enum value: ROLE_IAM_GROUP_VIEWER = 3000005;
+     */
+    IAM_GROUP_VIEWER = 3000005,
+    /**
+     * @generated from enum value: ROLE_IAM_USER_ADMIN = 3000006;
+     */
+    IAM_USER_ADMIN = 3000006,
+    /**
+     * @generated from enum value: ROLE_IAM_USER_VIEWER = 3000007;
+     */
+    IAM_USER_VIEWER = 3000007,
+    /**
+     * @generated from enum value: ROLE_STUDIO_ADMIN = 4000000;
+     */
+    STUDIO_ADMIN = 4000000,
+    /**
+     * @generated from enum value: ROLE_STUDIO_VIEWER = 4000001;
+     */
+    STUDIO_VIEWER = 4000001,
+    /**
+     * @generated from enum value: ROLE_STUDIO_INSTRUMENT_ADMIN = 4000002;
+     */
+    STUDIO_INSTRUMENT_ADMIN = 4000002,
+    /**
+     * @generated from enum value: ROLE_STUDIO_INSTRUMENT_VIEWER = 4000003;
+     */
+    STUDIO_INSTRUMENT_VIEWER = 4000003,
+    /**
+     * @generated from enum value: ROLE_TRADING_ADMIN = 5000000;
+     */
+    TRADING_ADMIN = 5000000,
+    /**
+     * @generated from enum value: ROLE_TRADING_VIEWER = 5000001;
+     */
+    TRADING_VIEWER = 5000001,
+    /**
+     * @generated from enum value: ROLE_TRADING_LIMIT_ORDER_ADMIN = 5000002;
+     */
+    TRADING_LIMIT_ORDER_ADMIN = 5000002,
+    /**
+     * @generated from enum value: ROLE_TRADING_LIMIT_ORDER_VIEWER = 5000003;
+     */
+    TRADING_LIMIT_ORDER_VIEWER = 5000003,
+    /**
+     * @generated from enum value: ROLE_REPORTING_ADMIN = 6000000;
+     */
+    REPORTING_ADMIN = 6000000,
+    /**
+     * @generated from enum value: ROLE_REPORTING_VIEWER = 6000001;
+     */
+    REPORTING_VIEWER = 6000001,
+    /**
+     * @generated from enum value: ROLE_LEDGER_ADMIN = 7000000;
+     */
+    LEDGER_ADMIN = 7000000,
+    /**
+     * @generated from enum value: ROLE_LEDGER_VIEWER = 7000001;
+     */
+    LEDGER_VIEWER = 7000001,
+    /**
+     * @generated from enum value: ROLE_LEDGER_TRANSACTION_ADMIN = 7000002;
+     */
+    LEDGER_TRANSACTION_ADMIN = 7000002,
+    /**
+     * @generated from enum value: ROLE_LEDGER_TRANSACTION_VIEWER = 7000003;
+     */
+    LEDGER_TRANSACTION_VIEWER = 7000003,
+    /**
+     * @generated from enum value: ROLE_MARKET_DATA_ADMIN = 8000000;
+     */
+    MARKET_DATA_ADMIN = 8000000,
+    /**
+     * @generated from enum value: ROLE_MARKET_DATA_VIEWER = 8000001;
+     */
+    MARKET_DATA_VIEWER = 8000001,
+    /**
+     * @generated from enum value: ROLE_MARKET_DATA_PRICE_ADMIN = 8000002;
+     */
+    MARKET_DATA_PRICE_ADMIN = 8000002,
+    /**
+     * @generated from enum value: ROLE_MARKET_DATA_PRICE_VIEWER = 8000003;
+     */
+    MARKET_DATA_PRICE_VIEWER = 8000003
+}
+/**
+ * Describes the enum meshtrade.iam.role.v1.Role.
+ */
+export declare const RoleSchema: GenEnum<Role>;