Add debug mode

composer.json

@@ -24,8 +24,8 @@
     },
     "require": {
         "php": "^8.2",
-        "croct/plug-php": "0.1.0",
-        "croct/plug-symfony": "0.1.0"
+        "croct/plug-php": "0.2.0",
+        "croct/plug-symfony": "0.2.0"
     },
     "require-dev": {
         "croct/coding-standard": "^0.4.5",

croct.services.yml

@@ -32,6 +32,7 @@ services:
       - '@Drupal\croct\LanguageManagerLocaleResolver'
       - null
       - '@logger.channel.croct'
+      - '%croct.debug%'
       - 86400
       - '@Drupal\croct\AccountIdentityResolver'
     tags:

src/CroctServiceProvider.php

@@ -24,6 +24,10 @@ public function register(ContainerBuilder $container): void
         $container->setParameter('croct.app_id', self::setting('croct.app_id'));
         $container->setParameter('croct.api_key', self::setting('croct.api_key'));
 
+        // Forwards a debug flag to the browser SDK. Off by default; enable it in settings.php
+        // (where Drupal's other development toggles live) with $settings['croct.debug'] = true.
+        $container->setParameter('croct.debug', self::debug());
+
         // The SDK loader is served first-party from croct.script.url through CroctScriptProvider;
         // default to the CDN loader, allowing an override (e.g. a pinned version) via settings.
         $container->setParameter('croct.script.url', self::scriptUrl());
@@ -76,4 +80,9 @@ private static function storyblokEnabled(): bool
     {
         return Settings::get('croct.storyblok.enabled', true) !== false;
     }
+
+    private static function debug(): bool
+    {
+        return Settings::get('croct.debug', false) === true;
+    }
 }

tests/CroctServiceProviderTest.php

@@ -37,6 +37,30 @@ public function testBridgesCredentialsFromSettings(): void
         self::assertSame('', $container->getParameter('croct.api_key'));
     }
 
+    #[TestDox('Defaults debug to off.')]
+    public function testDefaultsDebugOff(): void
+    {
+        new Settings([]);
+
+        $container = new ContainerBuilder();
+
+        (new CroctServiceProvider())->register($container);
+
+        self::assertFalse($container->getParameter('croct.debug'));
+    }
+
+    #[TestDox('Enables debug through settings.')]
+    public function testEnablesDebugThroughSettings(): void
+    {
+        new Settings(['croct.debug' => true]);
+
+        $container = new ContainerBuilder();
+
+        (new CroctServiceProvider())->register($container);
+
+        self::assertTrue($container->getParameter('croct.debug'));
+    }
+
     #[TestDox('Defaults the loader URL to the CDN script.')]
     public function testDefaultsScriptUrl(): void
     {