commerce-kit 0.62.0 → 0.65.0

package/README.md

@@ -129,6 +129,21 @@ const updated = await commerce.ticketsUpdate(
 const ticket = await commerce.ticketAttendeeGet({ token: 'a1b2c3...' });
 ```
 
+## Newsletter
+
+```typescript
+const subscriber = await commerce.subscriberCreate({ email: 'jane@example.com', marketingConsent: true });
+
+// Double opt-in stores return pending: true — the address joins the list only after the
+// shopper clicks the link in the confirmation email. Tell them to check their inbox.
+if (subscriber.pending) { /* "Check your inbox to confirm" */ }
+
+await commerce.subscriberDelete('jane@example.com');
+```
+
+Confirmation and unsubscribe links in emails point at pages hosted by Your Next Store, so a
+storefront needs no `/confirm-subscription` or `/unsubscribe` route of its own.
+
 ## Collections & Categories
 
 Full CRUD for product collections, product categories, and blog categories. Mutations are
@@ -155,6 +170,26 @@ await commerce.blogCategoryUpdate({ idOrSlug: 'guides' }, { description: null })
 await commerce.blogCategoryDelete({ idOrSlug: 'guides' });
 ```
 
+## Payment Icons
+
+Official payment marks (cards, wallets, BLIK, Przelewy24, Klarna, PayU, …) from
+[activemerchant/payment_icons](https://github.com/activemerchant/payment_icons) (MIT), keyed by
+Stripe's payment method type names. Each renders as a 38×24 `<img>` with the method's name as
+alt text. Render them from a Server Component: the module carries every icon (~75 KB).
+
+```tsx
+import { PaymentIcon } from 'commerce-kit/payment-icons';
+
+<ul aria-label="Payment methods" className="flex gap-2">
+  {(['visa', 'mastercard', 'blik', 'p24', 'apple_pay'] as const).map((method) => (
+    <li key={method}><PaymentIcon method={method} className="h-6 w-auto" /></li>
+  ))}
+</ul>;
+```
+
+To add or refresh icons, edit the list in `scripts/payment-icons.ts` and run
+`bun scripts/payment-icons.ts [commit-sha]`.
+
 ## Raw API Requests
 
 For endpoints not yet implemented in the SDK, use the `request()` method: