# Changelog of Notion AI Database Extractor & Sync Tool (`tuguidragos/notion-ai-database-sync`) Actor

- **URL**: https://apify.com/tuguidragos/notion-ai-database-sync/changelog.md
- **Full Actor documentation**: https://apify.com/tuguidragos/notion-ai-database-sync.md

### \[1.3.x]

#### Added

- **Request Timeouts**: Safety mechanism to abort requests that hang longer than 30 seconds.
- **Strict Mode**: New input option to control whether AI errors should stop the entire process.
- **AI Concurrency**: New input option to fine-tune the number of parallel AI summarization tasks (1-50).
- **Environment Validation**: Rigorous validation for configuration values to prevent runtime errors.

#### Changed

- **Performance**: Significant reduction in memory usage and processing overhead by optimizing AI client integration.
- **Performance**: Faster webhook signature generation using native system libraries instead of third-party dependencies.
- **Infrastructure**: Deployment process now guarantees fresh code compilation using multi-stage builds.
- **UX**: Improved error messages for timeouts and external API failures.

#### Fixed

- **Critical Stability**: Resolved a memory leak issue that caused crashes when processing drastically large datasets with webhooks enabled.
- **Data Integrity**: Optimized state saving to prevent data loss in long-running jobs and increased change-tracking capacity.
- **AI Reliability**: Corrected retry delays to respect rate limit headers properly.
- **URL Generation**: Fixed an issue where generated URLs did not respect custom Notion workspace domains.

### \[1.2.0]

#### Fixed

- **Critical Data Output**: Resolved an issue where the dataset would appear empty due to silent input failures.
- **Input Validation**: Added explicit error messages when required configuration is missing.

#### Changed

- **Documentation**: Input schema now features emojis, professional formatting, and clearer help text.
- **Dataset Schema**: Output fields are now fully documented with descriptions and real-world examples.
- **State Management**: Incremental sync now deterministically handles old entry cleanup.
- **AI Summaries**: Language detection is now automatic and prompt handling is more efficient.

### \[1.1.0]

#### Added

- **AI Summarization**: Integration with OpenAI (GPT-4o/mini) to generate content summaries.
- **Multi-language Support**: Summaries are generated in the detected language of the content.
- **Incremental Sync**: Smart tracking of changes to only process new or updated items.
- **Webhooks**: Secure event notifications with HMAC-SHA256 signatures.
- **Resilience**: Automatic rate limiting and exponential backoff retry logic.
- **Dry Run**: Testing mode to simulate execution without saving state or firing webhooks.
- **Safety Limits**: Configurable maximum item limit to control processing costs.

#### Changed

- **Architecture**: Migrated codebase to modern ECMAScript Modules (ESM).
- **Data Normalization**: Enhanced handling of all Notion property types (formulas, rollups, etc.).

#### Fixed

- **Rate Limiting**: Resolved 429 errors from Notion and OpenAI APIs.
- **Reliability**: Improved webhook delivery guarantee with retries.

### \[1.0.0]

#### Added

- Initial release with basic Notion database extraction.
- Support for pagination and large databases.
- Basic property normalization and dataset export.