feat: Support Hub Document API (box/box-codegen#930) (#1388)

Author: box-sdk-build

.codegen.json

@@ -1 +1 @@
-{ "engineHash": "02fdae4", "specHash": "c8e3a85", "version": "10.5.0" }
+{ "engineHash": "e77f966", "specHash": "c8e3a85", "version": "10.5.0" }

docs/README.md

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

docs/hubDocument.md

@@ -0,0 +1,68 @@
+# HubDocumentManager
+
+- [List Hub Document Pages](#list-hub-document-pages)
+- [List Hub Document blocks for page](#list-hub-document-blocks-for-page)
+
+## List Hub Document Pages
+
+Retrieves a list of Hub Document Pages for the specified hub.
+Includes both root-level pages and sub pages.
+
+This operation is performed by calling function `getHubDocumentPagesV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/get-hub-document-pages/).
+
+<!-- sample get_hub_document_pages_v2025.0 -->
+
+```ts
+await client.hubDocument.getHubDocumentPagesV2025R0({
+  hubId: hubId,
+} satisfies GetHubDocumentPagesV2025R0QueryParams);
+```
+
+### Arguments
+
+- queryParams `GetHubDocumentPagesV2025R0QueryParams`
+  - Query parameters of getHubDocumentPagesV2025R0 method
+- optionalsInput `GetHubDocumentPagesV2025R0OptionalsInput`
+
+### Returns
+
+This function returns a value of type `HubDocumentPagesV2025R0`.
+
+Returns a Hub Document Pages response whose `entries` array contains root-level pages and sub pages. Includes pagination when more results are available.
+
+## List Hub Document blocks for page
+
+Retrieves a sorted list of all Hub Document Blocks on a specified page in the hub document, excluding items.
+Blocks are hierarchically organized by their `parent_id`.
+Blocks are sorted in order based on user specification in the user interface.
+The response will only include content blocks that belong to the specified page. This will not include sub pages or sub page content blocks.
+
+This operation is performed by calling function `getHubDocumentBlocksV2025R0`.
+
+See the endpoint docs at
+[API Reference](https://developer.box.com/reference/v2025.0/get-hub-document-blocks/).
+
+<!-- sample get_hub_document_blocks_v2025.0 -->
+
+```ts
+await client.hubDocument.getHubDocumentBlocksV2025R0({
+  hubId: hubId,
+  pageId: pageId,
+} satisfies GetHubDocumentBlocksV2025R0QueryParams);
+```
+
+### Arguments
+
+- queryParams `GetHubDocumentBlocksV2025R0QueryParams`
+  - Query parameters of getHubDocumentBlocksV2025R0 method
+- optionalsInput `GetHubDocumentBlocksV2025R0OptionalsInput`
+
+### Returns
+
+This function returns a value of type `HubDocumentBlocksV2025R0`.
+
+Returns a Hub Document Blocks response whose `entries` array contains all content blocks of the specified page, except for items.
+To retrieve items, use the `GET /hub_items` endpoint.

package-lock.json

@@ -81,6 +81,7 @@ import { EnterpriseConfigurationsManager } from './managers/enterpriseConfigurat
 import { HubsManager } from './managers/hubs';
 import { HubCollaborationsManager } from './managers/hubCollaborations';
 import { HubItemsManager } from './managers/hubItems';
+import { HubDocumentManager } from './managers/hubDocument';
 import { ShieldListsManager } from './managers/shieldLists';
 import { ArchivesManager } from './managers/archives';
 import { ExternalUsersManager } from './managers/externalUsers';
@@ -185,6 +186,7 @@ export class BoxClient {
   readonly hubs: HubsManager;
   readonly hubCollaborations: HubCollaborationsManager;
   readonly hubItems: HubItemsManager;
+  readonly hubDocument: HubDocumentManager;
   readonly shieldLists: ShieldListsManager;
   readonly archives: ArchivesManager;
   readonly externalUsers: ExternalUsersManager;
@@ -270,6 +272,7 @@ export class BoxClient {
       | 'hubs'
       | 'hubCollaborations'
       | 'hubItems'
+      | 'hubDocument'
       | 'shieldLists'
       | 'archives'
       | 'externalUsers'
@@ -614,6 +617,10 @@ export class BoxClient {
       auth: this.auth,
       networkSession: this.networkSession,
     });
+    this.hubDocument = new HubDocumentManager({
+      auth: this.auth,
+      networkSession: this.networkSession,
+    });
     this.shieldLists = new ShieldListsManager({
       auth: this.auth,
       networkSession: this.networkSession,