Struct Waitlist 

pub struct Waitlist { /* private fields */ }

A per-product waitlist.

Implementations

impl Waitlist

pub fn new() -> Self

No products allowed until Waitlist::products or Waitlist::any_product says otherwise; 7-day confirm TTL; referrals on.

pub fn products( self, products: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Exactly these product slugs may be joined.

pub fn any_product(self) -> Self

Accept any product slug (single-product ventures that do not want an allowlist).

pub fn confirm_ttl_days(self, days: u32) -> Self

How long a confirmation link stays valid (default 7 days).

pub fn retention_days_pending(self, days: u32) -> Self

Purge pending entries untouched for this many days from the scheduled handler (default 30; issue #13 retention rule).

pub fn status_redirect(self, url: impl Into<String>) -> Self

Where confirmation redirects to, as <url>?token=<status token> (default <public_url>/waitlist/status).

pub fn referrals(self, enabled: bool) -> Self

Whether ref codes credit referrers (default true).

pub fn answers_schema( self, validate: impl Fn(&Value) -> Result<(), String> + Send + Sync + 'static, ) -> Self

Validates the free-form answers JSON of a join (default: accept anything).

Trait Implementations

impl Default for Waitlist

fn default() -> Self

Returns the “default value” for a type.

impl Module for Waitlist

fn name(&self) -> &'static str

Kebab-case name; mounted at /v1/<name>.

fn version(&self) -> &'static str

env!("CARGO_PKG_VERSION"), surfaced by /__health.

fn requires(&self) -> &'static [Port]

Ports the module cannot run without; missing = build error.

fn optional(&self) -> &'static [Port]

Ports the module uses when present.

fn tables(&self) -> &'static [&'static str]

Table names this module owns; duplicates across modules are a build error.

fn emits(&self) -> &'static [&'static str]

Event names this module emits ("<module>.<event>"), listed by /__health.

fn public_writes(&self) -> bool

Whether the module has public write endpoints; drives the production-captcha rule (section 11).

fn migrations(&self) -> Migrations

The module’s migrations, embedded per dialect.

fn validate_config(&self, cfg: &dyn Config) -> Result<(), ConfigError>

Rejects invalid configuration: missing required keys or malformed values, reported together with the module name.

fn router(&self, ctx: ModuleContext) -> Router

The module’s router, nested under /v1/<name>.

fn surface(&self) -> Surface

The module’s UI surface (ADR 0010): the actions a renderer may offer and the views that compose them. Input schemas come from the handler’s own body types (Action::input::<Body>()), so the declaration cannot drift from the route. Harness::build validates it; GET /__surface serves the composition. Default: nothing, and a module that declares nothing renders nothing.

fn scheduled<'a>( &'a self, ctx: &'a ModuleContext, cron: &'a str, ) -> BoxFuture<'a, Result<(), AnyError>>

Scheduled work (cron is the trigger expression). Default: none.

fn harness_api(&self) -> u32

Contract version, checked by Harness::build.

fn well_known(&self) -> Option<Router>

Routes this module serves at the root under /.well-known, for spec-mandated discovery documents (OIDC openid-configuration, jwks.json) that must live outside /v1 (issue #46). Paths are relative to the prefix: register /jwks.json, not /.well-known/jwks.json.

fn events( &self, ) -> Vec<(String, Arc<dyn Fn(&Scope, Value) -> Pin<Box<dyn Future<Output = Result<(), Box<dyn Error + Sync + Send>>> + Send>> + Sync + Send>)>

Handlers for events other modules emit; registered at Harness::build.