auth0 6.1.0 → 6.2.0

package/dist/cjs/management/api/resources/organizations/resources/members/client/Client.d.ts

@@ -21,7 +21,7 @@ export declare class MembersClient {
      * This endpoint is subject to eventual consistency. New users may not be immediately included in the response and deleted users may not be immediately removed from it.
      *
      * - Use the `fields` parameter to optionally define the specific member details retrieved. If `fields` is left blank, all fields (except roles) are returned.
-     * - Member roles are not sent by default. Use `fields=roles` to retrieve the roles assigned to each listed member. To use this parameter, you must include the `read:organization_member_roles` scope in the token.
+     * - Member roles are not sent by default. Use `fields=roles` to retrieve the roles assigned to each listed member. To use this parameter, you must include the `read:organization_member_roles` scope in the token. Only directly assigned roles are returned. To also include group-based role assignments, use `GET /api/v2/organizations/{id}/members/{user_id}/effective-roles`.
      *
      * This endpoint supports two types of pagination:
      *
@@ -46,6 +46,7 @@ export declare class MembersClient {
      *
      * @example
      *     await client.organizations.members.list("id", {
+     *         include_totals: true,
      *         from: "from",
      *         take: 1,
      *         fields: "fields",

package/dist/cjs/management/api/resources/organizations/resources/members/client/Client.js

@@ -70,7 +70,7 @@ class MembersClient {
      * This endpoint is subject to eventual consistency. New users may not be immediately included in the response and deleted users may not be immediately removed from it.
      *
      * - Use the `fields` parameter to optionally define the specific member details retrieved. If `fields` is left blank, all fields (except roles) are returned.
-     * - Member roles are not sent by default. Use `fields=roles` to retrieve the roles assigned to each listed member. To use this parameter, you must include the `read:organization_member_roles` scope in the token.
+     * - Member roles are not sent by default. Use `fields=roles` to retrieve the roles assigned to each listed member. To use this parameter, you must include the `read:organization_member_roles` scope in the token. Only directly assigned roles are returned. To also include group-based role assignments, use `GET /api/v2/organizations/{id}/members/{user_id}/effective-roles`.
      *
      * This endpoint supports two types of pagination:
      *
@@ -95,6 +95,7 @@ class MembersClient {
      *
      * @example
      *     await client.organizations.members.list("id", {
+     *         include_totals: true,
      *         from: "from",
      *         take: 1,
      *         fields: "fields",
@@ -105,8 +106,9 @@ class MembersClient {
         return __awaiter(this, arguments, void 0, function* (id, request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                const { from: from_, take = 50, fields, include_fields: includeFields } = request;
+                const { include_totals: includeTotals = true, from: from_, take = 50, fields, include_fields: includeFields, } = request;
                 const _queryParams = {
+                    include_totals: includeTotals,
                     from: from_,
                     take,
                     fields,

package/dist/cjs/management/api/resources/organizations/resources/members/resources/roles/client/Client.d.ts

@@ -15,6 +15,8 @@ export declare class RolesClient {
      *
      * Users can be members of multiple Organizations with unique roles assigned for each membership. This action only returns the roles associated with the specified Organization; any roles assigned to the user within other Organizations are not included.
      *
+     * **Note**: Returns only direct role assignments for this member. To also include group-based role assignments, use `GET /api/v2/organizations/{id}/members/{user_id}/effective-roles`.
+     *
      * @param {string} id - Organization identifier.
      * @param {string} user_id - ID of the user to associate roles with.
      * @param {Management.ListOrganizationMemberRolesRequestParameters} request

package/dist/cjs/management/api/resources/organizations/resources/members/resources/roles/client/Client.js

@@ -60,6 +60,8 @@ class RolesClient {
      *
      * Users can be members of multiple Organizations with unique roles assigned for each membership. This action only returns the roles associated with the specified Organization; any roles assigned to the user within other Organizations are not included.
      *
+     * **Note**: Returns only direct role assignments for this member. To also include group-based role assignments, use `GET /api/v2/organizations/{id}/members/{user_id}/effective-roles`.
+     *
      * @param {string} id - Organization identifier.
      * @param {string} user_id - ID of the user to associate roles with.
      * @param {Management.ListOrganizationMemberRolesRequestParameters} request

package/dist/cjs/management/api/resources/organizations/resources/roles/client/Client.d.ts

@@ -1,5 +1,6 @@
 import type { BaseClientOptions } from "../../../../../../BaseClient.js";
 import { type NormalizedClientOptionsWithAuth } from "../../../../../../BaseClient.js";
+import { GroupsClient } from "../resources/groups/client/Client.js";
 import { MembersClient } from "../resources/members/client/Client.js";
 export declare namespace RolesClient {
     type Options = BaseClientOptions;
@@ -7,6 +8,8 @@ export declare namespace RolesClient {
 export declare class RolesClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<RolesClient.Options>;
     protected _members: MembersClient | undefined;
+    protected _groups: GroupsClient | undefined;
     constructor(options: RolesClient.Options);
     get members(): MembersClient;
+    get groups(): GroupsClient;
 }

package/dist/cjs/management/api/resources/organizations/resources/roles/client/Client.js

@@ -3,14 +3,19 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RolesClient = void 0;
 const BaseClient_js_1 = require("../../../../../../BaseClient.js");
-const Client_js_1 = require("../resources/members/client/Client.js");
+const Client_js_1 = require("../resources/groups/client/Client.js");
+const Client_js_2 = require("../resources/members/client/Client.js");
 class RolesClient {
     constructor(options) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
     get members() {
         var _a;
-        return ((_a = this._members) !== null && _a !== void 0 ? _a : (this._members = new Client_js_1.MembersClient(this._options)));
+        return ((_a = this._members) !== null && _a !== void 0 ? _a : (this._members = new Client_js_2.MembersClient(this._options)));
+    }
+    get groups() {
+        var _a;
+        return ((_a = this._groups) !== null && _a !== void 0 ? _a : (this._groups = new Client_js_1.GroupsClient(this._options)));
     }
 }
 exports.RolesClient = RolesClient;

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/groups/client/Client.d.ts

@@ -0,0 +1,34 @@
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth } from "../../../../../../../../BaseClient.js";
+import * as core from "../../../../../../../../core/index.js";
+import * as Management from "../../../../../../../index.js";
+export declare namespace GroupsClient {
+    type Options = BaseClientOptions;
+    interface RequestOptions extends BaseRequestOptions {
+    }
+}
+export declare class GroupsClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<GroupsClient.Options>;
+    constructor(options: GroupsClient.Options);
+    /**
+     * Retrieve the list of groups assigned to a role in the context of an organization.
+     *
+     * @param {string} organization_id - ID of the organization.
+     * @param {string} role_id - ID of the role.
+     * @param {Management.ListOrganizationRoleGroupsRequestParameters} request
+     * @param {GroupsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Management.BadRequestError}
+     * @throws {@link Management.UnauthorizedError}
+     * @throws {@link Management.ForbiddenError}
+     * @throws {@link Management.NotFoundError}
+     * @throws {@link Management.TooManyRequestsError}
+     *
+     * @example
+     *     await client.organizations.roles.groups.list("organization_id", "role_id", {
+     *         from: "from",
+     *         take: 1
+     *     })
+     */
+    list(organization_id: string, role_id: string, request?: Management.ListOrganizationRoleGroupsRequestParameters, requestOptions?: GroupsClient.RequestOptions): Promise<core.Page<Management.RoleGroup, Management.ListOrganizationRoleGroupsResponseContent>>;
+}

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/groups/client/Client.js

@@ -0,0 +1,145 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupsClient = void 0;
+const BaseClient_js_1 = require("../../../../../../../../BaseClient.js");
+const core = __importStar(require("../../../../../../../../core/index.js"));
+const headers_js_1 = require("../../../../../../../../core/headers.js");
+const environments = __importStar(require("../../../../../../../../environments.js"));
+const handleNonStatusCodeError_js_1 = require("../../../../../../../../errors/handleNonStatusCodeError.js");
+const errors = __importStar(require("../../../../../../../../errors/index.js"));
+const Management = __importStar(require("../../../../../../../index.js"));
+class GroupsClient {
+    constructor(options) {
+        this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
+    }
+    /**
+     * Retrieve the list of groups assigned to a role in the context of an organization.
+     *
+     * @param {string} organization_id - ID of the organization.
+     * @param {string} role_id - ID of the role.
+     * @param {Management.ListOrganizationRoleGroupsRequestParameters} request
+     * @param {GroupsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link Management.BadRequestError}
+     * @throws {@link Management.UnauthorizedError}
+     * @throws {@link Management.ForbiddenError}
+     * @throws {@link Management.NotFoundError}
+     * @throws {@link Management.TooManyRequestsError}
+     *
+     * @example
+     *     await client.organizations.roles.groups.list("organization_id", "role_id", {
+     *         from: "from",
+     *         take: 1
+     *     })
+     */
+    list(organization_id_1, role_id_1) {
+        return __awaiter(this, arguments, void 0, function* (organization_id, role_id, request = {}, requestOptions) {
+            const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
+                var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+                const { from: from_, take = 50 } = request;
+                const _queryParams = {
+                    from: from_,
+                    take,
+                };
+                const _authRequest = yield this._options.authProvider.getAuthRequest();
+                let _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+                const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                    url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.ManagementEnvironment.Default, `organizations/${core.url.encodePathParam(organization_id)}/roles/${core.url.encodePathParam(role_id)}/groups`),
+                    method: "GET",
+                    headers: _headers,
+                    queryString: core.url
+                        .queryBuilder()
+                        .addMany(_queryParams)
+                        .mergeAdditional(requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams)
+                        .build(),
+                    timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                    maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                    abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                    fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                    logging: this._options.logging,
+                });
+                if (_response.ok) {
+                    return {
+                        data: _response.body,
+                        rawResponse: _response.rawResponse,
+                    };
+                }
+                if (_response.error.reason === "status-code") {
+                    switch (_response.error.statusCode) {
+                        case 400:
+                            throw new Management.BadRequestError(_response.error.body, _response.rawResponse);
+                        case 401:
+                            throw new Management.UnauthorizedError(_response.error.body, _response.rawResponse);
+                        case 403:
+                            throw new Management.ForbiddenError(_response.error.body, _response.rawResponse);
+                        case 404:
+                            throw new Management.NotFoundError(_response.error.body, _response.rawResponse);
+                        case 429:
+                            throw new Management.TooManyRequestsError(_response.error.body, _response.rawResponse);
+                        default:
+                            throw new errors.ManagementError({
+                                statusCode: _response.error.statusCode,
+                                body: _response.error.body,
+                                rawResponse: _response.rawResponse,
+                            });
+                    }
+                }
+                return (0, handleNonStatusCodeError_js_1.handleNonStatusCodeError)(_response.error, _response.rawResponse, "GET", "/organizations/{organization_id}/roles/{role_id}/groups");
+            }));
+            const dataWithRawResponse = yield list(request).withRawResponse();
+            return new core.Page({
+                response: dataWithRawResponse.data,
+                rawResponse: dataWithRawResponse.rawResponse,
+                hasNextPage: (response) => (response === null || response === void 0 ? void 0 : response.next) != null && !(typeof (response === null || response === void 0 ? void 0 : response.next) === "string" && (response === null || response === void 0 ? void 0 : response.next) === ""),
+                getItems: (response) => { var _a; return (_a = response === null || response === void 0 ? void 0 : response.groups) !== null && _a !== void 0 ? _a : []; },
+                loadPage: (response) => {
+                    return list(core.setObjectProperty(request, "from", response === null || response === void 0 ? void 0 : response.next));
+                },
+            });
+        });
+    }
+}
+exports.GroupsClient = GroupsClient;

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/groups/client/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/groups/client/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/groups/exports.d.ts

@@ -0,0 +1,2 @@
+export { GroupsClient } from "./client/Client.js";
+export * from "./client/index.js";

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/groups/exports.js

@@ -0,0 +1,21 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+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 });
+exports.GroupsClient = void 0;
+var Client_js_1 = require("./client/Client.js");
+Object.defineProperty(exports, "GroupsClient", { enumerable: true, get: function () { return Client_js_1.GroupsClient; } });
+__exportStar(require("./client/index.js"), exports);

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/groups/index.d.ts

@@ -0,0 +1 @@
+export * from "./client/index.js";

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/groups/index.js

@@ -0,0 +1,17 @@
+"use strict";
+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 });
+__exportStar(require("./client/index.js"), exports);

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/index.d.ts

@@ -1 +1,2 @@
+export * as groups from "./groups/index.js";
 export * as members from "./members/index.js";

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/index.js

@@ -33,5 +33,6 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.members = void 0;
+exports.members = exports.groups = void 0;
+exports.groups = __importStar(require("./groups/index.js"));
 exports.members = __importStar(require("./members/index.js"));

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/members/client/Client.d.ts

@@ -12,6 +12,11 @@ export declare class MembersClient {
     constructor(options: MembersClient.Options);
     /**
      * List the organization members assigned a specific role within the context of an organization.
+     * <ul>
+     *   <li>
+     *     <b>Note</b>: Returns only members with direct role assignments. For groups assigned to this role within the organization, use <code>GET /api/v2/organizations/{organization_id}/roles/{role_id}/groups</code>.
+     *   </li>
+     * </ul>
      *
      * @param {string} id - ID of the organization.
      * @param {string} role_id - ID of the role to retrieve the assigned members for.

package/dist/cjs/management/api/resources/organizations/resources/roles/resources/members/client/Client.js

@@ -57,6 +57,11 @@ class MembersClient {
     }
     /**
      * List the organization members assigned a specific role within the context of an organization.
+     * <ul>
+     *   <li>
+     *     <b>Note</b>: Returns only members with direct role assignments. For groups assigned to this role within the organization, use <code>GET /api/v2/organizations/{organization_id}/roles/{role_id}/groups</code>.
+     *   </li>
+     * </ul>
      *
      * @param {string} id - ID of the organization.
      * @param {string} role_id - ID of the role to retrieve the assigned members for.

package/dist/cjs/management/api/resources/roles/client/Client.d.ts

@@ -37,7 +37,9 @@ export declare class RolesClient {
      *         per_page: 1,
      *         page: 1,
      *         include_totals: true,
-     *         name_filter: "name_filter"
+     *         name_filter: "name_filter",
+     *         type: "tenant",
+     *         owner_id: "owner_id"
      *     })
      */
     list(request?: Management.ListRolesRequestParameters, requestOptions?: RolesClient.RequestOptions): Promise<core.Page<Management.Role, Management.ListRolesOffsetPaginatedResponseContent>>;

package/dist/cjs/management/api/resources/roles/client/Client.js

@@ -88,19 +88,23 @@ class RolesClient {
      *         per_page: 1,
      *         page: 1,
      *         include_totals: true,
-     *         name_filter: "name_filter"
+     *         name_filter: "name_filter",
+     *         type: "tenant",
+     *         owner_id: "owner_id"
      *     })
      */
     list() {
         return __awaiter(this, arguments, void 0, function* (request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                const { per_page: perPage = 50, page = 0, include_totals: includeTotals = true, name_filter: nameFilter, } = request;
+                const { per_page: perPage = 50, page = 0, include_totals: includeTotals = true, name_filter: nameFilter, type: type_, owner_id: ownerId, } = request;
                 const _queryParams = {
                     per_page: perPage,
                     page,
                     include_totals: includeTotals,
                     name_filter: nameFilter,
+                    type: type_ !== undefined ? type_ : undefined,
+                    owner_id: ownerId,
                 };
                 const _authRequest = yield this._options.authProvider.getAuthRequest();
                 let _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);

package/dist/cjs/management/api/resources/roles/resources/users/client/Client.d.ts

@@ -13,6 +13,8 @@ export declare class UsersClient {
     /**
      * Retrieve list of users associated with a specific role. For Dashboard instructions, review [View Users Assigned to Roles](https://auth0.com/docs/manage-users/access-control/configure-core-rbac/roles/view-users-assigned-to-roles).
      *
+     * **Note**: Returns only users with direct role assignments. For groups assigned to this role, use `GET /api/v2/roles/{id}/groups`.
+     *
      * This endpoint supports two types of pagination:
      *
      * - Offset pagination
@@ -41,6 +43,7 @@ export declare class UsersClient {
      *
      * @example
      *     await client.roles.users.list("id", {
+     *         include_totals: true,
      *         from: "from",
      *         take: 1
      *     })

package/dist/cjs/management/api/resources/roles/resources/users/client/Client.js

@@ -58,6 +58,8 @@ class UsersClient {
     /**
      * Retrieve list of users associated with a specific role. For Dashboard instructions, review [View Users Assigned to Roles](https://auth0.com/docs/manage-users/access-control/configure-core-rbac/roles/view-users-assigned-to-roles).
      *
+     * **Note**: Returns only users with direct role assignments. For groups assigned to this role, use `GET /api/v2/roles/{id}/groups`.
+     *
      * This endpoint supports two types of pagination:
      *
      * - Offset pagination
@@ -86,6 +88,7 @@ class UsersClient {
      *
      * @example
      *     await client.roles.users.list("id", {
+     *         include_totals: true,
      *         from: "from",
      *         take: 1
      *     })
@@ -94,8 +97,9 @@ class UsersClient {
         return __awaiter(this, arguments, void 0, function* (id, request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                const { from: from_, take = 50 } = request;
+                const { include_totals: includeTotals = true, from: from_, take = 50 } = request;
                 const _queryParams = {
+                    include_totals: includeTotals,
                     from: from_,
                     take,
                 };

package/dist/cjs/management/api/resources/users/resources/groups/client/Client.d.ts

@@ -27,6 +27,7 @@ export declare class GroupsClient {
      *     await client.users.groups.get("id", {
      *         fields: "fields",
      *         include_fields: true,
+     *         include_totals: true,
      *         from: "from",
      *         take: 1
      *     })

package/dist/cjs/management/api/resources/users/resources/groups/client/Client.js

@@ -72,6 +72,7 @@ class GroupsClient {
      *     await client.users.groups.get("id", {
      *         fields: "fields",
      *         include_fields: true,
+     *         include_totals: true,
      *         from: "from",
      *         take: 1
      *     })
@@ -80,10 +81,11 @@ class GroupsClient {
         return __awaiter(this, arguments, void 0, function* (id, request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                const { fields, include_fields: includeFields, from: from_, take = 50 } = request;
+                const { fields, include_fields: includeFields, include_totals: includeTotals = true, from: from_, take = 50, } = request;
                 const _queryParams = {
                     fields,
                     include_fields: includeFields,
+                    include_totals: includeTotals,
                     from: from_,
                     take,
                 };

package/dist/cjs/management/api/resources/users/resources/permissions/client/Client.d.ts

@@ -13,6 +13,8 @@ export declare class PermissionsClient {
     /**
      * Retrieve all permissions associated with the user.
      *
+     * **Note**: Returns only permissions from direct assignments and directly assigned roles. For permissions a user has via group-based role assignments, use `GET /api/v2/users/{id}/effective-permissions`.
+     *
      * @param {string} id - ID of the user to retrieve the permissions for.
      * @param {Management.ListUserPermissionsRequestParameters} request
      * @param {PermissionsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/management/api/resources/users/resources/permissions/client/Client.js

@@ -58,6 +58,8 @@ class PermissionsClient {
     /**
      * Retrieve all permissions associated with the user.
      *
+     * **Note**: Returns only permissions from direct assignments and directly assigned roles. For permissions a user has via group-based role assignments, use `GET /api/v2/users/{id}/effective-permissions`.
+     *
      * @param {string} id - ID of the user to retrieve the permissions for.
      * @param {Management.ListUserPermissionsRequestParameters} request
      * @param {PermissionsClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/management/api/resources/users/resources/refreshToken/client/Client.d.ts

@@ -24,6 +24,7 @@ export declare class RefreshTokenClient {
      *
      * @example
      *     await client.users.refreshToken.list("user_id", {
+     *         include_totals: true,
      *         from: "from",
      *         take: 1
      *     })

package/dist/cjs/management/api/resources/users/resources/refreshToken/client/Client.js

@@ -69,6 +69,7 @@ class RefreshTokenClient {
      *
      * @example
      *     await client.users.refreshToken.list("user_id", {
+     *         include_totals: true,
      *         from: "from",
      *         take: 1
      *     })
@@ -77,8 +78,9 @@ class RefreshTokenClient {
         return __awaiter(this, arguments, void 0, function* (user_id, request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                const { from: from_, take = 50 } = request;
+                const { include_totals: includeTotals = true, from: from_, take = 50 } = request;
                 const _queryParams = {
+                    include_totals: includeTotals,
                     from: from_,
                     take,
                 };

package/dist/cjs/management/api/resources/users/resources/roles/client/Client.d.ts

@@ -15,6 +15,8 @@ export declare class RolesClient {
      *
      * **Note**: This action retrieves all roles assigned to a user in the context of your whole tenant. To retrieve Organization-specific roles, use the following endpoint: [Get user roles assigned to an Organization member](https://auth0.com/docs/api/management/v2/organizations/get-organization-member-roles).
      *
+     * **Note**: Returns only direct role assignments. To also include group-based role assignments, use `GET /api/v2/users/{id}/effective-roles`.
+     *
      * @param {string} id - ID of the user to list roles for.
      * @param {Management.ListUserRolesRequestParameters} request
      * @param {RolesClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/management/api/resources/users/resources/roles/client/Client.js

@@ -60,6 +60,8 @@ class RolesClient {
      *
      * **Note**: This action retrieves all roles assigned to a user in the context of your whole tenant. To retrieve Organization-specific roles, use the following endpoint: [Get user roles assigned to an Organization member](https://auth0.com/docs/api/management/v2/organizations/get-organization-member-roles).
      *
+     * **Note**: Returns only direct role assignments. To also include group-based role assignments, use `GET /api/v2/users/{id}/effective-roles`.
+     *
      * @param {string} id - ID of the user to list roles for.
      * @param {Management.ListUserRolesRequestParameters} request
      * @param {RolesClient.RequestOptions} requestOptions - Request-specific configuration.

package/dist/cjs/management/api/resources/users/resources/sessions/client/Client.d.ts

@@ -24,6 +24,7 @@ export declare class SessionsClient {
      *
      * @example
      *     await client.users.sessions.list("user_id", {
+     *         include_totals: true,
      *         from: "from",
      *         take: 1
      *     })

package/dist/cjs/management/api/resources/users/resources/sessions/client/Client.js

@@ -69,6 +69,7 @@ class SessionsClient {
      *
      * @example
      *     await client.users.sessions.list("user_id", {
+     *         include_totals: true,
      *         from: "from",
      *         take: 1
      *     })
@@ -77,8 +78,9 @@ class SessionsClient {
         return __awaiter(this, arguments, void 0, function* (user_id, request = {}, requestOptions) {
             const list = core.HttpResponsePromise.interceptFunction((request) => __awaiter(this, void 0, void 0, function* () {
                 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
-                const { from: from_, take = 50 } = request;
+                const { include_totals: includeTotals = true, from: from_, take = 50 } = request;
                 const _queryParams = {
+                    include_totals: includeTotals,
                     from: from_,
                     take,
                 };