Struct BaoTimeoutObject 

#[repr(C)]
pub struct BaoTimeoutObject {
    pub event_loop_timer: EventLoopTimer,
    pub epoch: u32,
    pub callback_key: Option<String>,
    pub args: Vec<Value>,
    pub interval: Option<Duration>,
    pub timer_id: u32,
}

Fields

event_loop_timer: EventLoopTimer

MUST be at offset 0 — dispatch::__bun_fire_timer/__bun_js_timer_epoch recover *mut BaoTimeoutObject from this field’s address via from_timer_ptr (container_of via offset_of!).

epoch: u32

Monotonic epoch for stable heap ordering of equal-deadline JS timers. Mirrors Bun’s TimerObjectInternals.flags.epoch (u25 in Zig).

callback_key: Option<String>

GC-safe: GcStore key for the JS callback. None = virgin state. The actual *mut JSObject is stored as a property on the JS global via gc_store_insert_ns(cx, "timer", &key, ..); this field only holds the string key. Retrieval via gc_store_get_ns(cx, "timer", key) is GC-safe (the property is rooted on the global object, managed by SpiderMonkey’s GC). (Doc-link residue of the BUG-ENG-360 migration: these lines still named the un-namespaced pre-migration accessors.)

args: Vec<Value>

Marshalled JS arguments preserved across the schedule→fire window.

interval: Option<Duration>

P1-A.3c: re-arm interval for setInterval. None = one-shot setTimeout. Set when scheduled via setInterval; consumed by drain logic which re-inserts the timer after firing. Mirrors Bun’s TimerObjectInternals.flags.repeat (Duration in ms).

timer_id: u32

P1-A.3c: unique timer id used for clearTimeout/clearInterval lookups. The JS-visible id (setTimeout return value) — same value as id in the legacy TimerEntry. Stored on the object so cancel_raw can identify the right BaoTimeoutObject when clearing.

Implementations

impl BaoTimeoutObject

pub fn new_paused() -> BaoTimeoutObject

Construct a paused (PENDING state) timeout with epoch 0, no callback.

pub unsafe fn from_timer_ptr(t: *mut EventLoopTimer) -> *mut BaoTimeoutObject

Container-of: recover the parent BaoTimeoutObject from a pointer to its event_loop_timer field. This is the inverse of &obj.event_loop_timer as *mut _.

Safety

t must be a non-null pointer to the event_loop_timer field of a live BaoTimeoutObject. Caller must not hold a &mut to the parent across this call (re-entrant JS callbacks can re-derive aliasing &mut, same as Bun’s TimeoutObject::fire pattern).

pub fn fire(&mut self, _now: &Timespec)

Mark this timer as fired and bump epoch for stable re-queue ordering. Pure state transition — does NOT dispatch the JS callback. Callers that need JS dispatch must use fire_js after retrieving the current JSContext*.

pub unsafe fn fire_js(&mut self, raw_cx: *mut JSContext, now: &Timespec)

Mark fired AND dispatch the JS callback via fire_js_callback_raw. This is the SpiderMonkey equivalent of Bun’s TimeoutObject::fire. No-op if no callback key is attached (defensive — schedule path always sets one). Callback throws route through the uncaught-exception router (handler dispatch or stderr + exit 1) — never silently swallowed.

Safety

• raw_cx must be a live JSContext* on the current thread.
• The callback retrieved from GcStore (if Some) must be a live function object rooted on the JS global for the duration of this call.
• self.args slice must point to JSVals rooted by the caller.