Pull back from main to dev (#35)

* Release/16.0.0 beta.2 (#32)

* Add .env file support for MCP server configuration

- Centralize configuration management in new config.ts module
- Load environment variables from .env file (default) or custom path via --env flag
- Support CLI argument overrides for all configuration options (--umbraco-*)
- Track configuration sources (CLI vs ENV) for transparency
- Add comprehensive validation and error reporting for missing credentials
- Update documentation with .env usage examples and .mcp.json configuration
- Refactor tests to use centralized config system
- Remove deprecated env.ts helper
- Improve multi-culture document test with proper setup and cleanup

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Improve copy-document tool with flattened schema and clearer workflow (#30)

- Flatten tool parameter schema for better LLM usability
  - Replace nested `id` + `data` structure with top-level parameters
  - Use `idToCopy` instead of `id` for clarity
  - Move `relateToOriginal` and `includeDescendants` to top level
  - Make `parentId` optional (omit for root, provide for specific parent)
- Add comprehensive tool description with workflow examples
  - Document the empty string return value behavior
  - Provide clear copy-only vs copy-and-update workflow patterns
  - Explain search-document requirement for post-copy operations
- Update e2e test to use update-document instead of search
  - Simplify workflow: copy → update → publish → delete
  - Remove unnecessary search-document and document-type lookups
  - Update allowed tools list to match actual workflow
- Pin mcp-server-tester to version 1.4.0 for consistency
- Update copy-document unit tests to match new schema

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Phil Whittaker <[email protected]>
Co-authored-by: Claude <[email protected]>

* Add universal media upload tools with URL and base64 support (#31)

* Update create-temporary-file to accept base64 encoded data

- Changed schema from ReadStream to base64 string input for MCP compatibility
- Converts base64 → Buffer → temp file → ReadStream for Umbraco API
- Uses os.tmpdir() for temporary file storage
- Automatic cleanup of temp files in finally block
- Updated tests to use base64 encoding
- All tests passing (11/11)

This makes the tool compatible with LLM/MCP usage where files are provided
as base64 strings rather than file system streams.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Add editorAlias and entityType to media value objects

- Updated media-builder to include editorAlias and entityType in image values
- Fixed focalPoint to use correct properties (left, top)
- Changed temporaryFileId property name (was temporaryFilId)
- Added documentation to create-media tool with complete example
- Documented API quirk in docs/comments.md
- Added experimental test-file-format tool for testing file upload formats

These fields are required by the Umbraco API but not documented in the OpenAPI spec.
Without them, media items are created but files are not properly uploaded/attached.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Add universal media upload tools with URL and base64 support

- Add create-media tool supporting filePath, URL, and base64 sources
- Add create-media-multiple tool for batch uploads (max 20 files)
- Implement automatic MIME type detection using mime-types library
- Add comprehensive media upload helpers with proper error handling
- Fix extension handling: only add to temp files, not media item names
- Add test infrastructure including builders and helpers
- Add integration tests with snapshot testing
- Support all media types: Image, File, Video, Audio, SVG, etc.

Technical improvements:
- Use mime-types library for robust MIME type to extension mapping
- Proper temp file cleanup after uploads
- SVG media type auto-correction (Image → Vector Graphic)
- Continue-on-error strategy for batch uploads
- Comprehensive test coverage with proper cleanup

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Remove obsolete TEST_FILE_FORMAT_README.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Remove obsolete test-file-format.ts

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

---------

Co-authored-by: Phil Whittaker <[email protected]>
Co-authored-by: Claude <[email protected]>

---------

Co-authored-by: Phil Whittaker <[email protected]>
Co-authored-by: Claude <[email protected]>

* Release/16.0.0 beta.2 (#34)

* Add .env file support for MCP server configuration

- Centralize configuration management in new config.ts module
- Load environment variables from .env file (default) or custom path via --env flag
- Support CLI argument overrides for all configuration options (--umbraco-*)
- Track configuration sources (CLI vs ENV) for transparency
- Add comprehensive validation and error reporting for missing credentials
- Update documentation with .env usage examples and .mcp.json configuration
- Refactor tests to use centralized config system
- Remove deprecated env.ts helper
- Improve multi-culture document test with proper setup and cleanup

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Improve copy-document tool with flattened schema and clearer workflow (#30)

- Flatten tool parameter schema for better LLM usability
  - Replace nested `id` + `data` structure with top-level parameters
  - Use `idToCopy` instead of `id` for clarity
  - Move `relateToOriginal` and `includeDescendants` to top level
  - Make `parentId` optional (omit for root, provide for specific parent)
- Add comprehensive tool description with workflow examples
  - Document the empty string return value behavior
  - Provide clear copy-only vs copy-and-update workflow patterns
  - Explain search-document requirement for post-copy operations
- Update e2e test to use update-document instead of search
  - Simplify workflow: copy → update → publish → delete
  - Remove unnecessary search-document and document-type lookups
  - Update allowed tools list to match actual workflow
- Pin mcp-server-tester to version 1.4.0 for consistency
- Update copy-document unit tests to match new schema

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Phil Whittaker <[email protected]>
Co-authored-by: Claude <[email protected]>

* Add universal media upload tools with URL and base64 support (#31)

* Update create-temporary-file to accept base64 encoded data

- Changed schema from ReadStream to base64 string input for MCP compatibility
- Converts base64 → Buffer → temp file → ReadStream for Umbraco API
- Uses os.tmpdir() for temporary file storage
- Automatic cleanup of temp files in finally block
- Updated tests to use base64 encoding
- All tests passing (11/11)

This makes the tool compatible with LLM/MCP usage where files are provided
as base64 strings rather than file system streams.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Add editorAlias and entityType to media value objects

- Updated media-builder to include editorAlias and entityType in image values
- Fixed focalPoint to use correct properties (left, top)
- Changed temporaryFileId property name (was temporaryFilId)
- Added documentation to create-media tool with complete example
- Documented API quirk in docs/comments.md
- Added experimental test-file-format tool for testing file upload formats

These fields are required by the Umbraco API but not documented in the OpenAPI spec.
Without them, media items are created but files are not properly uploaded/attached.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Add universal media upload tools with URL and base64 support

- Add create-media tool supporting filePath, URL, and base64 sources
- Add create-media-multiple tool for batch uploads (max 20 files)
- Implement automatic MIME type detection using mime-types library
- Add comprehensive media upload helpers with proper error handling
- Fix extension handling: only add to temp files, not media item names
- Add test infrastructure including builders and helpers
- Add integration tests with snapshot testing
- Support all media types: Image, File, Video, Audio, SVG, etc.

Technical improvements:
- Use mime-types library for robust MIME type to extension mapping
- Proper temp file cleanup after uploads
- SVG media type auto-correction (Image → Vector Graphic)
- Continue-on-error strategy for batch uploads
- Comprehensive test coverage with proper cleanup

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Remove obsolete TEST_FILE_FORMAT_README.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

* Remove obsolete test-file-format.ts

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

---------

Co-authored-by: Phil Whittaker <[email protected]>
Co-authored-by: Claude <[email protected]>

* Update package.json

---------

Co-authored-by: Phil Whittaker <[email protected]>
Co-authored-by: Claude <[email protected]>

---------

Co-authored-by: Phil Whittaker <[email protected]>
Co-authored-by: Claude <[email protected]>

Author: 3 people

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umbraco-cms/mcp-dev",
-  "version": "16.0.0-beta.1",
+  "version": "16.0.0-beta.2",
   "type": "module",
   "description": "A model context protocol (MCP) server for Umbraco CMS",
   "main": "index.js",