Merge branch 'master' into feature/full-text-search

CHANGELOG.md

@@ -1,6 +1,7 @@
 # v8.3.0 (2024-09-02)
 
 - add support for full text search (#231)
+- add support for invisible columns (#240)
 - add support for change streams using Blueprint (#230)
 - add support for snapshot queries (#215)
 - deprecate Connection::getDatabaseContext() and move logic to UseMutations::getMutationExecutor() (#227)

src/Schema/Grammar.php

@@ -805,6 +805,20 @@ protected function typeTokenList(Fluent $column): string
         return 'tokenlist as (' . $function->value . '(' . implode(', ', $args) . '))';
     }
 
+    /**
+     * Get the SQL for an invisible column modifier.
+     *
+     * @param Blueprint $blueprint
+     * @param ColumnDefinition&object{ invisible: bool } $column
+     * @return string|null
+     */
+    protected function modifyInvisible(Blueprint $blueprint, Fluent $column)
+    {
+        return $column->invisible !== null
+            ? ' hidden'
+            : null;
+    }
+
     /**
      * @param Blueprint $blueprint
      * @param IntColumnDefinition $column

tests/Schema/BlueprintTest.php

@@ -303,6 +303,30 @@ public function test_tokenList_and_search_index(): void
         }
     }
 
+    public function test_invisible_columns(): void
+    {
+        $conn = $this->getDefaultConnection();
+        $grammar = new Grammar();
+        $tableName = $this->generateTableName('Invisible');
+
+        $blueprint = new Blueprint($tableName, function (Blueprint $table) {
+            $table->create();
+            $table->integer('id')->primary();
+            $table->string('name')->nullable()->invisible();
+        });
+
+        $this->assertSame([
+            "create table `{$tableName}` (`id` int64 not null, `name` string(255) hidden) primary key (`id`)",
+        ], $blueprint->toSql($conn, $grammar));
+
+        $blueprint->build($conn, $grammar);
+
+        $conn->table($tableName)->insert(['id' => 1, 'name' => 'test']);
+        $row = $conn->table($tableName)->first();
+        $this->assertArrayHasKey('id', $row);
+        $this->assertArrayNotHasKey('name', $row);
+    }
+
     public function test_interleaving(): void
     {
         $conn = $this->getDefaultConnection();