maxbeckers / amazon-alexa-php

examples/Handlers/CardResponseRequestHandler.php

<?php

declare(strict_types=1);

use MaxBeckers\AmazonAlexa\Helper\ResponseHelper;
use MaxBeckers\AmazonAlexa\Request\Request;
use MaxBeckers\AmazonAlexa\Request\Request\Standard\IntentRequest;
use MaxBeckers\AmazonAlexa\RequestHandler\AbstractRequestHandler;
use MaxBeckers\AmazonAlexa\Response\Card;
use MaxBeckers\AmazonAlexa\Response\Response;

/**
 * Just a simple example request handler for a card response.
 * To create a response with an image @see https://developer.amazon.com/de/docs/custom-skills/include-a-card-in-your-skills-response.html#creating-a-home-card-to-display-text-and-an-image
 */
class CardResponseRequestHandler extends AbstractRequestHandler
{
    public function __construct(
        private readonly ResponseHelper $responseHelper
    ) {
        parent::__construct();
        $this->supportedApplicationIds = ['my_amazon_skill_id'];
    }

    public function supportsRequest(Request $request): bool
    {
        // support all intent requests, should not be done.
        return $request->request instanceof IntentRequest;
    }

    public function handleRequest(Request $request): Response
    {
        $card = Card::createSimple(
            'Example of the Card Title',
            "Example of card content. This card has just plain text content.\nThe content is formatted with line breaks to improve readability."
        );
        $this->responseHelper->card($card);

        return $this->responseHelper->respond('Text to speak back to the user.');

The expression return $this->responseHelper->respond('Text to speak back to the user.') could return the type null which is incompatible with the type-hinted return MaxBeckers\AmazonAlexa\Response\Response. Consider adding an additional type-check to rule them out.

    }
}