gossamer

import gleam/dynamic.{type Dynamic}
import gossamer/js_error.{type JsError}
import gossamer/performance_entry.{type PerformanceEntry}

/// Returns a high-resolution timestamp (in milliseconds) relative to the
/// time origin.
///
@external(javascript, "./performance.ffi.mjs", "now")
pub fn now() -> Float

/// Returns the time origin — the reference point all performance
/// timestamps are measured from.
///
@external(javascript, "./performance.ffi.mjs", "time_origin")
pub fn time_origin() -> Float

/// Records a performance mark with `name` at the current time. Returns an
/// error if `name` collides with a built-in timing mark.
///
@external(javascript, "./performance.ffi.mjs", "mark")
pub fn mark(name: String) -> Result(PerformanceEntry, JsError)

/// Records a measurement between two previously-recorded marks. Returns
/// an error if either mark does not exist or `name` collides with a
/// built-in timing mark.
///
@external(javascript, "./performance.ffi.mjs", "measure")
pub fn measure(
  name: String,
  from start_mark: String,
  to end_mark: String,
) -> Result(PerformanceEntry, JsError)

@external(javascript, "./performance.ffi.mjs", "clear_marks")
pub fn clear_marks() -> Nil

@external(javascript, "./performance.ffi.mjs", "clear_measures")
pub fn clear_measures() -> Nil

@external(javascript, "./performance.ffi.mjs", "get_entries")
pub fn get_entries() -> List(PerformanceEntry)

@external(javascript, "./performance.ffi.mjs", "get_entries_by_name")
pub fn get_entries_by_name(name: String) -> List(PerformanceEntry)

@external(javascript, "./performance.ffi.mjs", "get_entries_by_type")
pub fn get_entries_by_type(entry_type: String) -> List(PerformanceEntry)

@external(javascript, "./performance.ffi.mjs", "to_json")
pub fn to_json() -> Dynamic