Struct CookieConfig 

pub struct CookieConfig {
    pub name: String,
    pub domain: Option<String>,
    pub secure: bool,
    pub same_site: SameSite,
    pub max_age_secs: u64,
    pub path: String,
}

Fields

name: String

domain: Option<String>

Domain attribute. None → host-only cookie (correct for localhost and for single-host prod). .example.com → shared across subdomains.

secure: bool

same_site: SameSite

max_age_secs: u64

Cookie lifetime in seconds; matches the server-side session TTL by default so the browser drops the cookie at the same moment the session would have expired anyway.

path: String

Implementations

impl CookieConfig

pub fn from_env(default_name: &str) -> Self

Build from environment, with default_name derived from the app’s manifest name (falls back to pylon if the manifest is unnamed). Honored env vars:

• PYLON_COOKIE_NAME — overrides the derived default.
• PYLON_COOKIE_DOMAIN — e.g. .pylonsync.com for cross-subdomain.
• PYLON_COOKIE_SECURE — 1/true/0/false. Auto-disabled in dev unless explicitly forced.
• PYLON_COOKIE_SAME_SITE — strict|lax|none. Default lax.

pub fn default_name_for(app_name: &str) -> String

Default cookie name for an app: ${app_name}_session. Sanitises the app name so values that aren’t valid in a Set-Cookie name (spaces, =, ;, etc.) don’t end up in the header.

pub fn set_value(&self, token: &str) -> String

Build the Set-Cookie header value carrying a session token.

pub fn clear_value(&self) -> String

Build the Set-Cookie header value that clears the cookie. The browser drops it immediately because Max-Age is 0.

Trait Implementations

impl Clone for CookieConfig

fn clone(&self) -> CookieConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CookieConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.