Update README.md

Author: kitar

CLAUDE.md

@@ -0,0 +1,56 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+### Testing
+- Run all tests: `./vendor/bin/phpunit`
+- Run a single test: `vendor/bin/phpunit tests/Path/To/TestFile.php`
+- Run a single test method: `vendor/bin/phpunit --filter testMethodName`
+
+### Development
+- Install dependencies: `composer install`
+- Update dependencies: `composer update`
+
+## Architecture Overview
+
+This is a Laravel package that provides DynamoDB integration by adapting Laravel's database layer to work with AWS DynamoDB.
+
+### Key Design Patterns
+
+1. **Adapter Pattern**: The package adapts Laravel's database abstractions to DynamoDB
+   - `Connection` extends Laravel's base connection class
+   - `Model` extends Eloquent with DynamoDB-specific behavior
+   - Query results are processed through `Processor` to match Laravel's expectations
+
+2. **Builder Pattern**: DynamoDB queries are constructed using a fluent interface
+   - `Query\Builder` provides chainable methods
+   - Separate query objects for different DynamoDB operations (filter, condition, keyCondition)
+   - `ExpressionAttributes` manages placeholder generation for expressions
+
+3. **Grammar Translation**: `Query\Grammar` translates Laravel-style queries to DynamoDB API format
+   - Uses AWS Marshaler for type conversions
+   - Compiles expressions using DynamoDB syntax
+   - Handles reserved words and attribute name conflicts
+
+### Important Architectural Decisions
+
+- **No Eloquent Relationships**: Models intentionally don't support relationships as DynamoDB is NoSQL
+- **Primary Keys**: Models require `primaryKey` and optionally `sortKey` properties
+- **Authentication**: Custom `AuthUserProvider` supports both primary key and API token authentication using DynamoDB indexes
+- **Batch Operations**: Native support for DynamoDB batch operations (batchGetItem, batchPutItem, etc.)
+- **Testing**: Use `dryRun()` method to inspect generated DynamoDB parameters without making API calls
+
+### Testing Approach
+
+Tests use Mockery to mock AWS SDK calls. When writing tests:
+- Mock the DynamoDB client for unit tests
+- Use `dryRun()` to test query building without API calls
+- Follow existing test patterns in the `tests/` directory
+
+### Version Compatibility
+
+- PHP: 7.3, 7.4, 8.0, 8.1, 8.2, 8.3, 8.4
+- Laravel: 6.x through 12.x
+- AWS SDK: ^3.0

README.md

@@ -82,7 +82,7 @@ Install the package via Composer:
 $ composer require kitar/laravel-dynamodb
 ```
 
-### Laravel (6.x, 7.x, 8.x, 9.x, 10.x, 11.x)
+### Laravel (6.x, 7.x, 8.x, 9.x, 10.x, 11.x, 12.x)
 
 Add dynamodb configs to `config/database.php`:
 
@@ -110,6 +110,14 @@ Update the `DB_CONNECTION` variable in your `.env` file:
 DB_CONNECTION=dynamodb
 ```
 
+> **Note for Laravel 11+**: Laravel 11 and later versions default to `database` driver for session, cache, and queue, which are not compatible with this DynamoDB package. You'll need to configure these services to use alternative drivers. For instance:
+>
+> ```
+> SESSION_DRIVER=file
+> CACHE_STORE=file
+> QUEUE_CONNECTION=sync
+> ```
+
 ### Non-Laravel projects
 
 For usage outside Laravel, you can create the connection manually and start querying with [Query Builder](#query-builder).
@@ -397,7 +405,7 @@ Then specify driver and model name for authentication in `config/auth.php`.
 
 ### Registration Controller
 
-You might need to modify the registration controller. For example, if we use Laravel Breeze, the modification looks like below.
+You might need to modify the registration controller. For example, if we use Laravel Starter Kits, the modification looks like below.
 
 ```php
 class RegisteredUserController extends Controller
@@ -408,31 +416,30 @@ class RegisteredUserController extends Controller
     {
         $request->validate([
             'name' => 'required|string|max:255',
-            'email' => ['required', 'string', 'email', 'max:255', function ($attribute, $value, $fail) {
+            'email' => ['required', 'string', 'lowercase', 'email', 'max:255', function ($attribute, $value, $fail) {
                 if (User::find($value)) {
                     $fail('The '.$attribute.' has already been taken.');
                 }
             }],
-            'password' => 'required|string|confirmed|min:8',
+            'password' => ['required', 'confirmed', Rules\Password::defaults()],
         ]);
 
-        $user = new User([
+        $user = User::create([
             'name' => $request->name,
             'email' => $request->email,
             'password' => Hash::make($request->password),
         ]);
-        $user->save();
-
-        Auth::login($user);
 
         event(new Registered($user));
 
-        return redirect(RouteServiceProvider::HOME);
+        Auth::login($user);
+
+        return to_route('dashboard');
     }
 }
 ```
 
-There are two modifications. The first one is adding the closure validator for `email` instead of `unique` validator. The second one is using the `save()` method to create user instead of the `create()` method.
+The change is in the email validation rules. Instead of using the `unique` rule, we pass a closure to perform the duplicate check directly.
 
 ## Query Builder