@agility/management-sdk 0.1.32 → 0.1.34

package/.cursor/test-coverage.md

@@ -0,0 +1,841 @@
+# Agility CMS Management SDK Test Coverage Plan
+
+## Overview
+This document outlines comprehensive test coverage for all API methods in the Agility CMS Management SDK. Tests will be integration tests that hit real endpoints without mocks to ensure full functionality.
+
+## Test Environment Requirements
+
+### Prerequisites
+- Valid Agility CMS instance with management API access
+- Test environment variables configured in `.env.test`:
+  - `AGILITY_PAT`: Valid Personal Access Token (PAT)
+  - `AGILITY_GUID`: Test instance GUID
+  - `AGILITY_WEBSITE`: Test website ID within the instance
+  - `AGILITY_LOCALES`: Comma-separated list of test locales (e.g., 'en-us,fr-ca')
+  - `AGILITY_BASE_URL`: API base URL (optional, defaults to production)
+
+### Test Data Requirements
+- Test content models with known reference names
+- Test containers with predictable structures
+- Test content items that can be safely modified/deleted
+- Test assets in known folders
+- Test user accounts with appropriate permissions
+- Test webhooks that can be created/modified/deleted
+
+## API Method Coverage
+
+### 1. AssetMethods (`src/apiMethods/assetMethods.ts`)
+
+#### Core Asset Operations
+- [ ] **deleteFile(mediaID, guid)**
+  - ✅ Success: Delete existing test asset
+  - ❌ Error: Delete non-existent asset (404)
+  - ❌ Error: Unauthorized deletion (403)
+
+- [ ] **moveFile(mediaID, newFolder, guid)**
+  - ✅ Success: Move asset to existing folder
+  - ✅ Success: Move asset with special characters in folder name
+  - ❌ Error: Move non-existent asset
+  - ❌ Error: Move to non-existent folder
+
+- [ ] **getMediaList(pageSize, recordOffset, guid)**
+  - ✅ Success: Get first page with default page size
+  - ✅ Success: Get specific page with custom page size
+  - ✅ Success: Handle empty results
+  - ❌ Error: Invalid pagination parameters
+
+- [ ] **getAssetByID(mediaID, guid)**
+  - ✅ Success: Get existing asset details
+  - ❌ Error: Get non-existent asset (404)
+  - ❌ Error: Unauthorized access (403)
+
+- [ ] **getAssetByUrl(url, guid)**
+  - ✅ Success: Get asset by valid URL
+  - ❌ Error: Get asset by invalid URL
+  - ❌ Error: Get asset by non-existent URL
+
+#### Gallery Operations
+- [ ] **getGalleries(guid, search?, pageSize?, rowIndex?)**
+  - ✅ Success: Get all galleries
+  - ✅ Success: Search galleries with filter
+  - ✅ Success: Paginated gallery results
+  - ✅ Success: Handle empty search results
+
+- [ ] **getGalleryById(guid, id)**
+  - ✅ Success: Get existing gallery
+  - ❌ Error: Get non-existent gallery (404)
+
+- [ ] **getGalleryByName(guid, galleryName)**
+  - ✅ Success: Get gallery by valid name
+  - ❌ Error: Get gallery by non-existent name
+
+- [ ] **saveGallery(guid, gallery)**
+  - ✅ Success: Create new gallery
+  - ✅ Success: Update existing gallery
+  - ❌ Error: Invalid gallery data
+  - ❌ Error: Duplicate gallery name
+
+- [ ] **deleteGallery(guid, id)**
+  - ✅ Success: Delete existing gallery
+  - ❌ Error: Delete non-existent gallery
+  - ❌ Error: Delete gallery with assets
+
+#### Container & Upload Operations
+- [ ] **getDefaultContainer(guid)**
+  - ✅ Success: Get default asset container
+  - ❌ Error: No default container configured
+
+- [ ] **upload(formData, agilityFolderPath, guid, groupingID?)**
+  - ✅ Success: Upload single file to root
+  - ✅ Success: Upload to specific folder
+  - ✅ Success: Upload to gallery (with groupingID)
+  - ✅ Success: Upload multiple files
+  - ❌ Error: Invalid file format
+  - ❌ Error: File too large
+  - ❌ Error: Invalid folder path
+
+#### Folder Operations
+- [ ] **createFolder(originKey, guid)**
+  - ✅ Success: Create new folder
+  - ❌ Error: Create duplicate folder
+  - ❌ Error: Invalid folder name
+
+- [ ] **deleteFolder(originKey, guid, mediaID?)**
+  - ✅ Success: Delete empty folder
+  - ✅ Success: Delete folder with assets
+  - ❌ Error: Delete non-existent folder
+
+- [ ] **renameFolder(folderName, newFolderName, guid, mediaID?)**
+  - ✅ Success: Rename existing folder
+  - ❌ Error: Rename to existing folder name
+  - ❌ Error: Rename non-existent folder
+
+### 2. BatchMethods (`src/apiMethods/batchMethods.ts`)
+
+#### Batch Retrieval & Types
+- [ ] **getBatch(batchID, guid, expandItems?)**
+  - ✅ Success: Get batch with expanded items
+  - ✅ Success: Get batch without expanded items
+  - ❌ Error: Get non-existent batch (404)
+
+- [ ] **getBatchTypes(guid)**
+  - ✅ Success: Get all batch enum types
+  - ✅ Validation: Verify enum structure and values
+
+#### Batch Operations
+- [ ] **publishBatch(batchID, guid, returnBatchId?)**
+  - ✅ Success: Publish batch and wait for completion
+  - ✅ Success: Publish batch and return immediately
+  - ❌ Error: Publish non-existent batch
+  - ❌ Error: Publish already published batch
+
+- [ ] **unpublishBatch(batchID, guid, returnBatchId?)**
+  - ✅ Success: Unpublish batch and wait for completion
+  - ✅ Success: Unpublish batch and return immediately
+  - ❌ Error: Unpublish non-published batch
+
+- [ ] **approveBatch(batchID, guid, returnBatchId?)**
+  - ✅ Success: Approve pending batch
+  - ❌ Error: Approve already approved batch
+  - ❌ Error: Approve batch without approval workflow
+
+- [ ] **declineBatch(batchID, guid, returnBatchId?)**
+  - ✅ Success: Decline pending batch
+  - ❌ Error: Decline already processed batch
+
+- [ ] **requestApprovalBatch(batchID, guid, returnBatchId?)**
+  - ✅ Success: Request approval for batch
+  - ❌ Error: Request approval for published batch
+
+#### Utility Methods
+- [ ] **Retry(method)** - Internal retry mechanism
+  - ✅ Success: Retry until batch completion
+  - ❌ Error: Timeout after max retries
+  - ❌ Error: Method throws unrecoverable error
+
+- [ ] **delay(ms)** - Internal delay utility
+  - ✅ Success: Proper delay timing
+
+### 3. ClientInstance (`src/apiMethods/clientInstance.ts`)
+
+#### URL Determination
+- [ ] **determineBaseUrl(guid)**
+  - ✅ Success: Development environment (guid with 'd')
+  - ✅ Success: Production environment (guid with 'u')
+  - ✅ Success: US2 environment (guid with 'us2')
+  - ✅ Success: Canada environment (guid with 'c')
+  - ✅ Success: Europe environment (guid with 'e')
+  - ✅ Success: Australia environment (guid with 'a')
+  - ✅ Success: Default fallback for unknown pattern
+  - ✅ Success: Override with custom baseUrl option
+
+#### Axios Instance Creation
+- [ ] **getInstance(guid)**
+  - ✅ Success: Create instance with correct base URL
+  - ✅ Success: Verify maxContentLength and maxBodyLength settings
+
+- [ ] **getAxiosInstance(guid)**
+  - ✅ Success: Create server-level axios instance
+  - ✅ Success: Verify correct API version path
+
+#### HTTP Methods
+- [ ] **executeGet(apiPath, guid, token)**
+  - ✅ Success: GET request with valid token
+  - ❌ Error: GET request with invalid token (401)
+  - ❌ Error: GET request to non-existent endpoint (404)
+
+- [ ] **executePost(apiPath, guid, token, data)**
+  - ✅ Success: POST request with valid data
+  - ❌ Error: POST request with invalid data (400)
+  - ❌ Error: POST request with invalid token (401)
+
+- [ ] **executeDelete(apiPath, guid, token, data?)**
+  - ✅ Success: DELETE request without data
+  - ✅ Success: DELETE request with data
+  - ❌ Error: DELETE request with invalid token (401)
+
+- [ ] **executeServerGet(apiPath, guid, token)**
+  - ✅ Success: Server-level GET request
+  - ❌ Error: Server-level request with invalid token
+
+### 4. ContainerMethods (`src/apiMethods/containerMethods.ts`)
+
+#### Container Retrieval
+- [ ] **getContainerByID(id, guid)**
+  - ✅ Success: Get existing container by ID
+  - ❌ Error: Get non-existent container (404)
+
+- [ ] **getContainersByModel(modelId, guid)**
+  - ✅ Success: Get containers for existing model
+  - ✅ Success: Handle empty results for model with no containers
+  - ❌ Error: Get containers for non-existent model
+
+- [ ] **getContainerByReferenceName(referenceName, guid)**
+  - ✅ Success: Get existing container by reference name
+  - ✅ Success: Return null for non-existent container (404 handling)
+  - ❌ Error: Other errors (not 404) should throw
+
+- [ ] **getContainerList(guid)**
+  - ✅ Success: Get all containers
+  - ✅ Success: Verify container structure and required fields
+
+#### Container Security & Notifications
+- [ ] **getContainerSecurity(id, guid)**
+  - ✅ Success: Get security settings for container
+  - ❌ Error: Get security for non-existent container
+
+- [ ] **getNotificationList(id, guid)**
+  - ✅ Success: Get notifications for container
+  - ✅ Success: Handle empty notification list
+  - ❌ Error: Get notifications for non-existent container
+
+#### Container Modification
+- [ ] **saveContainer(container, guid, forceReferenceName?)**
+  - ✅ Success: Create new container
+  - ✅ Success: Update existing container
+  - ✅ Success: Force reference name update
+  - ❌ Error: Invalid container data
+  - ❌ Error: Duplicate reference name without force flag
+
+- [ ] **deleteContainer(id, guid)**
+  - ✅ Success: Delete empty container
+  - ❌ Error: Delete container with content
+  - ❌ Error: Delete non-existent container
+
+### 5. ContentMethods (`src/apiMethods/contentMethods.ts`)
+
+#### Content Item Operations
+- [ ] **getContentItem(contentID, guid, locale)**
+  - ✅ Success: Get existing content item
+  - ❌ Error: Get non-existent content item (404)
+  - ❌ Error: Get content item for invalid locale
+
+- [ ] **saveContentItem(contentItem, guid, locale, returnBatchId?)**
+  - ✅ Success: Create new content item
+  - ✅ Success: Update existing content item
+  - ✅ Success: Return batch ID immediately
+  - ❌ Error: Invalid content data
+  - ❌ Error: Missing required fields
+
+- [ ] **saveContentItems(contentItems, guid, locale, returnBatchId?)**
+  - ✅ Success: Bulk create content items
+  - ✅ Success: Bulk update content items
+  - ✅ Success: Mixed create/update operations
+  - ❌ Error: Invalid content array
+  - ❌ Error: Partial failure handling
+
+#### Content Workflow Operations
+- [ ] **publishContent(contentID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Publish approved content
+  - ✅ Success: Publish with comments
+  - ✅ Success: Return batch ID immediately
+  - ❌ Error: Publish non-existent content
+  - ❌ Error: Publish content without approval (if required)
+
+- [ ] **unPublishContent(contentID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Unpublish published content
+  - ✅ Success: Unpublish with comments
+  - ❌ Error: Unpublish non-published content
+
+- [ ] **contentRequestApproval(contentID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Request approval for content
+  - ✅ Success: Request approval with comments
+  - ❌ Error: Request approval for published content
+
+- [ ] **approveContent(contentID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Approve pending content
+  - ✅ Success: Approve with comments
+  - ❌ Error: Approve already approved content
+
+- [ ] **declineContent(contentID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Decline pending content
+  - ✅ Success: Decline with comments
+  - ❌ Error: Decline already processed content
+
+- [ ] **deleteContent(contentID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Delete existing content
+  - ✅ Success: Delete with comments
+  - ❌ Error: Delete non-existent content
+  - ❌ Error: Delete published content (if restricted)
+
+#### Content Listing & Filtering
+- [ ] **getContentItems(referenceName, guid, locale, listParams)**
+  - ✅ Success: Get content with basic list params
+  - ✅ Success: Get content with sorting
+  - ✅ Success: Get content with filtering
+  - ✅ Success: Get content with pagination
+  - ❌ Error: Get content for non-existent container
+
+- [ ] **getContentList(referenceName, guid, locale, listParams, filterObject?)**
+  - ✅ Success: Get content list without filter
+  - ✅ Success: Get content list with filter object
+  - ✅ Success: Get content list with showDeleted flag
+  - ✅ Success: Complex filtering scenarios
+  - ❌ Error: Invalid filter object
+
+#### Content History & Comments
+- [ ] **getContentHistory(locale, guid, contentID, take?, skip?)**
+  - ✅ Success: Get content history with default params
+  - ✅ Success: Get content history with pagination
+  - ✅ Success: Handle empty history
+  - ❌ Error: Get history for non-existent content
+
+- [ ] **getContentComments(locale, guid, contentID, take?, skip?)**
+  - ✅ Success: Get content comments with default params
+  - ✅ Success: Get content comments with pagination
+  - ✅ Success: Handle empty comments
+  - ❌ Error: Get comments for non-existent content
+
+### 6. InstanceMethods (`src/apiMethods/instanceMethods.ts`)
+
+#### Locale Operations
+- [ ] **getLocales(guid)**
+  - ✅ Success: Get all available locales
+  - ✅ Success: Verify locale structure (code, displayName, isActive)
+  - ❌ Error: Get locales with invalid credentials
+
+### 7. InstanceUserMethods (`src/apiMethods/instanceUserMethods.ts`)
+
+#### User Management
+- [ ] **getUsers(guid)**
+  - ✅ Success: Get all instance users
+  - ✅ Success: Verify user structure and roles
+  - ❌ Error: Get users without proper permissions
+
+- [ ] **saveUser(emailAddress, roles, guid, firstName?, lastName?)**
+  - ✅ Success: Create new user with required fields
+  - ✅ Success: Create user with optional fields
+  - ✅ Success: Update existing user roles
+  - ❌ Error: Create user with invalid email
+  - ❌ Error: Create user with invalid roles
+  - ❌ Error: Duplicate user creation
+
+- [ ] **deleteUser(userId, guid)**
+  - ✅ Success: Delete existing user
+  - ❌ Error: Delete non-existent user
+  - ❌ Error: Delete user without proper permissions
+
+### 8. ModelMethods (`src/apiMethods/modelMethods.ts`)
+
+#### Model Retrieval
+- [ ] **getContentModel(id, guid)**
+  - ✅ Success: Get existing content model by ID
+  - ❌ Error: Get non-existent model (404)
+
+- [ ] **getModelByReferenceName(referenceName, guid)**
+  - ✅ Success: Get existing model by reference name
+  - ❌ Error: Get model by non-existent reference name
+
+- [ ] **getContentModules(includeDefaults, guid, includeModules?)**
+  - ✅ Success: Get content modules with defaults
+  - ✅ Success: Get content modules without defaults
+  - ✅ Success: Get content modules with module details
+  - ✅ Success: Verify module structure and properties
+
+- [ ] **getPageModules(includeDefault, guid)**
+  - ✅ Success: Get page modules with defaults
+  - ✅ Success: Get page modules without defaults
+  - ✅ Success: Verify page module structure
+
+#### Model Modification
+- [ ] **saveModel(model, guid)**
+  - ✅ Success: Create new model
+  - ✅ Success: Update existing model
+  - ❌ Error: Invalid model data
+  - ❌ Error: Duplicate model reference name
+
+- [ ] **deleteModel(id, guid)**
+  - ✅ Success: Delete unused model
+  - ❌ Error: Delete model in use
+  - ❌ Error: Delete non-existent model
+
+### 9. PageMethods (`src/apiMethods/pageMethods.ts`)
+
+#### Sitemap & Templates
+- [ ] **getSitemap(guid, locale)**
+  - ✅ Success: Get complete sitemap
+  - ✅ Success: Verify sitemap structure and hierarchy
+  - ❌ Error: Get sitemap for invalid locale
+
+- [ ] **getPageTemplates(guid, locale, includeModuleZones, searchFilter?)**
+  - ✅ Success: Get all page templates
+  - ✅ Success: Get templates with module zones
+  - ✅ Success: Get templates with search filter
+  - ✅ Success: Handle empty search results
+
+- [ ] **getPageTemplate(guid, locale, pageTemplateId)**
+  - ✅ Success: Get existing page template by ID
+  - ❌ Error: Get non-existent template (404)
+
+- [ ] **getPageTemplateName(guid, locale, templateName)**
+  - ✅ Success: Get existing page template by name
+  - ❌ Error: Get template by non-existent name
+
+- [ ] **getPageItemTemplates(guid, locale, id)**
+  - ✅ Success: Get page template items/sections
+  - ✅ Success: Verify section definition structure
+  - ❌ Error: Get items for non-existent template
+
+#### Template Management
+- [ ] **savePageTemplate(guid, locale, pageModel)**
+  - ✅ Success: Create new page template
+  - ✅ Success: Update existing page template
+  - ❌ Error: Invalid page template data
+  - ❌ Error: Duplicate template name
+
+- [ ] **deletePageTemplate(guid, locale, pageTemplateId)**
+  - ✅ Success: Delete unused page template
+  - ❌ Error: Delete template in use
+  - ❌ Error: Delete non-existent template
+
+#### Page Operations
+- [ ] **getPage(pageID, guid, locale)**
+  - ✅ Success: Get existing page
+  - ❌ Error: Get non-existent page (404)
+  - ❌ Error: Get page for invalid locale
+
+- [ ] **savePage(pageItem, guid, locale, parentPageID?, placeBeforePageItemID?, returnBatchId?, pageIDInOtherLocale?, otherLocale?)**
+  - ✅ Success: Create new page with minimal params
+  - ✅ Success: Create page with parent page
+  - ✅ Success: Create page with positioning
+  - ✅ Success: Create page with locale linking
+  - ✅ Success: Update existing page
+  - ❌ Error: Invalid page data
+  - ❌ Error: Invalid parent page ID
+
+#### Page Workflow Operations
+- [ ] **publishPage(pageID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Publish approved page
+  - ✅ Success: Publish with comments
+  - ❌ Error: Publish non-existent page
+  - ❌ Error: Publish page without approval (if required)
+
+- [ ] **unPublishPage(pageID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Unpublish published page
+  - ✅ Success: Unpublish with comments
+  - ❌ Error: Unpublish non-published page
+
+- [ ] **pageRequestApproval(pageID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Request approval for page
+  - ✅ Success: Request approval with comments
+  - ❌ Error: Request approval for published page
+
+- [ ] **approvePage(pageID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Approve pending page
+  - ✅ Success: Approve with comments
+  - ❌ Error: Approve already approved page
+
+- [ ] **declinePage(pageID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Decline pending page
+  - ✅ Success: Decline with comments
+  - ❌ Error: Decline already processed page
+
+- [ ] **deletePage(pageID, guid, locale, comments?, returnBatchId?)**
+  - ✅ Success: Delete existing page
+  - ✅ Success: Delete with comments
+  - ❌ Error: Delete non-existent page
+  - ❌ Error: Delete published page (if restricted)
+
+#### Page History & Comments
+- [ ] **getPageHistory(locale, guid, pageID, take?, skip?)**
+  - ✅ Success: Get page history with default params
+  - ✅ Success: Get page history with pagination
+  - ✅ Success: Handle empty history
+  - ❌ Error: Get history for non-existent page
+
+- [ ] **getPageComments(locale, guid, pageID, take?, skip?)**
+  - ✅ Success: Get page comments with default params
+  - ✅ Success: Get page comments with pagination
+  - ✅ Success: Handle empty comments
+  - ❌ Error: Get comments for non-existent page
+
+### 10. ServerUserMethods (`src/apiMethods/serverUserMethods.ts`)
+
+#### Server User Operations
+- [ ] **me(guid)**
+  - ✅ Success: Get current user information
+  - ✅ Success: Verify user structure (id, email, permissions)
+  - ❌ Error: Get user info with invalid token
+
+- [ ] **you(guid, serverUserID)**
+  - ✅ Success: Get specific user information
+  - ❌ Error: Get non-existent user
+  - ❌ Error: Get user without proper permissions
+
+### 11. WebhookMethods (`src/apiMethods/webhookMethods.ts`)
+
+#### Webhook Management
+- [ ] **webhookList(guid, take?, token?)**
+  - ✅ Success: Get all webhooks with default params
+  - ✅ Success: Get webhooks with custom page size
+  - ✅ Success: Handle empty webhook list
+
+- [ ] **getWebhook(guid, webhookID)**
+  - ✅ Success: Get existing webhook
+  - ❌ Error: Get non-existent webhook (404)
+
+- [ ] **saveWebhook(guid, webhook)**
+  - ✅ Success: Create new webhook
+  - ✅ Success: Update existing webhook
+  - ❌ Error: Invalid webhook data
+  - ❌ Error: Duplicate webhook URL
+
+- [ ] **deleteWebhook(guid, webhookID)**
+  - ✅ Success: Delete existing webhook
+  - ❌ Error: Delete non-existent webhook
+
+## Integration Tests Overview
+
+Integration tests validate that all Management API methods work correctly with real API endpoints. These tests ensure comprehensive coverage of SDK functionality without mocks.
+
+## Test Organization Structure
+
+### Test File Structure
+```
+tests/
+├── integration/
+│   ├── assets/
+│   │   ├── assetMethods.test.ts
+│   │   ├── galleries.test.ts
+│   │   └── folders.test.ts
+│   ├── batch/
+│   │   ├── batchMethods.test.ts
+│   │   └── batchWorkflow.test.ts
+│   ├── content/
+│   │   ├── contentMethods.test.ts
+│   │   ├── contentWorkflow.test.ts
+│   │   └── contentListing.test.ts
+│   ├── pages/
+│   │   ├── pageMethods.test.ts
+│   │   ├── pageTemplates.test.ts
+│   │   └── pageWorkflow.test.ts
+│   ├── models/
+│   │   └── modelMethods.test.ts
+│   ├── containers/
+│   │   └── containerMethods.test.ts
+│   ├── users/
+│   │   ├── instanceUserMethods.test.ts
+│   │   └── serverUserMethods.test.ts
+│   ├── webhooks/
+│   │   └── webhookMethods.test.ts
+│   ├── instance/
+│   │   └── instanceMethods.test.ts
+│   ├── client/
+│   │   └── clientInstance.test.ts
+├── utils/
+│   ├── fixtures.ts          # Test data fixtures
+│   ├── testClient.ts        # Test client setup
+│   ├── cleanup.ts           # Test cleanup utilities
+│   └── dependencies.ts      # Dependency management utilities
+└── setup.ts                 # Global test setup
+```
+
+### Test Priority Levels
+
+#### Priority 1 (Critical) - Dependency-Ordered Core Operations
+**Creation Order**: Galleries → Assets → Models → Containers → Content → Templates → Pages
+- Gallery CRUD operations
+- Asset upload/delete operations
+- Model CRUD operations
+- Container CRUD operations
+- Content item CRUD operations
+- Page template CRUD operations
+- Page CRUD operations
+
+#### Priority 2 (High) - Workflow Operations
+- Content workflow (publish/unpublish/approve/decline)
+- Page workflow operations
+- Batch operations and polling
+
+#### Priority 3 (Medium) - Advanced Features & Integration
+- Asset gallery management
+- Folder operations
+- Content filtering and search
+- Page template management
+- User management operations
+- Webhook management
+
+#### Priority 4 (Low) - Utility & Edge Cases
+- Client instance URL determination
+- Retry mechanisms
+- Error handling edge cases
+- Pagination edge cases
+
+## Test Data Management
+
+### Test Data Strategy
+1. **Dedicated Test Content**: Create test-specific content models, containers, and content items
+2. **Dependency-Aware Creation**: Create test data in dependency order to avoid conflicts
+3. **Reverse-Order Cleanup**: Clean up test data in reverse dependency order
+4. **Data Isolation**: Use unique identifiers (timestamps, UUIDs) to avoid conflicts
+5. **Test Fixtures**: Create reusable test data fixtures for common scenarios
+
+### Test Data Dependencies & Creation Order
+
+The following dependency chain must be respected for test data creation:
+
+1. **Galleries** → 2. **Assets** → 3. **Models** → 4. **Containers** → 5. **Content** → 6. **Templates** → 7. **Pages**
+
+#### Creation Order Details:
+1. **Galleries**: Create asset galleries first (no dependencies)
+2. **Assets**: Upload assets to galleries and folders (depends on galleries)
+3. **Models**: Create content and page models (no dependencies on assets)
+4. **Containers**: Create containers using models (depends on models)
+5. **Content**: Create content items in containers (depends on containers, may reference assets)
+6. **Templates**: Create page templates using models (depends on models, may reference content)
+7. **Pages**: Create pages using templates and content (depends on templates, containers, content)
+
+#### Cleanup Order (Reverse):
+7. **Pages** → 6. **Templates** → 5. **Content** → 4. **Containers** → 3. **Models** → 2. **Assets** → 1. **Galleries**
+
+### Required Test Models
+- **TestArticle**: Basic content model for content operations
+- **TestPage**: Basic page model for page operations
+- **TestContainer**: Container for testing container operations
+- **TestGallery**: Asset gallery for testing gallery operations
+- **TestPageTemplate**: Page template for testing page operations
+
+### Environment-Specific Considerations
+- **Development Environment**: Full test suite with create/delete operations
+- **Staging Environment**: Read-only tests for critical operations
+- **Production Environment**: No tests (safety measure)
+
+## Implementation Guidelines
+
+### Test Structure Standards
+1. **Arrange-Act-Assert**: Clear test structure
+2. **Descriptive Names**: Test names should clearly describe the scenario
+3. **Error Testing**: Always test both success and error scenarios
+4. **Dependency-Aware Cleanup**: Ensure proper cleanup of created test data in reverse dependency order
+5. **Retry Logic**: Implement retry logic for flaky network operations and CDN propagation
+6. **CDN Propagation Handling**: Account for CDN propagation delays with appropriate timeouts
+
+### Dependency Management Implementation
+
+#### Test Data Creation Strategy
+```typescript
+class TestDataManager {
+  private createdData: {
+    galleries: number[];
+    assets: number[];
+    models: number[];
+    containers: number[];
+    content: number[];
+    templates: number[];
+    pages: number[];
+  } = {
+    galleries: [],
+    assets: [],
+    models: [],
+    containers: [],
+    content: [],
+    templates: [],
+    pages: []
+  };
+
+  // Create test data in dependency order
+  async setupTestData(): Promise<void> {
+    // 1. Create galleries
+    const gallery = await this.createTestGallery();
+    this.createdData.galleries.push(gallery.id);
+
+    // 2. Upload assets (depends on galleries)
+    const asset = await this.uploadTestAsset(gallery.id);
+    this.createdData.assets.push(asset.mediaID);
+
+    // 3. Create models (no dependencies)
+    const model = await this.createTestModel();
+    this.createdData.models.push(model.id);
+
+    // 4. Create containers (depends on models)
+    const container = await this.createTestContainer(model.id);
+    this.createdData.containers.push(container.id);
+
+    // 5. Create content (depends on containers, may reference assets)
+    const content = await this.createTestContent(container.id, asset.url);
+    this.createdData.content.push(content.id);
+
+    // 6. Create templates (depends on models)
+    const template = await this.createTestTemplate(model.id);
+    this.createdData.templates.push(template.id);
+
+    // 7. Create pages (depends on templates, containers, content)
+    const page = await this.createTestPage(template.id, content.id);
+    this.createdData.pages.push(page.id);
+  }
+
+  // Clean up test data in reverse dependency order
+  async cleanupTestData(): Promise<void> {
+    try {
+      // 7. Delete pages first
+      for (const pageId of this.createdData.pages) {
+        await this.deleteTestPage(pageId);
+      }
+
+      // 6. Delete templates
+      for (const templateId of this.createdData.templates) {
+        await this.deleteTestTemplate(templateId);
+      }
+
+      // 5. Delete content
+      for (const contentId of this.createdData.content) {
+        await this.deleteTestContent(contentId);
+      }
+
+      // 4. Delete containers
+      for (const containerId of this.createdData.containers) {
+        await this.deleteTestContainer(containerId);
+      }
+
+      // 3. Delete models
+      for (const modelId of this.createdData.models) {
+        await this.deleteTestModel(modelId);
+      }
+
+      // 2. Delete assets
+      for (const assetId of this.createdData.assets) {
+        await this.deleteTestAsset(assetId);
+      }
+
+      // 1. Delete galleries last
+      for (const galleryId of this.createdData.galleries) {
+        await this.deleteTestGallery(galleryId);
+      }
+    } catch (error) {
+      console.error('Cleanup failed:', error);
+      // Continue cleanup even if some items fail
+    }
+  }
+}
+```
+
+#### CDN Test Implementation
+```typescript
+class CDNValidator {
+  private config: CDNTestConfig;
+  private fetchClient: any; // Agility Fetch API client
+
+  async validateContentOnCDN(contentId: number, locale: string): Promise<boolean> {
+    // Wait for CDN propagation with exponential backoff
+    const maxAttempts = 10;
+    const baseDelay = 2000; // 2 seconds
+
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+      try {
+        const cdnContent = await this.fetchClient.getContentItem({
+          contentID: contentId,
+          locale: locale
+        });
+
+        if (cdnContent) {
+          return await this.validateContentStructure(cdnContent);
+        }
+      } catch (error) {
+        if (attempt === maxAttempts) {
+          throw new Error(`Content ${contentId} not available on CDN after ${maxAttempts} attempts`);
+        }
+
+        // Exponential backoff
+        const delay = baseDelay * Math.pow(2, attempt - 1);
+        await new Promise(resolve => setTimeout(resolve, delay));
+      }
+    }
+
+    return false;
+  }
+
+  async validatePageOnCDN(pageId: number, locale: string): Promise<boolean> {
+    // Similar implementation for pages
+    // Include validation of page structure, modules, and content
+  }
+
+  async validateAssetOnCDN(assetUrl: string): Promise<boolean> {
+    try {
+      const response = await fetch(assetUrl);
+      return response.ok;
+    } catch (error) {
+      return false;
+    }
+  }
+}
+```
+
+### Performance Considerations
+1. **Rate Limiting**: Implement delays between tests to respect API rate limits
+2. **Dependency-Aware Parallel Execution**: Group tests by dependency level for safe parallel execution
+3. **CDN Propagation Timeouts**: Set appropriate timeouts for CDN validation (30-60 seconds)
+4. **Test Duration**: Account for CDN propagation in test duration estimates
+5. **Resource Management**: Monitor API usage and CDN requests during test runs
+6. **Batch Operations**: Use batch operations where possible to reduce API calls
+
+### Coverage Metrics
+- **Method Coverage**: 100% of public methods tested
+- **Scenario Coverage**: Success, error, and edge cases covered
+- **Parameter Coverage**: All parameter combinations tested
+- **Integration Coverage**: End-to-end workflows tested
+
+## Test Execution Strategy
+
+### Test Suites
+1. **Smoke Tests**: Quick validation of core functionality
+2. **Regression Tests**: Full test suite for release validation
+3. **Workflow Tests**: End-to-end business process validation
+4. **Performance Tests**: API response time and throughput validation
+
+### Continuous Integration
+- Run smoke tests on every commit
+- Run full test suite on pull requests
+- Run regression tests on releases
+- Monitor test performance and API health
+
+## Success Criteria
+- [ ] All 82 identified API methods have comprehensive test coverage
+- [ ] All success scenarios are tested with real API calls
+- [ ] All error scenarios are properly handled and tested
+- [ ] **Dependency Management**: Test data creation and cleanup follows strict dependency order
+- [ ] **End-to-End Flows**: Complete workflow operations are validated
+- [ ] Test suite runs reliably in CI/CD environment with proper cleanup
+- [ ] Test data is properly managed with zero test data leakage
+- [ ] Test execution time is reasonable (< 30 minutes for full suite)
+- [ ] Test results provide clear feedback on SDK functionality
+- [ ] **Self-Cleaning Tests**: No manual intervention required for test data cleanup