@agility/management-sdk 0.1.2 → 0.1.4-beta.1

package/README.md

@@ -1,396 +1,263 @@
 # Agility CMS & Management API TypeScript SDK
 
+## Table of Contents
+
+- [About the Management API SDK](#about-the-management-api-sdk)
+- [Getting Started](#getting-started)
+- [Authentication & Setup](./docs/auth.md)
+- [API Method Classes](#api-method-classes)
+- [Examples](#examples)
+- [TypeScript Interfaces](#typescript-interfaces)
+- [Available Enums](#available-enums)
+
+---
+
 ## About the Management API SDK
 
 - Provides a facility to developers to use the new Agility Management API more effectively.
 - Provides methods to perform operations on Assets, Batches, Containers, Content, Models, Pages, and Users.
-- Supports the creation of Pages and Content in batches.
+- **Content and Page Creation** - Create individual or multiple content items and pages (which automatically get added to batches).
+- **Essential batch workflow operations** - Perform publish, unpublish, approve, decline, and request approval operations on existing batches.
 - Ability to generate Content in bulk for a Website.
+- **Strongly typed TypeScript interfaces** for all batch operations with comprehensive error handling.
 
 ## Getting Started
 
 ### Prerequisites
 1. Clone the repository agility-cms-management-sdk-typescript.
 2. Import the index file to make use of the Options class.
-3. Create an object of the Options class to provide values of - 
-	- token -> Bearer token to authenticate a Rest Request to perform an operation.
-	- locale -> The locale under which your application is hosted. Example en-us.
-    - guid -> The guid under which your application is hosted.
-4. Create an object of Method class(es), which can be used to create and perform operations. Following is the description of Classes and their respective methods -
+3. You will need valid Agility CMS credentials to authenticate and obtain an access token.
 
-### Making a Request
-```Javascript
-import * as index from "./index";
+### Authentication
+For detailed authentication instructions, including OAuth 2.0 setup, token management, and security best practices, see the **[Authentication & Setup Guide](./docs/auth.md)**.
 
-//initialize the Options Class
-let options = new index.Options();
+### Making a Request
 
-options.token = "<<Provide Auth Token>>";
-options.guid = "<<Provide the Guid of the Website>>";
-options.locale = "<<Provide the locale of the Website>>"; //Example: en-us
+#### Simple OAuth Authentication (Recommended)
+```typescript
+import * as mgmtApi from "@agility/management-sdk";
 
-//Initialize the Method Class
-let contentMethods = new index.ContentMethods(options);
+// Simple OAuth authentication - tokens managed automatically
+const apiClient = new mgmtApi.ApiClient();
+await apiClient.auth();
 
-//make the request: get a content item with the ID '22'
-var contentItem = await contentMethods.getContentItem(22);
+const guid = "your-website-guid";
+const locale = "en-us";
 
-//To log the response of the contentItem object in console.
+// Make authenticated request - token refresh handled automatically
+const contentItem = await apiClient.contentMethods.getContentItem(22, guid, locale);
 console.log(JSON.stringify(contentItem));
 ```
-## Class AssetMethods
-This class is used to perform operations related to Assets. The following are the methods: - 
-
-### upload
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `formData` | `FormData` | This is an object of type FormData where files can be posted eg : `const file = fs.readFileSync(<<Local File>>, null);const form = new FormData(); form.append('files',file,'<<File Name>>');`|
-| `agilityFolderPath` | `string` | Path of the folder in Agility where the file(s) needs to be uploaded.|
-| `groupingID` | `number` | Path of the folder in Agility where the file(s) needs to be uploaded.|
-
-Returns: A collection of ```Media``` class Object.
-
-### deleteFile
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `mediaID` | `number` | The mediaID of the asset which needs to be deleted.|
-Returns
-A ```string``` response if a file has been deleted.
-
-### moveFile
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `mediaID` | `number` | The mediaID of the file that needs to be moved.|
-| `newFolder` | `string` | The new location (in Agility) where the file needs to be moved.|
-
-Returns: An object of ```Media``` class with the new location of the file.
-
-### getMediaList
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `pageSize` | `number` | The page size on which the assets needs to selected.|
-| `recordOffset` | `number` | The record offset value to skip search results.|
-
-Returns: An object of ```AssetMediaList``` class.
-
-### getAssetByID
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `mediaID` | `number` | The mediaID of the requested asset.|
-
-Returns: An object of ```Media``` class with the information of the asset.
-
-### getAssetByUrl
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `url` | `string` | The url of the requested asset.|
-
-Returns: An object of ```Media``` class with the information of the asset.
-
-## Class BatchMethods
-This class is used to perform operations related to Batches. The following are the methods: - 
-
-### getBatch
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `id` | `number` | The batchID of the requested batch.|
-
-Returns: A object of ```Batch``` class.
-
-## Class ContainerMethods
-This class is used to perform operations related to Containers. The following are the methods: - 
-
-### getContainerByID
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `id` | `number` | The container id of the requested container.|
-
-Returns: A object of ```Container``` class.
-
-### getContainerByReferenceName
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `referenceName` | `string` | The container reference name of the requested container.|
-
-Returns: A object of ```Container``` class.
-
-### getContainerSecurity
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `id` | `number` | The container id of the requested container.|
-
-Returns: A object of ```Container``` class.
-
-### getContainerList
-Returns: A collection object of ```Container``` class.
-
-### getNotificationList
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `id` | `number` | The container id of the requested container.|
-
-Returns: A collection object of ```Notification``` class.
-
-### saveContainer
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `container` | `Container` | A Container type object to create or update a container.|
-
-Returns: An object of ```Container``` class.
-
-### deleteContainer
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `id` | `number` | The container id of the requested container.|
-
-Returns: A ```string``` response if a container has been deleted.
-
-## Class ContentMethods
-This class is used to perform operations related to Content. The following are the methods: - 
-
-### getContentItem
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `contentID` | `number` | The contentid of the requested content.|
-
-Returns: An object of ```ContentItem``` class.
-
-### publishContent
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `contentID` | `number` | The contentid of the requested content.|
-| `comments` | `string` | Additional comments for a batch request.|
-
-Returns: An array of ```contentID``` of the requested content.
-
-### unPublishContent
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `contentID` | `number` | The contentid of the requested content.|
-| `comments` | `string` | Additional comments for a batch request.|
-
-Returns: An array of ```contentID``` of the requested content.
-
-### contentRequestApproval
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `contentID` | `number` | The contentid of the requested content.|
-| `comments` | `string` | Additional comments for a batch request.|
 
-Returns: An array of ```contentID``` of the requested content.
+#### Manual Token Authentication (For CI/CD)
+```typescript
+import * as mgmtApi from "@agility/management-sdk";
 
-### approveContent
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `contentID` | `number` | The contentid of the requested content.|
-| `comments` | `string` | Additional comments for a batch request.|
+// Token-based approach for CI/CD and automated environments
+const options = new mgmtApi.Options();
+options.token = process.env.AGILITY_API_TOKEN;
+const apiClient = new mgmtApi.ApiClient(options);
 
-Returns: An array of ```contentID``` of the requested content.
+const guid = process.env.AGILITY_GUID;
+const locale = "en-us";
 
-### declineContent
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `contentID` | `number` | The contentid of the requested content.|
-| `comments` | `string` | Additional comments for a batch request.|
-
-Returns: An array of ```contentID``` of the requested content.
-
-### saveContentItem
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `contentItem` | `ContentItem` | A contentItem object to create or update a content.|
-
-Returns: An array of ```contentID``` of the requested content.
-
-### saveContentItems
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `contentItems` | `ContentItem[]` | A collection of contentItems object to create or update multiple contents.|
-
-Returns: An array of ```contentID``` of the requested content.
-
-### deleteContent
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `contentID` | `number` | The contentid of the requested content.|
-| `comments` | `string` | Additional comments for a batch request.|
-
-Returns: An array of ```contentID``` of the requested content.
-
-### getContentItems
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `referenceName` | `string` | The reference name of the container for the requested content.|
-| `filter` | `string` | The filter condition for the requested content.|
-| `fields` | `string` | The fields mapped to the container.|
-| `sortDirection` | `string` | The direction to sort the result.|
-| `sortField` | `string` | The field on which the sort needs to be performed.|
-| `take` | `number` | The page size for the result.|
-| `skip` | `number` | The record offset for the result.|
-
-Returns: An object of ```ContentList``` class of the requested content.
-
-## Class InstanceUserMethods
-This class is used to perform operations related to User. The following are the methods: - 
-
-### getUsers
-Returns: A collection of ```WebsiteUser``` class of the requested content.
-
-### saveUser
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `emailAddress` | `string` | The email address of the requested user.|
-| `roles` | `InstanceRole[]` | Collection object of InstanceRole class for the requested user.|
-| `firstName` | `string` | The first name of the requested user.|
-| `lastName` | `string` | The last name of the requested user.|
-
-Returns: An object of the ```InstanceUser``` class.
-
-### deleteUser
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `userID` | `number` | The userID of the requested user.|
-
-Returns: A ```string``` response if a user has been deleted.
-
-## Class ModelMethods
-This class is used to perform operations related to Models. The following are the methods: - 
-
-### getContentModel
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `id` | `number` | The id of the requested model.|
-
-Returns: An object of ```Model``` class.
-
-### getContentModules
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `includeDefaults` | `bool` | Boolean value to include defaults.|
-| `includeModules` | `bool` | Boolean value to include modules.|
-
-Returns: A collection object of ```Model``` class.
-
-### getPageModules
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `includeDefault` | `bool` | Boolean value to include defaults.|
-
-Returns: A collection object of ```Model``` class.
-
-### saveModel
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `model` | `Model` | The object of Model to for the requested model.|
-
-Returns: An object of ```Model``` class.
-
-### deleteModel
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `id` | `number` | The id for the requested model.|
-
-Returns: A ```string``` response if a model is deleted.
-
-## Class PageMethods
-This class is used to perform operations related to Pages. The following are the methods: - 
-
-### getSitemap
-Returns: A collection object of ```Sitemap``` class.
-
-### getPage
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `pageID` | `number` | The id of the requested page.|
-
-Returns: An object of ```PageItem``` class.
-
-### publishPage
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `pageID` | `number` | The pageID of the requested page.|
-| `comments` | `string` | Additional comments for a batch request.|
-
-Returns: An array of ```pageID``` of the requested page.
-
-### unPublishPage
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `pageID` | `number` | The pageID of the requested page.|
-| `comments` | `string` | Additional comments for a batch request.|
-
-Returns: An array of ```pageID``` of the requested page.
-
-### deletePage
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `pageID` | `number` | The pageID of the requested page.|
-| `comments` | `string` | Additional comments for a batch request.|
-
-Returns: An array of ```pageID``` of the requested page.
-
-### approvePage
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `pageID` | `number` | The pageID of the requested page.|
-| `comments` | `string` | Additional comments for a batch request.|
+const contentItem = await apiClient.contentMethods.getContentItem(22, guid, locale);
+console.log('Content retrieved:', contentItem.fields.title);
+```
 
-Returns: An array of ```pageID``` of the requested page.
+> 💡 **Note**: The new OAuth authentication requires `keytar` for secure token storage. See the [Authentication & Setup Guide](./docs/auth.md) for OAuth setup or [CI/CD & Automated Environments](./docs/cicd.md) for token-based authentication.
 
-### declinePage
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `pageID` | `number` | The pageID of the requested page.|
-| `comments` | `string` | Additional comments for a batch request.|
+## API Method Classes
+
+### File and Media Management
+- **[AssetMethods](./docs/asset-methods.md)** - File and media management operations (15 functions)
+  - [deleteFile](./docs/asset-methods.md#deletefile), [moveFile](./docs/asset-methods.md#movefile), [getMediaList](./docs/asset-methods.md#getmedialist), [getGalleries](./docs/asset-methods.md#getgalleries), [getGalleryById](./docs/asset-methods.md#getgallerybyid), [getGalleryByName](./docs/asset-methods.md#getgallerybyname), [getDefaultContainer](./docs/asset-methods.md#getdefaultcontainer), [saveGallery](./docs/asset-methods.md#savegallery), [deleteGallery](./docs/asset-methods.md#deletegallery), [getAssetByID](./docs/asset-methods.md#getassetbyid), [getAssetByUrl](./docs/asset-methods.md#getassetbyurl), [upload](./docs/asset-methods.md#upload), [createFolder](./docs/asset-methods.md#createfolder), [deleteFolder](./docs/asset-methods.md#deletefolder), [renameFolder](./docs/asset-methods.md#renamefolder)
+
+### Workflow Operations
+- **[BatchMethods](./docs/batch-methods.md)** - Batch workflow operations (7 functions)
+  - [getBatch](./docs/batch-methods.md#getbatch), [publishBatch](./docs/batch-methods.md#publishbatch), [unpublishBatch](./docs/batch-methods.md#unpublishbatch), [approveBatch](./docs/batch-methods.md#approvebatch), [declineBatch](./docs/batch-methods.md#declinebatch), [requestApprovalBatch](./docs/batch-methods.md#requestapprovalbatch), [getBatchTypes](./docs/batch-methods.md#getbatchtypes)
+
+### Content Management
+- **[ContainerMethods](./docs/container-methods.md)** - Container management operations (8 functions)
+  - [getContainerByID](./docs/container-methods.md#getcontainerbyid), [getContainersByModel](./docs/container-methods.md#getcontainersbymodel), [getContainerByReferenceName](./docs/container-methods.md#getcontainerbyreferencename), [getContainerSecurity](./docs/container-methods.md#getcontainersecurity), [getContainerList](./docs/container-methods.md#getcontainerlist), [getNotificationList](./docs/container-methods.md#getnotificationlist), [saveContainer](./docs/container-methods.md#savecontainer), [deleteContainer](./docs/container-methods.md#deletecontainer)
+
+- **[ContentMethods](./docs/content-methods.md)** - Content item operations (13 functions)
+  - [getContentItem](./docs/content-methods.md#getcontentitem), [publishContent](./docs/content-methods.md#publishcontent), [unPublishContent](./docs/content-methods.md#unpublishcontent), [contentRequestApproval](./docs/content-methods.md#contentrequestapproval), [approveContent](./docs/content-methods.md#approvecontent), [declineContent](./docs/content-methods.md#declinecontent), [deleteContent](./docs/content-methods.md#deletecontent), [saveContentItem](./docs/content-methods.md#savecontentitem), [saveContentItems](./docs/content-methods.md#savecontentitems), [getContentItems](./docs/content-methods.md#getcontentitems), [getContentList](./docs/content-methods.md#getcontentlist), [getContentHistory](./docs/content-methods.md#getcontenthistory), [getContentComments](./docs/content-methods.md#getcontentcomments)
+
+- **[ModelMethods](./docs/model-methods.md)** - Content model operations (6 functions)
+  - [getContentModel](./docs/model-methods.md#getcontentmodel), [getModelByReferenceName](./docs/model-methods.md#getmodelbyreferencename), [getContentModules](./docs/model-methods.md#getcontentmodules), [getPageModules](./docs/model-methods.md#getpagemodules), [saveModel](./docs/model-methods.md#savemodel), [deleteModel](./docs/model-methods.md#deletemodel)
+
+### Page Management
+- **[PageMethods](./docs/page-methods.md)** - Page management operations (17 functions)
+  - [getPage](./docs/page-methods.md#getpage), [getPageByPath](./docs/page-methods.md#getpagebypath), [getPageHistory](./docs/page-methods.md#getpagehistory), [getPageComments](./docs/page-methods.md#getpagecomments), [getPageList](./docs/page-methods.md#getpagelist), [getPageListByPageTemplateID](./docs/page-methods.md#getpagelistbypagetemplateid), [getPageListByPage](./docs/page-methods.md#getpagelistbypage), [getPageListByPageAndPageTemplateID](./docs/page-methods.md#getpagelistbypageandpagetemplateid), [getPageTree](./docs/page-methods.md#getpagetree), [getPageTemplateList](./docs/page-methods.md#getpagetemplatelist), [getPageSecurity](./docs/page-methods.md#getpagesecurity), [getPageItemTemplateList](./docs/page-methods.md#getpageitemtemplatelist), [getPageContentZones](./docs/page-methods.md#getpagecontentzones), [savePage](./docs/page-methods.md#savepage), [savePageSecurity](./docs/page-methods.md#savepagesecurity), [movePageItem](./docs/page-methods.md#movepageitem), [deletePage](./docs/page-methods.md#deletepage)
+
+### User Management
+- **[InstanceMethods](./docs/instance-methods.md)** - Instance-level operations (1 function)
+  - [getLocales](./docs/instance-methods.md#getlocales)
+
+- **[InstanceUserMethods](./docs/instance-user-methods.md)** - Instance user management (3 functions)
+  - [getUsers](./docs/instance-user-methods.md#getusers), [saveUser](./docs/instance-user-methods.md#saveuser), [deleteUser](./docs/instance-user-methods.md#deleteuser)
+
+- **[ServerUserMethods](./docs/server-user-methods.md)** - Server user operations (2 functions)
+  - [me](./docs/server-user-methods.md#me), [you](./docs/server-user-methods.md#you)
+
+### Integration
+- **[WebhookMethods](./docs/webhook-methods.md)** - Webhook management (4 functions)
+  - [getWebhook](./docs/webhook-methods.md#getwebhook), [webhookList](./docs/webhook-methods.md#webhooklist), [saveWebhook](./docs/webhook-methods.md#savewebhook), [deleteWebhook](./docs/webhook-methods.md#deletewebhook)
+
+### Multi-Instance Operations
+- **[Multi-Instance Operations](./docs/multi-instance-operations.md)** - Advanced workflows for managing content across multiple instances and locales
+  - Configuration-driven content creation across multiple environments
+  - Parallel processing and batch operations
+  - Performance optimization and error handling
+  - Cross-instance synchronization and reporting
+
+### CI/CD & Automation
+- **[CI/CD & Automated Environments](./docs/cicd.md)** - Token-based authentication for automated environments
+  - CI/CD pipeline examples (GitHub Actions, GitLab CI, Jenkins)
+  - Serverless functions (AWS Lambda, Vercel)
+  - Environment configuration and security best practices
+  - Token management and rotation
+
+## Examples
+
+### Understanding Agility CMS Batch Architecture
+
+Agility CMS uses a simple approach for working with content and batches:
+
+#### Content/Page Creation (Handled by Respective Controllers)
+- **contentMethods.saveContentItem()** - Creates a single new content item and adds it to a batch
+- **contentMethods.saveContentItems()** - Creates multiple new content items and adds them to a batch  
+- **pageMethods.savePage()** - Creates a new page and adds it to a batch
+- These methods create the content AND automatically handle batch creation/management
+
+#### Batch Workflow Operations (Handled by Batch Controller)
+- **batchMethods.publishBatch()** - Publishes all items in an existing batch
+- **batchMethods.unpublishBatch()** - Unpublishes all items in an existing batch
+- **batchMethods.approveBatch()** - Approves all items in an existing batch
+- **batchMethods.declineBatch()** - Declines all items in an existing batch
+- **batchMethods.requestApprovalBatch()** - Requests approval for all items in an existing batch
+- **batchMethods.getBatch()** - Retrieves details of an existing batch
+- **batchMethods.getBatchTypes()** - Retrieves all batch-related enum types for developer discovery
+
+### Complete Workflow Example
+
+```typescript
+import * as mgmtApi from '@agility/management-sdk';
+
+// Authenticate with simple OAuth flow
+const client = new mgmtApi.ApiClient();
+await client.auth();
+
+const guid = 'your-instance-guid';
+const locale = 'en-us';
+
+// Get batch types for dynamic UI and validation
+const batchTypes = await client.batchMethods.getBatchTypes(guid);
+console.log('Available batch types loaded:', batchTypes);
+
+// Create NEW content items (handled by content controller)
+// This automatically creates and manages batches
+const newContentBatchID = await client.contentMethods.saveContentItem(locale, {
+    properties: {
+        referenceName: 'blog-post',
+        definitionName: 'BlogPost',
+        state: 2
+    },
+    fields: {
+        title: 'My New Blog Post',
+        content: 'This is the blog post content...'
+    }
+});
+
+// Create NEW page (handled by page controller)  
+// This automatically creates and manages batches
+const newPageBatchID = await client.pageMethods.savePage(locale, {
+    name: 'new-product-page',
+    title: 'New Product Page',
+    menuText: 'New Product',
+    pageType: 'static',
+    templateName: 'Product Template',
+    parentPageID: -1
+});
+
+// Retrieve details of an existing batch
+const batchDetails = await client.batchMethods.getBatch(newContentBatchID, guid);
+console.log('Batch details:', batchDetails);
+
+// Perform workflow operations on existing batches
+await client.batchMethods.publishBatch(newContentBatchID, guid);
+await client.batchMethods.approveBatch(newPageBatchID, guid);
+
+// Or use immediate return for custom polling
+const batchId = await client.batchMethods.publishBatch(newContentBatchID, guid, true);
+console.log('Batch submitted for publishing:', batchId);
+
+console.log('All operations completed successfully!');
+```
 
-Returns: An array of ```pageID``` of the requested page.
+## TypeScript Interfaces
 
-### pageRequestApproval
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `pageID` | `number` | The pageID of the requested page.|
-| `comments` | `string` | Additional comments for a batch request.|
+### Batch Response Interfaces
 
-Returns: An array of ```pageID``` of the requested page.
+```typescript
+interface BatchTypesResponse {
+    itemTypes: EnumInfo[];         // Page, ContentItem, ContentList, Tag, ModuleDef
+    operationTypes: EnumInfo[];    // All operation types 
+    workflowOperations: EnumInfo[]; // Publish, Unpublish, Approve, Decline, RequestApproval
+    states: EnumInfo[];            // None, Pending, InProcess, Processed, Deleted
+}
 
-### savePage
-| Parameter | Type     | Description                |
-| :-------- | :------- | :------------------------- |
-| `pageItem` | `PageItem` | The object of PageItem class for the requested Page.|
-| `parentPageID` | `number` | The id of the parent page.|
-| `placeBeforePageItemID` | `number` | The id of the page before the page.|
+interface EnumInfo {
+    value: number;      // Numeric enum value
+    name: string;       // String name (e.g., "Publish")
+    description: string; // Human-readable description
+}
+```
 
-Returns: An array of ```pageID``` of the requested page.
+## Available Enums
 
+### WorkflowOperationType (for batch processing)
+> **Note**: In the API documentation (Swagger UI), these operations appear as descriptive dropdown options (Publish, Unpublish, Approve, Decline, RequestApproval) instead of numbers.
 
-## Running the SDK Locally
+- `Publish = 1`
+- `Unpublish = 2` 
+- `Approve = 3`
+- `Decline = 4`
+- `RequestApproval = 5`
 
-- `npm run clean`
-- `npm run prepare`
-- `npm run build` 
+### BatchItemType
+> **Note**: In the API documentation (Swagger UI), these appear as descriptive dropdown options (Page, ContentItem, ContentList, Tag, ModuleDef) instead of numbers.
 
-## How It Works
+- `Page = 1`
+- `ContentItem = 2`
+- `ContentList = 3`
+- `Tag = 4`
+- `ModuleDef = 5`
 
-- [How Pages Work](https://help.agilitycms.com/hc/en-us/articles/4404222849677)
-- [How Page Modules Work](https://help.agilitycms.com/hc/en-us/articles/4404222989453)
-- [How Page Templates Work](https://help.agilitycms.com/hc/en-us/articles/4404229108877)
+### BatchState
+> **Note**: In the API documentation (Swagger UI), these appear as descriptive names (None, Pending, InProcess, Processed, Deleted) instead of numbers.
 
-## Resources
+- `None = 0` - Batch created but not submitted for processing
+- `Pending = 1` - Batch is pending processing
+- `InProcess = 2` - Batch is currently being processed  
+- `Processed = 3` - Batch has been processed successfully
+- `Deleted = 4` - Batch has been deleted
 
-### Agility CMS
+## Error Handling
 
-- [Official site](https://agilitycms.com)
-- [Documentation](https://help.agilitycms.com/hc/en-us)
+All methods throw exceptions on failure:
 
-### Community
+```typescript
+try {
+    const batch = await client.batchMethods.getBatch(123, 'instance-guid');
+} catch (error) {
+    console.error('Failed to get batch:', error.message);
+}
+```
 
-- [Official Slack](https://join.slack.com/t/agilitycommunity/shared_invite/enQtNzI2NDc3MzU4Njc2LWI2OTNjZTI3ZGY1NWRiNTYzNmEyNmI0MGZlZTRkYzI3NmRjNzkxYmI5YTZjNTg2ZTk4NGUzNjg5NzY3OWViZGI)
-- [Blog](https://agilitycms.com/resources/posts)
-- [GitHub](https://github.com/agility)
-- [Forums](https://help.agilitycms.com/hc/en-us/community/topics)
-- [Facebook](https://www.facebook.com/AgilityCMS/)
-- [Twitter](https://twitter.com/AgilityCMS)
+## License
 
-## Feedback and Questions
+MIT
 
-If you have feedback or questions about this starter, please use the [Github Issues](https://github.com/agility/agility-cms-management-sdk-typescript/issues) on this repo, join our [Community Slack Channel](https://join.slack.com/t/agilitycommunity/shared_invite/enQtNzI2NDc3MzU4Njc2LWI2OTNjZTI3ZGY1NWRiNTYzNmEyNmI0MGZlZTRkYzI3NmRjNzkxYmI5YTZjNTg2ZTk4NGUzNjg5NzY3OWViZGI) or create a post on the [Agility Developer Community](https://help.agilitycms.com/hc/en-us/community/topics).
+If you have feedback or questions about this starter, please use the [Github Issues](https://github.com/agility/agility-cms-management-sdk-typescript/issues) on this repo, join our [Community Slack Channel](https://join.slack.com/t/agilitycommunity/shared_invite/enQtNzI2NDc3MzU4Njc2LWI2OTNjZTI3ZGY1NWRiNTYzNmEyNmI0MGZlZTRkYzI3NmRjNzkxYmI5YTZjNTg2ZTk4NGUzNjg5NzY3OWViZGI) or create a post on the [Agility Developer Community](https://help.agilitycms.com/hc/en-us/community/topics).