docs: update versions to 0.1.233, expand cookbook, and fix oauth2 test panic

- Updated `docs/GETTING_STARTED.md` and `docs/cookbook/src/getting_started/installation.md` to reference version `0.1.233`.
- Expanded `docs/cookbook/src/learning/README.md` with an internal learning path.
- Added code examples to `docs/cookbook/src/crates/rustapi_jobs.md` and documentation for `insight` in `rustapi_extras`.
- Fixed a panic in `rustapi-extras` property tests (`oauth2::tokens::property_tests::prop_token_expiration_tracking`) caused by subtraction overflow.

Co-authored-by: Tuntii <121901995+Tuntii@users.noreply.github.com>

Author: google-labs-jules[bot]

crates/rustapi-extras/src/oauth2/tokens.rs

@@ -362,7 +362,7 @@ mod property_tests {
             // Remaining time should be close to expires_in (within a few seconds)
             let remaining_secs = remaining.unwrap().as_secs();
             prop_assert!(remaining_secs <= expires_in_secs);
-            prop_assert!(remaining_secs >= expires_in_secs - 2); // Allow 2 sec tolerance
+            prop_assert!(remaining_secs >= expires_in_secs.saturating_sub(2)); // Allow 2 sec tolerance
         }
 
         /// Property 16: Token response builder pattern works correctly

docs/cookbook/src/crates/rustapi_extras.md

@@ -89,7 +89,7 @@ The `insight` feature provides powerful real-time traffic analysis and debugging
 
 ```toml
 [dependencies]
-rustapi-extras = { version = "0.1.233", features = ["insight"] }
+rustapi-extras = { version = "0.1", features = ["insight"] }
 ```
 
 ### Setup
@@ -98,12 +98,11 @@ rustapi-extras = { version = "0.1.233", features = ["insight"] }
 use rustapi_extras::insight::{InsightLayer, InMemoryInsightStore, InsightConfig};
 use std::sync::Arc;
 
-let store = Arc::new(InMemoryInsightStore::new(InMemoryInsightStore::default_capacity()));
+let store = Arc::new(InMemoryInsightStore::new());
 let config = InsightConfig::default();
 
 let app = RustApi::new()
-    .state(store.clone())
-    .layer(InsightLayer::with_config(config).with_store(store.clone()));
+    .layer(InsightLayer::new(config, store.clone()));
 ```
 
 ### Accessing Data

docs/cookbook/src/crates/rustapi_jobs.md

@@ -31,10 +31,9 @@ struct EmailJob {
 #[async_trait::async_trait]
 impl Job for EmailJob {
     const NAME: &'static str = "email_job";
-    type Data = EmailJob;
 
-    async fn execute(_ctx: JobContext, data: Self::Data) -> Result<()> {
-        println!("Sending email to {} with subject: {}", data.to, data.subject);
+    async fn run(&self, _ctx: JobContext) -> Result<()> {
+        println!("Sending email to {} with subject: {}", self.to, self.subject);
         // Simulate work
         tokio::time::sleep(std::time::Duration::from_millis(100)).await;
         Ok(())
@@ -58,15 +57,12 @@ async fn main() -> Result<(), Box<dyn std::error::Error>> {
     let queue = JobQueue::new(backend);
 
     // 3. Register the job type
-    // `register_job` is async and expects a job handler instance, not a type parameter.
-    queue.register_job(EmailJobHandler::new()).await?;
+    queue.register_job::<EmailJob>();
 
     // 4. Start the worker in the background
     let worker_queue = queue.clone();
     tokio::spawn(async move {
-        if let Err(err) = worker_queue.start_worker().await {
-            eprintln!("Job worker exited with error: {err}");
-        }
+        worker_queue.start_workers().await;
     });
 
     // 5. Enqueue a job