test: add functional smoke coverage

Run BrowserTestBase smoke and ensure custom /jsonapi endpoints return application/json to avoid JSON:API response validation asserts.

Author: mowens3

.github/workflows/drupal-module.yml

@@ -45,7 +45,7 @@ jobs:
             coverage: false
 
     env:
-      SIMPLETEST_BASE_URL: "http://127.0.0.1"
+      SIMPLETEST_BASE_URL: "http://127.0.0.1:8888"
       SIMPLETEST_DB: "sqlite://localhost/sites/default/files/db.sqlite"
 
     steps:
@@ -82,6 +82,12 @@ jobs:
           chmod -R 777 drupal/web/sites/default/files
           chmod -R 777 drupal/web/sites/simpletest/browser_output
 
+      - name: Start test webserver
+        run: |
+          cd drupal/web
+          php -S 127.0.0.1:8888 .ht.router.php >/tmp/php-server.log 2>&1 &
+          echo $! > /tmp/php-server.pid
+
       - name: Run PHPUnit
         if: ${{ !matrix.coverage }}
         run: |
@@ -115,3 +121,10 @@ jobs:
           flags: phpunit,drupal
           fail_ci_if_error: false
           verbose: true
+
+      - name: Stop test webserver
+        if: always()
+        run: |
+          if [ -f /tmp/php-server.pid ]; then
+            kill "$(cat /tmp/php-server.pid)" || true
+          fi

src/Controller/PathResolverController.php

@@ -19,7 +19,7 @@
  */
 final class PathResolverController extends ControllerBase {
 
-  private const CONTENT_TYPE = 'application/vnd.api+json; charset=utf-8';
+  private const CONTENT_TYPE = 'application/json; charset=utf-8';
 
   public function __construct(
     private readonly PathResolverInterface $resolver,

src/Controller/RoutesFeedController.php

@@ -20,7 +20,7 @@
  */
 final class RoutesFeedController extends ControllerBase {
 
-  private const CONTENT_TYPE = 'application/vnd.api+json; charset=utf-8';
+  private const CONTENT_TYPE = 'application/json; charset=utf-8';
 
   public function __construct(
     private readonly RoutesFeedBuilder $routesFeedBuilder,

tests/src/Functional/SmokeTest.php

@@ -0,0 +1,99 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Drupal\Tests\jsonapi_frontend\Functional;
+
+use Drupal\node\Entity\Node;
+use Drupal\node\Entity\NodeType;
+use Drupal\Tests\BrowserTestBase;
+use Drupal\user\Entity\Role;
+use Drupal\user\RoleInterface;
+
+/**
+ * Smoke tests for the settings form + resolver endpoint.
+ *
+ * @group jsonapi_frontend
+ */
+#[\PHPUnit\Framework\Attributes\RunTestsInSeparateProcesses]
+final class SmokeTest extends BrowserTestBase {
+
+  /**
+   * {@inheritdoc}
+   */
+  protected static $modules = [
+    'system',
+    'user',
+    'field',
+    'text',
+    'filter',
+    'file',
+    'node',
+    'path',
+    'path_alias',
+    'serialization',
+    'jsonapi',
+    'jsonapi_frontend',
+  ];
+
+  /**
+   * {@inheritdoc}
+   */
+  protected $defaultTheme = 'stark';
+
+  public function testSettingsSaveAndResolverResponse(): void {
+    $anonymous = Role::load(RoleInterface::ANONYMOUS_ID);
+    $anonymous?->grantPermission('access content');
+    $anonymous?->save();
+
+    NodeType::create([
+      'type' => 'page',
+      'name' => 'Page',
+    ])->save();
+
+    $node = Node::create([
+      'type' => 'page',
+      'title' => 'About Us',
+      'status' => 1,
+      'path' => ['alias' => '/about-us'],
+    ]);
+    $node->save();
+
+    $admin = $this->createUser(['administer jsonapi frontend']);
+    $this->drupalLogin($admin);
+
+    $this->drupalGet('/admin/config/services/jsonapi-frontend');
+    $this->assertSession()->statusCodeEquals(200);
+
+    $this->submitForm([
+      'enable_all' => FALSE,
+      'headless_bundles[node][page]' => TRUE,
+      'resolver_cache_max_age' => 60,
+      'resolver_langcode_fallback' => 'site_default',
+    ], 'Save configuration');
+
+    $this->assertSession()->statusCodeEquals(200);
+    $this->assertSession()->pageTextContains('The configuration options have been saved.');
+
+    $this->drupalLogout();
+
+    $this->drupalGet('/jsonapi/resolve', [
+      'query' => [
+        'path' => '/about-us',
+        '_format' => 'json',
+      ],
+    ]);
+    $this->assertSession()->statusCodeEquals(200);
+
+    $payload = json_decode($this->getSession()->getPage()->getContent(), TRUE);
+    $this->assertIsArray($payload);
+    $this->assertTrue($payload['resolved']);
+    $this->assertSame('entity', $payload['kind']);
+    $this->assertSame('node--page', $payload['entity']['type']);
+    $this->assertSame($node->uuid(), $payload['entity']['id']);
+    $this->assertSame(TRUE, $payload['headless']);
+    $this->assertIsString($payload['jsonapi_url']);
+    $this->assertStringContainsString('/jsonapi/node/page/', $payload['jsonapi_url']);
+  }
+
+}