commerce-kit 0.39.2 → 0.41.0

package/README.md

@@ -71,6 +71,35 @@ const { data, meta } = await commerce.orderBrowse({
 const order = await commerce.orderGet({ id: 'order_789' });
 ```
 
+## Events
+
+An event is a product flagged as an event (with a date, location, and capacity) plus a single
+non-shippable ticket variant. Requires the store's **Events tool** to be enabled.
+
+```typescript
+// List events (with live ticketsSold counts)
+const { data, total } = await commerce.eventBrowse({ limit: 10, offset: 0 });
+
+// Get one event by id or slug
+const { event } = await commerce.eventGet({ idOrSlug: 'summer-fest' });
+
+// Create an event (ticket price is a decimal string)
+const { event } = await commerce.eventCreate({
+  name: 'Summer Fest',
+  price: '29.99',
+  startsAt: '2026-07-01T18:00:00Z',
+  location: 'Berlin',
+  capacity: 500,
+});
+
+// Update event metadata (partial; send null to clear a field).
+// Does not change the ticket price/variants — use the products API for those.
+await commerce.eventUpdate({ idOrSlug: 'summer-fest' }, { capacity: 600, status: 'published' });
+
+// Attendee rollup (buyers and ticket quantities, from paid orders)
+const { attendees, totalTickets } = await commerce.eventAttendeesBrowse({ idOrSlug: 'summer-fest' });
+```
+
 ## Raw API Requests
 
 For endpoints not yet implemented in the SDK, use the `request()` method: