feat(http): support auto publish on form create and patch

Author: EvanSchleret

src/Http/Controllers/FormManagementController.php

@@ -476,6 +476,9 @@ public function create(Request $request, FormMutationService $mutations, Idempot
             }
 
             $definition = $mutations->create($payload, $request->user(), $owner);
+            if ($this->shouldAutoPublish($payload)) {
+                $definition = $mutations->publish((string) $definition->key, $request->user(), $owner);
+            }
             $data = $this->serializeFormDefinition($request, $mutations, $definition);
             $body = [
                 'data' => $data,
@@ -522,6 +525,9 @@ public function patch(
             }
 
             $definition = $mutations->patch($key, $payload, $request->user(), $owner);
+            if ($this->shouldAutoPublish($payload)) {
+                $definition = $mutations->publish((string) $definition->key, $request->user(), $owner);
+            }
             $data = $this->serializeFormDefinition($request, $mutations, $definition);
             $body = [
                 'data' => $data,
@@ -857,6 +863,19 @@ private function formDefinitionResourceClass(): ?string
         return $configured;
     }
 
+    private function shouldAutoPublish(array $payload): bool
+    {
+        if (array_key_exists('auto_publish', $payload)) {
+            return $this->toBool($payload['auto_publish']);
+        }
+
+        if (array_key_exists('autoPublish', $payload)) {
+            return $this->toBool($payload['autoPublish']);
+        }
+
+        return false;
+    }
+
     private function resolvedOwner(Request $request, string $action): ?OwnershipReference
     {
         $owner = $this->resolveOwner($request, $action);

tests/Feature/HttpApiTest.php

@@ -1155,6 +1155,47 @@
         ->assertJsonPath('data.title', 'Survey V2');
 });
 
+it('creates and auto publishes a form when requested', function (): void {
+    $response = $this->postJson('/api/formforge/v1/forms', [
+        'title' => 'Auto Published Create',
+        'fields' => [
+            ['type' => 'text', 'name' => 'name', 'required' => true],
+        ],
+        'auto_publish' => true,
+    ]);
+
+    $response
+        ->assertCreated()
+        ->assertJsonPath('data.is_published', true)
+        ->assertJsonPath('data.version_number', 2);
+});
+
+it('patches and auto publishes a form when requested', function (): void {
+    $create = $this->postJson('/api/formforge/v1/forms', [
+        'title' => 'Auto Published Patch V1',
+        'fields' => [
+            ['type' => 'text', 'name' => 'name', 'required' => true],
+        ],
+    ])->assertCreated();
+
+    $key = (string) $create->json('data.key');
+
+    $patch = $this->patchJson("/api/formforge/v1/forms/{$key}", [
+        'title' => 'Auto Published Patch V2',
+        'fields' => [
+            ['type' => 'text', 'name' => 'name', 'required' => true],
+            ['type' => 'email', 'name' => 'email', 'required' => true],
+        ],
+        'auto_publish' => true,
+    ]);
+
+    $patch
+        ->assertOk()
+        ->assertJsonPath('data.version_number', 3)
+        ->assertJsonPath('data.title', 'Auto Published Patch V2')
+        ->assertJsonPath('data.is_published', true);
+});
+
 it('clears form category when patched with explicit null', function (): void {
     $category = $this->postJson('/api/formforge/v1/categories', [
         'name' => 'Survey',