feat: Add new Hubs APIs and Hubs items API (box/box-openapi#538) (#666)

Co-authored-by: box-sdk-build <box-sdk-build@box.com>

Author: box-sdk-build

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "7d973e2", "specHash": "8402463", "version": "1.16.0" }
+{ "engineHash": "fe7a2b2", "specHash": "7871ded", "version": "1.16.0" }

docs/README.md

@@ -37,6 +37,7 @@ the SDK are available by topic:
 - [Folders](folders.md)
 - [Groups](groups.md)
 - [Hub collaborations](hubCollaborations.md)
+- [Hub items](hubItems.md)
 - [Hubs](hubs.md)
 - [Integration mappings](integrationMappings.md)
 - [Invites](invites.md)

docs/hubItems.md

@@ -0,0 +1,52 @@
+# HubItemsManager
+
+- [Get hub items](#get-hub-items)
+- [Manage hub items](#manage-hub-items)
+
+## Get hub items
+
+Retrieves all items associated with a Hub.
+
+This operation is performed by calling function `getHubItemsV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/get-hub-items/).
+
+_Currently we don't have an example for calling `getHubItemsV2025R0` in integration tests_
+
+### Arguments
+
+- queryParams `GetHubItemsV2025R0QueryParams`
+  - Query parameters of getHubItemsV2025R0 method
+- optionalsInput `GetHubItemsV2025R0OptionalsInput`
+  -
+
+### Returns
+
+This function returns a value of type `HubItemsV2025R0`.
+
+Retrieves the items associated with the specified Hub.
+
+## Manage hub items
+
+Adds and/or removes Hub items from a Hub.
+
+This operation is performed by calling function `createHubManageItemV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/post-hubs-id-manage-items/).
+
+_Currently we don't have an example for calling `createHubManageItemV2025R0` in integration tests_
+
+### Arguments
+
+- hubId `string`
+  - The unique identifier that represent a hub. The ID for any hub can be determined by visiting this hub in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/hubs/123` the `hub_id` is `123`. Example: "12345"
+- requestBody `HubItemsManageRequestV2025R0`
+  - Request body of createHubManageItemV2025R0 method
+- optionalsInput `CreateHubManageItemV2025R0OptionalsInput`
+  -
+
+### Returns
+
+This function returns a value of type `HubItemsManageResponseV2025R0`.

docs/hubs.md

@@ -1,9 +1,12 @@
 # HubsManager
 
 - [List all hubs](#list-all-hubs)
+- [Create hub](#create-hub)
 - [List all hubs for requesting enterprise](#list-all-hubs-for-requesting-enterprise)
 - [Get hub information by ID](#get-hub-information-by-id)
+- [Update hub information by ID](#update-hub-information-by-id)
 - [Delete hub](#delete-hub)
+- [Copy hub](#copy-hub)
 
 ## List all hubs
 
@@ -39,6 +42,30 @@ This function returns a value of type `HubsV2025R0`.
 
 Returns all hubs for the given user or enterprise.
 
+## Create hub
+
+Creates a new Hub.
+
+This operation is performed by calling function `createHubV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/post-hubs/).
+
+_Currently we don't have an example for calling `createHubV2025R0` in integration tests_
+
+### Arguments
+
+- requestBody `HubCreateRequestV2025R0`
+  - Request body of createHubV2025R0 method
+- optionalsInput `CreateHubV2025R0OptionalsInput`
+  -
+
+### Returns
+
+This function returns a value of type `HubV2025R0`.
+
+Returns a new Hub object.
+
 ## List all hubs for requesting enterprise
 
 Retrieves all hubs for a given enterprise.
@@ -103,6 +130,32 @@ This function returns a value of type `HubV2025R0`.
 
 Returns a hub object.
 
+## Update hub information by ID
+
+Updates a Hub. Can be used to change title, description, or Hub settings.
+
+This operation is performed by calling function `updateHubByIdV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/put-hubs-id/).
+
+_Currently we don't have an example for calling `updateHubByIdV2025R0` in integration tests_
+
+### Arguments
+
+- hubId `string`
+  - The unique identifier that represent a hub. The ID for any hub can be determined by visiting this hub in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/hubs/123` the `hub_id` is `123`. Example: "12345"
+- requestBody `HubUpdateRequestV2025R0`
+  - Request body of updateHubByIdV2025R0 method
+- optionalsInput `UpdateHubByIdV2025R0OptionalsInput`
+  -
+
+### Returns
+
+This function returns a value of type `HubV2025R0`.
+
+Returns a Hub object.
+
 ## Delete hub
 
 Deletes a single hub.
@@ -131,3 +184,31 @@ This function returns a value of type `undefined`.
 
 A blank response is returned if the hub was
 successfully deleted.
+
+## Copy hub
+
+Creates a copy of a Hub.
+
+The original Hub will not be modified.
+
+This operation is performed by calling function `createHubCopyV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/post-hubs-id-copy/).
+
+_Currently we don't have an example for calling `createHubCopyV2025R0` in integration tests_
+
+### Arguments
+
+- hubId `string`
+  - The unique identifier that represent a hub. The ID for any hub can be determined by visiting this hub in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/hubs/123` the `hub_id` is `123`. Example: "12345"
+- requestBody `HubCopyRequestV2025R0`
+  - Request body of createHubCopyV2025R0 method
+- optionalsInput `CreateHubCopyV2025R0OptionalsInput`
+  -
+
+### Returns
+
+This function returns a value of type `HubV2025R0`.
+
+Returns a new Hub object.

package-lock.json

@@ -78,6 +78,7 @@ import { DocgenTemplateManager } from './managers/docgenTemplate.generated.js';
 import { DocgenManager } from './managers/docgen.generated.js';
 import { HubsManager } from './managers/hubs.generated.js';
 import { HubCollaborationsManager } from './managers/hubCollaborations.generated.js';
+import { HubItemsManager } from './managers/hubItems.generated.js';
 import { ShieldListsManager } from './managers/shieldLists.generated.js';
 import { Authentication } from './networking/auth.generated.js';
 import { NetworkSession } from './networking/network.generated.js';
@@ -176,6 +177,7 @@ export class BoxClient {
   readonly docgen: DocgenManager;
   readonly hubs: HubsManager;
   readonly hubCollaborations: HubCollaborationsManager;
+  readonly hubItems: HubItemsManager;
   readonly shieldLists: ShieldListsManager;
   constructor(
     fields: Omit<
@@ -256,6 +258,7 @@ export class BoxClient {
       | 'docgen'
       | 'hubs'
       | 'hubCollaborations'
+      | 'hubItems'
       | 'shieldLists'
       | 'networkSession'
       | 'makeRequest'
@@ -585,6 +588,10 @@ export class BoxClient {
       auth: this.auth,
       networkSession: this.networkSession,
     });
+    this.hubItems = new HubItemsManager({
+      auth: this.auth,
+      networkSession: this.networkSession,
+    });
     this.shieldLists = new ShieldListsManager({
       auth: this.auth,
       networkSession: this.networkSession,