Macro API v3 Update
Macro API v3 - Complete Changelog
Changelog
All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
[3.0.0] - 2025-06-10
Version 3.0.0 marks a pivotal evolution of macro_api into a truly extensible and observable platform. This release introduces a powerful plugin architecture, webhook handling, new AI and database integrations, and significant breaking changes designed to standardize and future-proof the developer experience.
Added
-
Plugin Architecture Introduced a formal plugin system, allowing developers to create and share their own API wrappers that seamlessly integrate with the
macro_apicore. This enables the community to extend the library with support for any service. -
Built-in Webhook Handlers Added a new suite of tools for handling incoming webhooks from supported services. The library now includes helpers to verify webhook signatures (for services like Stripe, Slack, and GitHub) and parse payloads, simplifying a common and error-prone workflow.
-
Integrated Observability Developers can now pass a compatible logger instance (like Pino or Winston) into the core client configuration. The library will emit detailed logs for API requests, retries, cache hits/misses, and errors, providing deep visibility into the library's behavior for easier debugging.
-
New API Integration: Supabase Added a comprehensive module for Supabase. It provides a simplified interface for interacting with Supabase projects, including methods for database queries, user authentication management, and file storage operations.
-
New API Integration: Anthropic (Claude) Expanded the library's AI capabilities with a new module for the Anthropic Claude API. This allows developers to easily integrate state-of-the-art conversational AI and text processing, complementing the existing OpenAI and DeepSeek modules.
-
New API Integration: Algolia Added a module for Algolia, enabling developers to easily implement powerful, fast, and typo-tolerant search capabilities. It includes helpers for indexing data and performing complex search queries.
Changed
-
BREAKING CHANGE: Standardized Response Wrapper All methods that return a response from an external API now do so within a standardized wrapper object. The new structure provides the core data, along with valuable metadata like rate-limit status and the original request ID, for every call. This ensures ultimate consistency across all modules.
-
BREAKING CHANGE: Centralized Authentication Manager Authentication handling has been refactored. The library now encourages the use of a central
AuthManagerfor services that use OAuth 2.0. This manager can handle token refreshing automatically in the background, eliminating a significant point of failure in long-running applications. Static API keys are still configured directly in the client.
Removed
- BREAKING CHANGE: Removed Deprecated Constructors The simple, single-argument client constructors that were deprecated in version 2.0.0 have been completely removed. All API clients must now be initialized using the unified configuration object introduced in the previous version. This change finalizes the transition to a more robust and explicit configuration pattern.