docs: emphasize bidirectional encryption capabilities

- Add clear headline about bidirectional encryption
- Include 'Why This Package?' section with use cases
- Add real-world examples (API tokens, sessions, queue messages)
- Update package.json description and keywords
- Make Laravel↔Node.js encryption sharing the main selling point

Author: Rene-Roscher

README.md

@@ -4,14 +4,25 @@
 [![CI](https://github.com/Rene-Roscher/laravel-node-encryption/actions/workflows/ci.yml/badge.svg)](https://github.com/Rene-Roscher/laravel-node-encryption/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-Laravel-compatible encryption/decryption for Node.js. Fully compatible with Laravel's built-in encryption.
+**🔐 Bidirectional encryption between Laravel (PHP) and Node.js**
+
+Share encrypted data seamlessly between your Laravel backend and Node.js services. Encrypt in Laravel, decrypt in Node.js - or vice versa!
+
+## Why This Package?
+
+Perfect for microservices, APIs, and hybrid applications where you need to:
+- 🔄 **Share encrypted data** between Laravel and Node.js applications
+- 🔒 **Encrypt in Laravel**, decrypt in Node.js (and vice versa!)
+- 🚀 **Build microservices** that share encrypted tokens, sessions, or sensitive data
+- 🛡️ **Maintain security** across different technology stacks
 
 ## Features
 
-- ✅ 100% Laravel compatible (8.x - 12.x)
-- ✅ Zero configuration (auto-detects `APP_KEY`)
-- ✅ AES-256-CBC encryption with HMAC-SHA256
-- ✅ No dependencies (optional `php-serialize` for complex objects)
+- ✅ **Fully bidirectional** - Encrypt/decrypt in both directions
+- ✅ **100% Laravel compatible** (8.x - 12.x)
+- ✅ **Zero configuration** - Auto-detects `APP_KEY`
+- ✅ **Production ready** - Battle-tested AES-256-CBC with HMAC-SHA256
+- ✅ **No dependencies** - Lightweight with optional `php-serialize`
 
 ## Installation
 
@@ -48,29 +59,44 @@ const decrypted = encrypter.decrypt(laravelEncryptedString);
 - `encryptString(value)` - Encrypts string without serialization
 - `decryptString(payload)` - Decrypts string without deserialization
 
-## Laravel Integration
+## Bidirectional Encryption Examples
 
-### PHP (Laravel)
+### 🔄 Laravel → Node.js
 ```php
+// Laravel: Encrypt data
 use Illuminate\Support\Facades\Crypt;
 
-// Encrypt
-$encrypted = Crypt::encrypt('Hello from Laravel!');
+$userData = ['id' => 1, 'email' => '[email protected]'];
+$encrypted = Crypt::encrypt($userData);
 
-// Decrypt from Node.js
-$decrypted = Crypt::decrypt($fromNodeJs);
+// Send $encrypted to Node.js service...
 ```
 
-### Node.js
 ```javascript
+// Node.js: Decrypt data from Laravel
 const { LaravelEncrypter } = require('laravel-node-encryption');
 const encrypter = new LaravelEncrypter();
 
-// Decrypt from Laravel
-const decrypted = encrypter.decrypt(fromLaravel);
+const userData = encrypter.decrypt(encryptedFromLaravel);
+console.log(userData); // { id: 1, email: '[email protected]' }
+```
+
+### 🔄 Node.js → Laravel
+```javascript
+// Node.js: Encrypt data
+const encrypter = new LaravelEncrypter();
+const token = { userId: 1, expires: '2024-12-31' };
+const encrypted = encrypter.encrypt(token);
+
+// Send encrypted to Laravel...
+```
+
+```php
+// Laravel: Decrypt data from Node.js
+use Illuminate\Support\Facades\Crypt;
 
-// Encrypt for Laravel
-const encrypted = encrypter.encrypt('Hello from Node.js!');
+$token = Crypt::decrypt($encryptedFromNode);
+// $token = ['userId' => 1, 'expires' => '2024-12-31']
 ```
 
 ## Environment Setup
@@ -86,6 +112,32 @@ Or in `.env`:
 APP_KEY=base64:your-app-key-here
 ```
 
+## Real-World Use Cases
+
+### 🔐 Secure API Tokens
+Share authentication tokens between Laravel API and Node.js microservices:
+```javascript
+// Node.js: Create encrypted token
+const token = encrypter.encrypt({ userId: 123, scope: 'api' });
+// Laravel can decrypt and validate this token
+```
+
+### 🍪 Cross-Platform Sessions
+Share session data between Laravel web app and Node.js real-time service:
+```php
+// Laravel: Encrypt session
+$sessionData = Crypt::encrypt(session()->all());
+// Node.js WebSocket server can decrypt and use session
+```
+
+### 📧 Queue Messages
+Encrypt sensitive job payloads between Laravel and Node.js workers:
+```javascript
+// Node.js: Encrypt job payload
+const job = encrypter.encrypt({ email: '[email protected]', action: 'welcome' });
+// Laravel queue worker decrypts and processes
+```
+
 ## Advanced Usage
 
 ### With explicit key

package.json

@@ -1,7 +1,7 @@
 {
   "name": "laravel-node-encryption",
   "version": "1.0.0",
-  "description": "Laravel-compatible encryption/decryption for Node.js - full compatibility with Laravel's encrypt() and decrypt()",
+  "description": "Bidirectional encryption between Laravel (PHP) and Node.js - share encrypted data seamlessly across platforms",
   "main": "src/index.js",
   "scripts": {
     "test": "jest",
@@ -14,14 +14,18 @@
     "laravel",
     "encryption",
     "decryption",
+    "bidirectional",
+    "cross-platform",
     "crypto",
     "aes",
     "aes-256-cbc",
     "php",
     "node",
     "nodejs",
     "laravel-encryption",
-    "laravel-crypt"
+    "laravel-crypt",
+    "microservices",
+    "api"
   ],
   "author": "René Roscher <[email protected]>",
   "license": "MIT",