Add Cast for JSON

README.md

@@ -89,7 +89,6 @@ Please note that the following are not required, but are strongly recommended fo
 ## Unsupported features
 
 - STRUCT data types
-- Inserting/Updating JSON data types
 
 ## Limitations
 
@@ -235,6 +234,18 @@ When fetching rows, the library coverts the following column types
 
 Note that if you execute a query without QueryBuilder, it will not have these conversions.
 
+### JSON Type
+
+In order to use JSON columns, use the provided Cast on your model as below
+
+```php
+use Colopl\Spanner\Casts\SpannerJson;
+
+protected $casts = [
+    'json_column_name' => SpannerJson::class,
+]
+```
+
 
 ### Partitioned DML
 You can run partitioned DML as below.

src/Casts/SpannerJson.php

@@ -0,0 +1,38 @@
+<?php
+
+namespace App\Casts;
+
+use Illuminate\Contracts\Database\Eloquent\CastsAttributes;
+use JsonSerializable;
+
+/**
+ * @implements CastsAttributes<array|null, array>
+ */
+class SpannerJson implements CastsAttributes
+{
+    public function get($model, $key, $value, $attributes): array|null
+    {
+        if ($value === null) {
+            return null;
+        }
+
+        if(is_array($value)) {
+            return $value;
+        }
+
+        if(!is_string($value)) {
+            throw new \InvalidArgumentException('The given value must be an array, string or null.');
+        }
+
+        return json_decode($value, true);
+    }
+
+    public function set($model, $key, $value, $attributes): array
+    {
+        if (!is_array($value) && !$value instanceof JsonSerializable && $value !== null && !is_string($value)) {
+            throw new \InvalidArgumentException('The given value must be an array, JsonSerializable, string or null.');
+        }
+
+        return [$key => new SpannerJsonType($value)];
+    }
+}