Persons and events

const person = await voidhash.persons.create({
  payload: { distinctId: "user_123", email: "ada@example.com", name: "Ada" },
});

console.log(person.id); // person_…

const { data } = await voidhash.persons.list({ params: { distinctId: "user_123" } });
const person = data[0]; // undefined when Voidhash has never seen user_123

const byEmail = await voidhash.persons.list({ params: { email: "ada@example.com" } });

const person = await voidhash.persons.get({ params: { personId: "person_k2v9x4m8q1r3" } });

await voidhash.persons.update({
  params: { personId: "person_k2v9x4m8q1r3" },
  payload: {
    traits: { plan: "team", seats: 5 },
    setOnce: { signupSource: "website" },
  },
});

await voidhash.eventCapture.capture({
  distinctId: "user_123",
  event: "report_exported",
  timestamp: new Date().toISOString(),
  properties: { format: "csv", rows: 1200 },
});

const { accepted, rejected } = await voidhash.eventCapture.batch([
  { distinctId: "user_123", event: "trial_reminder_sent", timestamp: new Date().toISOString() },
  { distinctId: "user_456", event: "trial_reminder_sent", timestamp: new Date().toISOString() },
]);

await voidhash.eventCapture.capture({
  distinctId: "user_123",
  event: "report_exported",
  timestamp: new Date().toISOString(),
  groups: { company: "acme" },
});

await voidhash.eventCapture.groupIdentify({
  groupType: "company",
  groupKey: "acme",
  properties: { name: "Acme", plan: "pro", seats: 40 },
  setOnce: { firstPlan: "trial" },
});

const sent = await voidhash.pushNotifications.create({
  params: { "idempotency-key": "renewal-reminder-user_123-2026-11" },
  payload: {
    distinctIds: ["user_123"],
    title: "Your trial ends tomorrow",
    body: "Keep Pro for $9.99 a month.",
    data: { screen: "paywall" },
  },
});

console.log(sent.id, sent.deviceCount, sent.unresolvedDistinctIds);

const erasure = await voidhash.persons.createErasure({ payload: { distinctId: "user_123" } });

const status = await voidhash.persons.getErasure({ params: { erasureId: erasure.id } });
console.log(status.status); // queued | in_progress | completed | failed