Migration Guides

Audience: Users upgrading from previous versions of ActingWeb.

This section provides guides for migrating between ActingWeb versions and avoiding common pitfalls.

Contents

• Migrating to ActingWeb 3.11
  • Overview
  • Who Needs to Migrate?
  • Required: Database
  • Breaking Changes
  • Behavioral Changes to Verify
  • Dependencies
  • New Optional Features (no action required)
  • Backward Compatibility
• Migrating to ActingWeb 3.10
  • Overview
  • Who Needs to Migrate?
  • New Components
  • Migration Guide
  • Configuration Reference
  • Testing Your Migration
  • Backward Compatibility
  • Troubleshooting
  • Breaking Change: Bucket Naming Convention
  • Peer Permissions Caching
  • Multi-Provider OAuth Support
  • See Also
• Migrating to ActingWeb 3.7
  • Overview
  • Who Needs to Migrate?
  • Breaking Changes
  • Migration Guide
  • Architecture Changes
  • Testing Your Migration
  • Benefits of Upgrading
  • Backward Compatibility
  • Summary
• ActingWeb v3.1 Migration Guide
• Overview of Changes
• Migration Steps
  • Step 1: Replace OnAWBase Class
  • Step 2: Update Handler Instantiation
  • Step 3: Update Flask Integration
• Hook Type Mapping
  • OnAWBase Method Mapping
• Hook Function Signatures
  • Property Hooks
  • Callback Hooks
  • Application-Level Callback Hooks
  • Method Hooks
  • Action Hooks
  • Lifecycle Hooks
  • Subscription Hooks
• Benefits of Migration
• Common Migration Issues
  • Type Errors
  • Missing Imports
  • Handler Parameters
• Need Help?
• Common Pitfalls
  • Actor vs ActorInterface
  • Hooks: returning None
  • Properties vs Property Lists
  • Base paths in templates
  • OAuth providers
  • DynamoDB local vs AWS
  • Devtest endpoints

Version Migrations

v3.11 Migration

Guide for upgrading to ActingWeb 3.11, covering the one new PostgreSQL migration (chain_id index), DynamoDB TTL for token cleanup, SPA/mobile refresh-token rotation hardening, the SPA OAuth redirect_uri allowlist, the removal of the optional MCP SDK objects, and the new Apple/GitHub/Google-native sign-in providers.

v3.10 Migration

Guide for upgrading to ActingWeb 3.10, covering automatic subscription processing with CallbackProcessor, RemotePeerStore, FanOutManager, and peer capabilities.

v3.7 Migration

Guide for upgrading to ActingWeb 3.7, covering developer API extensions for SubscriptionManager and TrustManager with cleaner APIs and automatic lifecycle hooks.

v3.1 Migration

Guide for upgrading to ActingWeb 3.1, including changes to the developer API, unified access control, and handler architecture.

Common Issues

Common Pitfalls

Frequently encountered issues and their solutions when working with ActingWeb.

Migration Checklist

When upgrading ActingWeb:

1. Read the relevant migration guide

2. Review breaking changes

3. Update your configuration

4. Test in development environment

5. Run your test suite

6. Deploy with monitoring

See Also

• Configuration Reference - Configuration reference

• Troubleshooting - Troubleshooting guide

• CHANGELOG - Full changelog