1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
// Copyright 2025 Rigatoni Contributors
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
// SPDX-License-Identifier: Apache-2.0
//! State store implementations for Rigatoni ETL framework.
//!
//! This crate provides various backend implementations of the
//! [`StateStore`](rigatoni_core::state::StateStore) trait for persisting
//! `MongoDB` change stream resume tokens.
//!
//! # Available Stores
//!
//! - **Memory** (`memory` feature, enabled by default): In-memory state storage
//! - **Redis** (`redis-store` feature): Distributed state storage with Redis
//! - **File** (`file` feature, coming soon): File-based state storage
//!
//! # Feature Flags
//!
//! - `memory`: In-memory state store (enabled by default)
//! - `redis-store`: Redis-backed state store (requires Redis server)
//! - `file`: File-based state store (coming soon)
//! - `all-stores`: Enable all available stores
//!
//! # Example: In-Memory Store
//!
//! ```rust
//! use rigatoni_stores::memory::MemoryStore;
//! use rigatoni_core::state::StateStore;
//! use mongodb::bson::doc;
//!
//! # async fn example() -> Result<(), Box<dyn std::error::Error>> {
//! // Create in-memory store (no configuration needed)
//! let store = MemoryStore::new();
//!
//! // Save resume token
//! let token = doc! { "_data": "token123" };
//! store.save_resume_token("users", &token).await?;
//!
//! // Retrieve token
//! let retrieved = store.get_resume_token("users").await?;
//! assert!(retrieved.is_some());
//! # Ok(())
//! # }
//! ```
//!
//! # Example: Redis Store
//!
//! ```rust,ignore
//! use rigatoni_stores::redis::{RedisStore, RedisConfig};
//! use rigatoni_core::state::StateStore;
//! use mongodb::bson::doc;
//!
//! # async fn example() -> Result<(), Box<dyn std::error::Error>> {
//! // Configure Redis connection
//! let config = RedisConfig::builder()
//! .url("redis://localhost:6379")
//! .pool_size(10)
//! .build()?;
//!
//! // Create store
//! let store = RedisStore::new(config).await?;
//!
//! // Save resume token
//! let token = doc! { "_data": "token123" };
//! store.save_resume_token("users", &token).await?;
//!
//! // Retrieve token
//! let retrieved = store.get_resume_token("users").await?;
//! assert!(retrieved.is_some());
//! # Ok(())
//! # }
//! ```