tp = Trailproof(
    store="memory",              # "memory" (default) or "jsonl"
    path=None,                   # file path (required for jsonl store)
    signing_key=None,            # HMAC-SHA256 key (optional)
    default_tenant_id=None,      # applied to every event if not specified
)

const tp = new Trailproof({
  store: "memory",              // "memory" (default) or "jsonl"
  path: undefined,              // file path (required for jsonl store)
  signingKey: undefined,        // HMAC-SHA256 key (optional)
  defaultTenantId: undefined,   // applied to every event if not specified
});

event = tp.emit(
    event_type="myapp.user.login",     # required
    actor_id="user-42",                 # required
    tenant_id="acme-corp",              # required (or use default_tenant_id)
    payload={"ip": "1.2.3.4"},          # required
    trace_id="trace-abc",               # optional
    session_id="session-xyz",           # optional
)

const event = tp.emit({
  eventType: "myapp.user.login",       // required
  actorId: "user-42",                  // required
  tenantId: "acme-corp",               // required (or use defaultTenantId)
  payload: { ip: "1.2.3.4" },         // required
  traceId: "trace-abc",               // optional
  sessionId: "session-xyz",           // optional
});

result = tp.query(
    event_type="myapp.user.login",       # optional
    actor_id="user-42",                   # optional
    tenant_id="acme-corp",                # optional
    trace_id="trace-abc",                 # optional
    session_id="session-xyz",             # optional
    from_time="2025-01-01T00:00:00Z",    # optional
    to_time="2025-12-31T23:59:59Z",      # optional
    limit=100,                            # default 100
    cursor=None,                          # for pagination
)

result.events       # list[TrailEvent]
result.next_cursor  # str | None

const result = tp.query({
  eventType: "myapp.user.login",
  actorId: "user-42",
  tenantId: "acme-corp",
  traceId: "trace-abc",
  sessionId: "session-xyz",
  fromTime: "2025-01-01T00:00:00Z",
  toTime: "2025-12-31T23:59:59Z",
  limit: 100,
  cursor: undefined,
});

result.events;      // TrailEvent[]
result.nextCursor;  // string | undefined

result = tp.verify()

result.intact   # bool -- True if no tampering
result.total    # int -- number of events checked
result.broken   # list[int] -- indices of broken events

const result = tp.verify();

result.intact;  // boolean -- true if no tampering
result.total;   // number -- number of events checked
result.broken;  // number[] -- indices of broken events

events = tp.get_trace("trace-abc")
# returns: list[TrailEvent]

const events = tp.getTrace("trace-abc");
// returns: TrailEvent[]

tp.flush()

tp.flush();