sandbox changes

Author: miller-28

sandbox/README.md

@@ -40,7 +40,7 @@ npx serve .
 
 ## 📦 Example Categories
 
-**75+ interactive examples across 14 feature categories**
+**89 interactive examples across 16 feature categories**
 
 ### 📦 **Basic Usage**
 Core HTTP operations with Luminara's helper methods:
@@ -167,6 +167,13 @@ Automatic in-flight duplicate prevention (10 examples):
 - **Error Propagation** - Failed requests share errors with duplicates
 - **Integration with Retry** - Deduplication + retry work together
 
+### 🍪 **Cookie Jar Plugin**
+Server-side cookie management with automatic Cookie/Set-Cookie header handling (4 examples):
+- **Basic Cookie Management** - Automatic cookie storage and transmission
+- **Manual Cookie Operations** - Direct access to cookie jar for CRUD operations
+- **Shared Cookie Jar** - Share cookies across multiple client instances
+- **SSR Usage Pattern** - Server-side rendering cookie persistence
+
 ## 🏗️ Architecture
 
 ### **Separation of Concerns**
@@ -192,7 +199,9 @@ sandbox/
     ├── verboseLogging.js    # 📝 Debugging and tracing
     ├── customDriver.js      # 🚗 Driver extensibility
     ├── debouncer.js         # ⏱️ Request debouncing
-    └── deduplicator.js      # 🔄 Duplicate prevention
+    ├── deduplicator.js      # 🔄 Duplicate prevention
+    ├── requestHedging.js    # 🏎️ Request hedging
+    └── cookieJarPlugin.js   # 🍪 Cookie jar plugin
 ```
 
 ### **Layer Responsibilities**
@@ -298,13 +307,17 @@ The sandbox demonstrates the universal API that works consistently across all th
 3. **⏱️ Timeout** - Understand timeout handling
 4. **🔄 Retry** - Explore retry mechanisms
 5. **📈 Backoff Strategies** - Master advanced retry patterns
-6. **� Rate Limiting** - Control request flow with token bucket algorithm
-7. **�📦 Response Types** - Learn response handling options
-8. **🔌 Interceptors** - Implement request/response middleware
-9. **🛠️ Error Handling** - Master comprehensive error scenarios
-10. **📊 Stats System** - Explore real-time metrics and analytics
-10. **📝 Verbose Logging** - Learn debugging and tracing techniques
-11. **�🚗 Custom Driver** - Explore extensibility options
+6. **🚦 Rate Limiting** - Control request flow with token bucket algorithm
+7. **🏎️ Request Hedging** - Optimize latency with concurrent requests
+8. **📦 Response Types** - Learn response handling options
+9. **🔌 Interceptors** - Implement request/response middleware
+10. **🛠️ Error Handling** - Master comprehensive error scenarios
+11. **📊 Stats System** - Explore real-time metrics and analytics
+12. **📝 Verbose Logging** - Learn debugging and tracing techniques
+13. **🚗 Custom Driver** - Explore extensibility options
+14. **⏱️ Debouncer** - Prevent redundant rapid-fire requests
+15. **🔄 Request Deduplicator** - Eliminate concurrent duplicate requests
+16. **🍪 Cookie Jar Plugin** - Server-side cookie management
 
 Each category builds upon previous concepts, providing a comprehensive understanding of Luminara's capabilities.
 

sandbox/examples/cookieJarPlugin.js

@@ -2,6 +2,7 @@ import { createLuminara } from '../../dist/index.mjs';
 
 export const cookieJarPlugin = {
 	title: '🍪 Cookie Jar Plugin',
+	docUrl: 'https://github.com/miller-28/luminara/blob/master/docs/plugins/cookie-jar.md',
 	examples: [
 		{
 			id: 'cookie-jar-basic',

sandbox/index.html

@@ -99,6 +99,7 @@ <h3>⚡ Core Architecture</h3>
 				<h3>🔄 Request Lifecycle (Orchestration Layer)</h3>
 				<ul>
 					<li><a href="#interceptor-request" class="feature-link"><strong>Enhanced interceptor architecture</strong></a> - Deterministic order, mutable context, retry-aware</li>
+					<li><a href="#cookie-jar-basic" class="feature-link"><strong>Plugin system</strong></a> - Extensible architecture with official plugins (<a href="https://www.npmjs.com/package/luminara-cookie-jar" target="_blank" rel="noopener noreferrer" class="link">cookie-jar</a>)</li>
 					<li><a href="#stats-enabled-default" class="feature-link"><strong>Comprehensive stats system</strong></a> - Real-time metrics, analytics, and query interface</li>
 					<li><a href="#verbose-comprehensive" class="feature-link"><strong>Verbose logging system</strong></a> - Detailed debugging and request tracing</li>
 				</ul>

sandbox/main.js

@@ -302,7 +302,8 @@ class SandboxUI {
 					feature_title: feature.title
 				});
 			}
-			const docUrl = `https://github.com/miller-28/luminara/tree/master/docs/features/${docFilename}.md`;
+			// Use custom docUrl if provided, otherwise use default pattern
+			const docUrl = feature.docUrl || `https://github.com/miller-28/luminara/tree/master/docs/features/${docFilename}.md`;
 			window.open(docUrl, '_blank', 'noopener,noreferrer');
 		};
 		headerButtonContainer.appendChild(docsBtn);

sandbox/sitemap.xml

@@ -5,11 +5,6 @@
     <changefreq>weekly</changefreq>
     <priority>1.0</priority>
   </url>
-  <url>
-    <loc>https://luminara.website/docs/</loc>
-    <changefreq>weekly</changefreq>
-    <priority>0.8</priority>
-  </url>
   <url>
     <loc>https://luminara.website/benchmark</loc>
     <changefreq>weekly</changefreq>