Struct KillFaucetDailyState

pub struct KillFaucetDailyState {
    pub granted: i64,
    pub d_micro: i64,
    pub cap: i64,
    pub last_reset_at: DateTime<Utc>,
}

One family’s day.

The band (d, cap) is SNAPSHOTTED on the first eligible roll after the daily reset and then frozen until the next one. Chapter, mode, build or power progress during the day never reprices it and never restores a chance that has already decayed — otherwise pushing a few chapters mid-session would refresh a spent faucet, which is exactly the unattended-farm loop the cap exists to bound.

Stored in integers so CharacterState keeps its Eq: granted units are whole by construction (one Cookie, one stone, packet Essence), and D is held in micro-units the way BAL-021 holds Plinko tranches.

Fields

granted: i64

Units actually GRANTED today, not roll attempts. A proc clipped to the remaining budget counts only what it paid out.

d_micro: i64

Snapshotted D in micro-units (D × 1_000_000).

cap: i64

Snapshotted ceil(2 × D).

last_reset_at: DateTime<Utc>

Implementations

impl KillFaucetDailyState

pub fn snapshot(d: f64, now: DateTime<Utc>) -> Self

Open a fresh day for a family whose band resolves to d.

pub fn d(&self) -> f64

The snapshotted D back in natural units.

pub fn remaining(&self) -> i64

Budget still payable today. Zero means the family is done until reset.

pub fn decay(&self) -> f64

Chance multiplier for a non-Cookie family at the current granted.

pub fn take(&mut self, amount: i64) -> i64

Clip amount to the remaining budget and bank it. Returns what was actually paid, which is what the caller must grant — never the request.

Trait Implementations

impl Clone for KillFaucetDailyState

fn clone(&self) -> KillFaucetDailyState

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for KillFaucetDailyState

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KillFaucetDailyState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for KillFaucetDailyState

fn schema_name() -> String

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn is_referenceable() -> bool

Whether JSON Schemas generated for this type should be re-used where possible using the $ref keyword.

impl PartialEq for KillFaucetDailyState

fn eq(&self, other: &KillFaucetDailyState) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for KillFaucetDailyState

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Tsify for KillFaucetDailyState

const DECL: &'static str = "/**\n * One family\\\'s day.\n *\n * The band (`d`, cap) is SNAPSHOTTED on the first eligible roll after the daily\n * reset and then frozen until the next one. Chapter, mode, build or power\n * progress during the day never reprices it and never restores a chance that\n * has already decayed \u{2014} otherwise pushing a few chapters mid-session would\n * refresh a spent faucet, which is exactly the unattended-farm loop the cap\n * exists to bound.\n *\n * Stored in integers so `CharacterState` keeps its `Eq`: granted units are\n * whole by construction (one Cookie, one stone, `packet` Essence), and `D` is\n * held in micro-units the way BAL-021 holds Plinko tranches.\n */\nexport interface KillFaucetDailyState {\n /**\n * Units actually GRANTED today, not roll attempts. A proc clipped to the\n * remaining budget counts only what it paid out.\n */\n granted: number;\n /**\n * Snapshotted `D` in micro-units (`D \u{d7} 1_000_000`).\n */\n d_micro: number;\n /**\n * Snapshotted `ceil(2 \u{d7} D)`.\n */\n cap: number;\n last_reset_at: DateTime<Utc>;\n}"

const SERIALIZATION_CONFIG: SerializationConfig

type JsType = JsType

fn into_js(&self) -> Result<Self::JsType, Error>

where Self: Serialize,

fn from_js<T>(js: T) -> Result<Self, Error>

where T: Into<JsValue>, Self: DeserializeOwned,

impl Copy for KillFaucetDailyState

impl Eq for KillFaucetDailyState

impl StructuralPartialEq for KillFaucetDailyState