commerce-kit 0.46.0 → 0.48.0

package/README.md

@@ -69,6 +69,7 @@ const { data, meta } = await commerce.orderBrowse({
 
 // Get single order
 const order = await commerce.orderGet({ id: 'order_789' });
+// Orders with event-ticket lines carry a buyer access code: order.ticketCode (string | null)
 ```
 
 ## Events
@@ -100,6 +101,34 @@ await commerce.eventUpdate({ idOrSlug: 'summer-fest' }, { capacity: 600, status:
 const { attendees, totalTickets } = await commerce.eventAttendeesBrowse({ idOrSlug: 'summer-fest' });
 ```
 
+## Tickets
+
+No-login access to purchased event tickets. The buyer gets a 6-character access code on the
+order (`order.ticketCode`, also in the confirmation email) and manages all attendee details
+with it plus the purchase email. Each seat carries its own shareable `token` — a view-only
+link for the attendee; attendee details can only be edited by the buyer.
+
+```typescript
+// Buyer lookup: access code + purchase email.
+// Returns null on any mismatch (the API answers a uniform 404).
+const bundle = await commerce.ticketsGet({ code: 'K7M3PA', email: 'buyer@example.com' });
+// bundle.lines[].event — startsAt, location, guestLabel, guest
+// bundle.lines[].seats[] — { token, name, email } per ticket
+
+// Buyer bulk-edit of attendee names/emails.
+// Throws on mismatch (404) or when the order is cancelled/refunded (409).
+const updated = await commerce.ticketsUpdate(
+  { code: 'K7M3PA' },
+  {
+    email: 'buyer@example.com',
+    seats: [{ token: bundle.lines[0].seats[0].token, name: 'Ada Lovelace', email: null }],
+  },
+);
+
+// View-only attendee ticket by seat token (null for unknown tokens)
+const ticket = await commerce.ticketAttendeeGet({ token: 'a1b2c3...' });
+```
+
 ## Collections & Categories
 
 Full CRUD for product collections, product categories, and blog categories. Mutations are
@@ -111,6 +140,11 @@ const collection = await commerce.collectionCreate({ name: 'Summer', filter: { t
 await commerce.collectionUpdate({ idOrSlug: 'summer' }, { name: 'Summer 2026', active: false });
 await commerce.collectionDelete({ idOrSlug: 'summer' }); // { ok: true, deleted: 1 }
 
+// Group related collections under a free-form key and fetch them together
+await commerce.collectionUpdate({ idOrSlug: 'floral' }, { group: 'fragrances' });
+const fragrances = await commerce.collectionBrowse({ group: 'fragrances' });
+await commerce.collectionUpdate({ idOrSlug: 'floral' }, { group: null }); // clear
+
 // Categories — delete (create/update already supported)
 await commerce.categoryUpdate({ idOrSlug: 'shoes' }, { name: 'Footwear' });
 await commerce.categoryDelete({ idOrSlug: 'footwear' }); // 409 if still referenced by products