@sazito/client-sdk 1.2.1 → 1.2.2

package/README.md

@@ -7,7 +7,7 @@ This SDK is built for application developers who want a typed, framework-agnosti
 - unified response objects (`{ data, error }`)
 - configurable retry/timeout/cache behavior
 - guest checkout credential handling
-- modular API access for products, checkout, user, CMS, analytics, and more
+- modular API access for products, cart, invoices, shipping, payments, user, CMS, analytics, and more
 
 ## Package
 
@@ -249,11 +249,12 @@ const search = await sazito.search.query('shoes', {
 });
 ```
 
-### Guest Checkout Flow
+### Checkout Modules Flow
 
 ```ts
-// 1) Add product to cart (creates guest cart automatically if needed)
-await sazito.cart.addItem(12345, 2);
+// 1) Add product to cart
+const cartRes = await sazito.cart.addItemWithAttributes(12345, 2);
+if (cartRes.error) throw new Error(cartRes.error.message);
 
 // 2) Create invoice from cart
 const invoiceRes = await sazito.invoices.create();
@@ -272,29 +273,31 @@ const addrRes = await sazito.shipping.createAddress({
 if (addrRes.error) throw new Error(addrRes.error.message);
 
 // 4) Attach shipping address to invoice
-await sazito.invoices.addShippingAddress(addrRes.data.id, addrRes.data.identifier);
+const attachRes = await sazito.invoices.addShippingAddress(addrRes.data.id, addrRes.data.identifier);
+if (attachRes.error) throw new Error(attachRes.error.message);
 
 // 5) Fetch methods and assign shipping
 const methodsRes = await sazito.invoices.getApplicableShippingMethods();
-if (methodsRes.data?.length) {
-  const firstRate = methodsRes.data[0]?.rates?.[0];
-  const currentInvoice = await sazito.invoices.get();
-
-  if (firstRate && currentInvoice.data) {
-    await sazito.invoices.assignShippingMethod([
-      {
-        rateId: firstRate.id,
-        invoiceItemIds: currentInvoice.data.items.map(i => i.id)
-      }
-    ]);
-  }
+if (methodsRes.error) throw new Error(methodsRes.error.message);
+if (methodsRes.data?.itemsShippingRate?.length) {
+  const assignments = methodsRes.data.itemsShippingRate.map((entry) => ({
+    rateId: entry.shippingRate.id,
+    invoiceItemIds: [entry.invoiceItemId],
+  }));
+
+  const assignRes = await sazito.invoices.assignShippingMethod(assignments);
+  if (assignRes.error) throw new Error(assignRes.error.message);
 }
 
 // 6) Payment
 const paymentMethods = await sazito.payments.getMethods();
+if (paymentMethods.error) throw new Error(paymentMethods.error.message);
 if (paymentMethods.data?.length) {
-  await sazito.payments.create(paymentMethods.data[0].id);
+  const paymentCreateRes = await sazito.payments.create(paymentMethods.data[0].id);
+  if (paymentCreateRes.error) throw new Error(paymentCreateRes.error.message);
+
   const action = await sazito.payments.initialize();
+  if (action.error) throw new Error(action.error.message);
   console.log(action.data);
 }
 ```
@@ -357,7 +360,7 @@ Notes:
 Run the local visual playground:
 
 ```bash
-yarn visual:apis
+pnpm visual:apis
 ```
 
 Then open:
@@ -374,11 +377,11 @@ Files:
 Project scripts:
 
 ```bash
-yarn build          # Build dist outputs
-yarn dev            # Rollup watch mode
-yarn typecheck      # TypeScript check (no emit)
-yarn lint           # ESLint on src/
-yarn validate       # typecheck + lint
+pnpm build          # Build dist outputs
+pnpm dev            # Rollup watch mode
+pnpm typecheck      # TypeScript check (no emit)
+pnpm lint           # ESLint on src/
+pnpm validate       # typecheck + lint
 ```
 
 ## Fumadocs Documentation Site
@@ -388,15 +391,15 @@ SDK docs are implemented as a separate Fumadocs app in `docs/`.
 Run docs locally from the repository root:
 
 ```bash
-yarn docs:install
-yarn docs:dev
+pnpm docs:install
+pnpm docs:dev
 ```
 
 Build/start docs:
 
 ```bash
-yarn docs:build
-yarn docs:start
+pnpm docs:build
+pnpm docs:start
 ```
 
 This docs app is tracked in GitHub, but it is not included in the published npm package.