This PR introduces an extensible async createContext template method to the Campaign component, allowing subclasses and future variations to customize context data before template rendering with support for asynchronous operations.

Problem

Previously, the Campaign component called getContext(...) directly during template rendering, making it impossible for subclasses to extend or modify the context without duplicating the entire render logic. This prevented scenarios like:

• Adding custom context enrichment
• Injecting feature flags or A/B test metadata
• Transforming data for specific use cases
• Fetching external data like Shopify side product data

Solution

Added an async createContext(raw: JSONResult): Promise<object> method to the Campaign class that:

• Serves as an extension point for context creation
• Is called with await instead of the direct getContext usage in loadCampaign
• Supports asynchronous operations for external data fetching
• Maintains full backward compatibility
• Includes comprehensive TypeDoc documentation with usage examples
• Uses proper Promise<object> return type for better type safety

Usage Example

class CustomCampaign extends Campaign {
  async createContext(raw) {
    const context = await super.createContext(raw);
    return { 
      ...context, 
      customProperty: 'value',
      featureFlags: await this.getFeatureFlags(),
      shopifyData: await this.fetchShopifyData()
    };
  }
}

Changes

• Added async createContext method to Campaign class with detailed documentation
• Modified loadCampaign function to use await with the instance method instead of direct getContext call
• Added test coverage verifying subclass override functionality using JSX syntax with async support
• Used proper Promise<object> return type for better type safety
• All existing tests continue to pass (161/161)

The implementation is minimal and surgical - only one line changed in the rendering logic to add await and one async method added to the class.

Fixes #314.

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.