backbone-events 0.4.0

Events core + the sale/booth/crm/sms/desk overlay — registrations under one authoritative seat counter, the sale seam (order-minted registrations, forward-only paid heal, SO-cancel mirror cascade), booth bookings with the DB exclusivity wall, closed-vocabulary lead rules through a host sink port, the dual-channel (mail/sms) self-arming scheduler, and the exact-match desk verb (Odoo event port, core + overlay)
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

//! Validator for Event entity
//!
//! Generated by metaphor-schema. Do not edit manually.
//!
//! Returns an `EntityValidator<Event>` pre-loaded with schema-derived
//! field rules. Extend in the `// <<< CUSTOM` zone.

use backbone_core::{EntityValidator, ValidationErrors, ValidationError};
use backbone_core::{NonNegative, OptionalNotBlank, RequiredString};
use crate::domain::entity::Event;

/// Validator type alias for Event entities.
pub type EventValidator = EntityValidator<Event>;

/// Build a validator for Event with all schema-defined field rules.
pub fn event_validator() -> EventValidator {
    EntityValidator::new()
        .rule(RequiredString::new("name", |e: &Event| &e.name))
        .rule(RequiredString::new("date_tz", |e: &Event| &e.date_tz))
        .rule(NonNegative::new("seats_max", |e: &Event| e.seats_max as i64))
        .rule(OptionalNotBlank::new("event_url", |e: &Event| e.event_url.as_deref()))
    // <<< CUSTOM RULES
        .rule(EventUrlIsAbsolute)
    // END CUSTOM RULES
}

// <<< CUSTOM
use backbone_core::FieldRule;

/// An event URL is absolute, or absent.
///
/// The database carries the same rule as a CHECK, which is where the guarantee
/// lives. This rule exists so a caller that sends `example.org/party` is told
/// which field is wrong and why, instead of receiving whatever a violated
/// constraint turns into on the way out.
struct EventUrlIsAbsolute;

impl FieldRule<Event> for EventUrlIsAbsolute {
    fn validate(&self, entity: &Event) -> Vec<ValidationError> {
        match entity.event_url.as_deref() {
            Some(url) if !is_absolute_url(url) => vec![ValidationError::new(
                "event_url",
                "must be an absolute address carrying a scheme and a host, \
                 for example https://example.org/summit",
            )
            .with_code("pattern")],
            _ => vec![],
        }
    }
}

/// Scheme + authority, the same shape the database CHECK accepts. The scheme
/// is not narrowed to http(s): the field holds whatever address the officer
/// publishes, it only has to be one a browser can follow on its own.
fn is_absolute_url(url: &str) -> bool {
    let Some((scheme, rest)) = url.split_once("://") else {
        return false;
    };
    let mut scheme_chars = scheme.chars();
    let scheme_ok = scheme_chars.next().is_some_and(|c| c.is_ascii_alphabetic())
        && scheme_chars.all(|c| c.is_ascii_alphanumeric() || matches!(c, '+' | '.' | '-'));
    let host = rest
        .split(['/', '?', '#'])
        .next()
        .unwrap_or_default();
    scheme_ok && !host.is_empty() && !host.chars().any(char::is_whitespace)
}

#[cfg(test)]
mod event_url_tests {
    use super::is_absolute_url;

    #[test]
    fn absolute_addresses_pass_and_bare_hosts_do_not() {
        for ok in [
            "https://example.org/summit",
            "http://example.org",
            "webcal://calendar.example.org/feed.ics",
        ] {
            assert!(is_absolute_url(ok), "{ok} should be accepted");
        }
        for bad in [
            "example.org/summit",
            "://example.org",
            "https://",
            "https:// example.org",
            "9https://example.org",
        ] {
            assert!(!is_absolute_url(bad), "{bad} should be refused");
        }
    }
}
// END CUSTOM