AWS AppSync

AWSIKAppSync implements the portable real-time data role. Query and Mutate use UBetideWebRequest; Subscribe and Unsubscribe use AppSync's graphql-ws real-time protocol with acknowledgement, start/data/error/complete handling, exponential backoff, and jittered reconnect.

Configure the GraphQL HTTP endpoint and authorization mode in Project Settings > Betide > Crossplay > AWS AppSync. The real-time endpoint is derived automatically for standard AppSync domains and can be overridden for private or local endpoints.

Supported authorization modes are:

• Cognito User Pool JWT from the named environment source;
• IAM SigV4 through the shared AWS credential chain;
• API key for development or intentionally public APIs.

API keys and JWTs are read from the process environment and are never serialized to Unreal config. IAM mode signs every HTTP request with the region captured at module startup, the same value every other AWS client uses, and the shared refreshable credential source. Variables must be a JSON object. Results remain JSON so projects can layer generated or hand-written GraphQL types without losing fields.

For local tests, point both endpoints at Scripts/awsik/test-env/fake_server.py. The fake accepts deterministic query/mutation requests and emits protocol frames without needing cloud credentials.