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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
//! Customer segment operations for grouping and targeting customers
//!
//! # Example
//!
//! ```rust,ignore
//! use stateset_embedded::{Commerce, CreateSegment, SegmentType};
//!
//! let commerce = Commerce::new("./store.db")?;
//!
//! let segment = commerce.segments().create(CreateSegment {
//! name: "VIP Customers".into(),
//! segment_type: SegmentType::Static,
//! ..Default::default()
//! })?;
//!
//! println!("Segment created: {}", segment.name);
//! # Ok::<(), stateset_embedded::CommerceError>(())
//! ```
use stateset_core::{
CreateSegment, CustomerId, Result, Segment, SegmentFilter, SegmentId, SegmentMembership,
UpdateSegment,
};
use stateset_db::Database;
use std::sync::Arc;
/// Customer segment operations for grouping and targeting.
pub struct Segments {
db: Arc<dyn Database>,
}
impl std::fmt::Debug for Segments {
fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
f.debug_struct("Segments").finish_non_exhaustive()
}
}
impl Segments {
pub(crate) fn new(db: Arc<dyn Database>) -> Self {
Self { db }
}
/// Create a new customer segment.
///
/// # Example
///
/// ```rust,ignore
/// use stateset_embedded::{Commerce, CreateSegment, SegmentType};
///
/// let commerce = Commerce::new("./store.db")?;
///
/// let segment = commerce.segments().create(CreateSegment {
/// name: "High Spenders".into(),
/// segment_type: SegmentType::Dynamic,
/// description: Some("Customers who have spent over $1000".into()),
/// ..Default::default()
/// })?;
/// # Ok::<(), stateset_embedded::CommerceError>(())
/// ```
pub fn create(&self, input: CreateSegment) -> Result<Segment> {
self.db.segments().create(input)
}
/// Get a segment by ID.
pub fn get(&self, id: SegmentId) -> Result<Option<Segment>> {
self.db.segments().get(id)
}
/// Update a segment.
pub fn update(&self, id: SegmentId, input: UpdateSegment) -> Result<Segment> {
self.db.segments().update(id, input)
}
/// List segments with optional filtering.
pub fn list(&self, filter: SegmentFilter) -> Result<Vec<Segment>> {
self.db.segments().list(filter)
}
/// Delete a segment.
pub fn delete(&self, id: SegmentId) -> Result<()> {
self.db.segments().delete(id)
}
/// Add a customer to a static segment.
pub fn add_member(
&self,
segment_id: SegmentId,
customer_id: CustomerId,
) -> Result<SegmentMembership> {
self.db.segments().add_member(segment_id, customer_id)
}
/// Remove a customer from a static segment.
pub fn remove_member(&self, segment_id: SegmentId, customer_id: CustomerId) -> Result<()> {
self.db.segments().remove_member(segment_id, customer_id)
}
/// List members of a segment.
pub fn list_members(
&self,
segment_id: SegmentId,
limit: Option<u32>,
offset: Option<u32>,
) -> Result<Vec<SegmentMembership>> {
self.db.segments().list_members(segment_id, limit, offset)
}
/// Check if a customer is a member of a segment.
pub fn is_member(&self, segment_id: SegmentId, customer_id: CustomerId) -> Result<bool> {
self.db.segments().is_member(segment_id, customer_id)
}
/// Count the number of members in a segment.
pub fn count_members(&self, segment_id: SegmentId) -> Result<u64> {
self.db.segments().count_members(segment_id)
}
}