fix(docs): address verified documentation gaps and lint errors

Documentation fixes (from cross-checked verification):
- E1-1: Add integer -> operator documentation for array indexing
- E1-2: Clarify sv/ste_vec is a storage field, not an index term type
- E1-3: Correct ->> return type from "ciphertext" to "encrypted value as text"
- E1-4: Document ste_vec(jsonb) overload alongside ste_vec(eql_v2_encrypted)
- E1-5: Add note about -> vs ->> operator asymmetry (integer index support)

Rust lint fixes:
- Apply cargo fmt formatting to lib.rs and containment_with_index_tests.rs

Author: tobyhede

docs/reference/database-indexes.md

@@ -218,7 +218,7 @@ B-tree indexes **only work** with:
 
 They **do not work** with:
 - `bf` (bloom_filter) - pattern matching
-- `sv` (ste_vec) - JSONB containment (use [GIN indexes](#gin-indexes-for-jsonb-containment) instead)
+- Data with `sv` field (ste_vec) - JSONB containment uses GIN indexes instead (see [GIN Indexes](#gin-indexes-for-jsonb-containment))
 - Data without any index terms
 
 ### 2. Index Creation Timing

docs/reference/json-support.md

@@ -156,10 +156,15 @@ Use standard PostgreSQL JSON operators on encrypted columns:
 -- Extract field by selector (returns eql_v2_encrypted)
 SELECT encrypted_json->'selector_hash' FROM examples;
 
--- Extract field as text (returns ciphertext)
+-- Extract field as text (returns encrypted value as text)
 SELECT encrypted_json->>'selector_hash' FROM examples;
+
+-- Extract array element by index (0-based, returns eql_v2_encrypted)
+SELECT encrypted_array->0 FROM examples;
 ```
 
+**Note:** The `->` operator supports integer array indexing (e.g., `encrypted_array->0`), but the `->>` operator does not. Use `->` to access array elements by index.
+
 ### Array operations
 
 EQL supports array operations on encrypted JSONB arrays:
@@ -218,6 +223,9 @@ GROUP BY eql_v2.jsonb_path_query_first(encrypted_json, 'color_selector');
 
 ### Core Functions
 
+- **`eql_v2.ste_vec(val jsonb) RETURNS eql_v2_encrypted[]`**
+  - Extracts the ste_vec index array from a JSONB payload
+
 - **`eql_v2.ste_vec(val eql_v2_encrypted) RETURNS eql_v2_encrypted[]`**
   - Extracts the ste_vec index array from an encrypted value
 

tests/sqlx/src/lib.rs

@@ -11,9 +11,9 @@ pub mod selectors;
 
 pub use assertions::QueryAssertion;
 pub use helpers::{
-    analyze_table, assert_uses_index, assert_uses_seq_scan, create_jsonb_gin_index,
-    explain_query, get_encrypted_term, get_ore_encrypted, get_ore_encrypted_as_jsonb,
-    get_ste_vec_encrypted, get_ste_vec_selector_term, get_ste_vec_term_by_id,
+    analyze_table, assert_uses_index, assert_uses_seq_scan, create_jsonb_gin_index, explain_query,
+    get_encrypted_term, get_ore_encrypted, get_ore_encrypted_as_jsonb, get_ste_vec_encrypted,
+    get_ste_vec_selector_term, get_ste_vec_term_by_id,
 };
 pub use index_types as IndexTypes;
 pub use selectors::Selectors;

tests/sqlx/tests/containment_with_index_tests.rs

@@ -10,8 +10,8 @@
 
 use anyhow::Result;
 use eql_tests::{
-    analyze_table, assert_uses_index, assert_uses_seq_scan, create_jsonb_gin_index,
-    explain_query, get_ste_vec_encrypted,
+    analyze_table, assert_uses_index, assert_uses_seq_scan, create_jsonb_gin_index, explain_query,
+    get_ste_vec_encrypted,
 };
 use sqlx::PgPool;
 
@@ -185,7 +185,6 @@ async fn jsonb_array_count_with_index(pool: PgPool) -> Result<()> {
     Ok(())
 }
 
-
 #[sqlx::test]
 async fn jsonb_containment_uses_seq_scan_without_index(pool: PgPool) -> Result<()> {
     // Test: Verify sequential scan is used BEFORE GIN index is created