backbone-mailing 0.4.0

Email marketing — mass-mail engine: audiences, subscriptions, hand-set mailing lifecycle, seeded A/B testing, per-recipient traces, cycle-44 bridge targets (Odoo mass_mailing port)
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
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146

//! DTOs (Data Transfer Objects)
//!
//! Generated by metaphor-schema. Do not edit manually.
//!
//! This module provides DTOs for the presentation layer,
//! with validation and OpenAPI schema support.

pub mod mailing_ab_test_dto;
pub mod mailing_audience_dto;
pub mod mailing_contact_dto;
pub mod mailing_subscription_dto;
pub mod opt_out_reason_dto;
pub mod mailing_dto;
pub mod mailing_trace_dto;
pub mod mailing_filter_dto;

// Re-exports
pub use mailing_ab_test_dto::{
    CreateMailingAbTestDto,
    UpdateMailingAbTestDto,
    PatchMailingAbTestDto,
    MailingAbTestResponseDto,
    MailingAbTestListResponseDto,
    MailingAbTestSummaryDto,
};
pub use mailing_audience_dto::{
    CreateMailingAudienceDto,
    UpdateMailingAudienceDto,
    PatchMailingAudienceDto,
    MailingAudienceResponseDto,
    MailingAudienceListResponseDto,
    MailingAudienceSummaryDto,
};
pub use mailing_contact_dto::{
    CreateMailingContactDto,
    UpdateMailingContactDto,
    PatchMailingContactDto,
    MailingContactResponseDto,
    MailingContactListResponseDto,
    MailingContactSummaryDto,
};
pub use mailing_subscription_dto::{
    CreateMailingSubscriptionDto,
    UpdateMailingSubscriptionDto,
    PatchMailingSubscriptionDto,
    MailingSubscriptionResponseDto,
    MailingSubscriptionListResponseDto,
    MailingSubscriptionSummaryDto,
};
pub use opt_out_reason_dto::{
    CreateOptOutReasonDto,
    UpdateOptOutReasonDto,
    PatchOptOutReasonDto,
    OptOutReasonResponseDto,
    OptOutReasonListResponseDto,
    OptOutReasonSummaryDto,
};
pub use mailing_dto::{
    CreateMailingDto,
    UpdateMailingDto,
    PatchMailingDto,
    MailingResponseDto,
    MailingListResponseDto,
    MailingSummaryDto,
};
pub use mailing_trace_dto::{
    CreateMailingTraceDto,
    UpdateMailingTraceDto,
    PatchMailingTraceDto,
    MailingTraceResponseDto,
    MailingTraceListResponseDto,
    MailingTraceSummaryDto,
};
pub use mailing_filter_dto::{
    CreateMailingFilterDto,
    UpdateMailingFilterDto,
    PatchMailingFilterDto,
    MailingFilterResponseDto,
    MailingFilterListResponseDto,
    MailingFilterSummaryDto,
};

// Common pagination types
use serde::Serialize;

#[cfg(feature = "openapi")]
#[cfg(feature = "openapi")]
use utoipa::ToSchema;

/// Pagination parameters for list requests
#[derive(Debug, Clone, Default, serde::Deserialize)]
#[cfg_attr(feature = "openapi", derive(ToSchema))]
pub struct PaginationParams {
    /// Page number (1-indexed)
    #[serde(default = "default_page")]
    pub page: u32,
    /// Items per page
    #[serde(default = "default_per_page")]
    pub per_page: u32,
    /// Field to sort by
    pub sort_by: Option<String>,
    /// Sort order (asc/desc)
    pub sort_order: Option<String>,
}

fn default_page() -> u32 { 1 }
fn default_per_page() -> u32 { 20 }

/// API response wrapper
#[derive(Debug, Clone, Serialize)]
#[cfg_attr(feature = "openapi", derive(ToSchema))]
#[serde(rename_all = "camelCase")]
pub struct ApiResponse<T> {
    pub success: bool,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub data: Option<T>,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub error: Option<ApiError>,
}

#[derive(Debug, Clone, Serialize)]
#[cfg_attr(feature = "openapi", derive(ToSchema))]
pub struct ApiError {
    pub code: String,
    pub message: String,
    #[serde(skip_serializing_if = "Option::is_none")]
    pub details: Option<serde_json::Value>,
}

impl<T> ApiResponse<T> {
    pub fn ok(data: T) -> Self {
        Self { success: true, data: Some(data), error: None }
    }

    pub fn err(code: impl Into<String>, message: impl Into<String>) -> Self {
        Self {
            success: false,
            data: None,
            error: Some(ApiError {
                code: code.into(),
                message: message.into(),
                details: None,
            }),
        }
    }
}