@malawistore/store-sdk 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -6,6 +6,25 @@ All notable changes to this project are documented here. The format follows
 
 ## [Unreleased]
 
+## [0.1.3] - 2026-10-29
+
+### Added
+
+- `cart.getPage()` with line filters (`q`, `product_id`, `variant_id`), sorting,
+  and paging metadata; cart totals still cover every line.
+- `orders.listPage()` with status/currency/date/total filters and sorting.
+- `wishlist.listPage()` with product search, category filtering, and sorting.
+- Review filters and paging through `reviews.summary(productId, params)`.
+- `ListCartParams`, `ListOrdersParams`, `ListWishlistParams`,
+  `ListReviewsParams`, and `CartResponse` wire types.
+
+### Changed
+
+- Storefront and shopper lists default to 12 rows per page; the admin user
+  directory still defaults to 20. Every page remains capped at 100.
+- Existing `list()`, `get()`, and `summary()` methods now accept the same
+  optional query parameters without changing their return shapes.
+
 ## [0.1.1] - 2026-10-28
 
 ### Added

package/README.md

@@ -120,7 +120,7 @@ several parallel queries does not rotate the token multiple times.
 | `store.cart`          | Get, add, update quantity, remove, clear                            |
 | `store.inventory`     | Stock lookup and admin set/reserve/release/confirm                  |
 | `store.orders`        | Checkout, list, get, cancel                                         |
-| `store.payments`      | Stripe payment intent creation                                      |
+| `store.payments`      | Stripe payment intents and hosted Checkout sessions                 |
 | `store.wishlist`      | List, add, remove                                                   |
 | `store.reviews`       | Product summary, create, edit, delete, admin moderation             |
 
@@ -183,8 +183,32 @@ page.meta; // page, limit, offset, total, total_pages, has_next, has_prev
 
 Categories support `q`, `parent_id`, `root_only`, `has_products`, `sort`,
 `page`, `limit` and `offset` through `categories.list()` or
-`categories.listPage()`. `page` wins over `offset`; the API defaults to 20
-rows and caps a page at 100.
+`categories.listPage()`. `page` wins over `offset`; storefront and shopper
+lists (products, carts, categories, orders, reviews and wishlists) default to
+12 rows. Every page is capped at 100.
+
+The shopper lists expose the same paging envelope:
+
+```ts
+const cart = await store.cart.getPage({ page: 1, sort: "newest" });
+cart.data.items; // current page; subtotal still covers the whole cart
+cart.meta;       // line-level page counters
+
+const orders = await store.orders.listPage({
+  status: "paid",
+  created_after: "2026-01-01",
+  sort: "total_desc",
+});
+const wishlist = await store.wishlist.listPage({ q: "oil", sort: "price_asc" });
+
+const reviews = await store.reviews.summary(productId, {
+  rating: 5,
+  sort: "highest",
+  page: 1,
+  limit: 12,
+});
+reviews.meta; // filtered review page counters
+```
 
 Variant rows include `available` (on-hand minus reservations) and `in_stock`,
 both in the product detail and `/products/:id/variants` responses.
@@ -210,6 +234,10 @@ const order = await store.orders.checkout();
 // Create a Stripe intent and confirm it with Stripe.js
 const payment = await store.payments.createIntent(order.id);
 // stripe.confirmCardPayment(payment.client_secret, { … })
+
+// Or send the customer to Stripe's hosted payment page
+const checkout = await store.payments.createCheckoutSession(order.id);
+window.location.assign(checkout.url);
 ```
 
 ### Orders

package/dist/index.cjs

@@ -444,9 +444,34 @@ var CartResource = class {
     this.http = http;
   }
   http;
-  /** Active cart, created empty on first use. */
-  get() {
-    return this.http.request("GET", "/cart");
+  /** Active cart, created empty on first use (paging meta is dropped). */
+  get(params = {}) {
+    return this.http.request("GET", "/cart", {
+      query: {
+        q: params.q,
+        product_id: params.product_id,
+        variant_id: params.variant_id,
+        sort: params.sort,
+        page: params.page,
+        limit: params.limit,
+        offset: params.offset
+      }
+    });
+  }
+  /** Same as `get`, plus the `meta` paging counters. */
+  getPage(params = {}) {
+    return this.http.request("GET", "/cart", {
+      query: {
+        q: params.q,
+        product_id: params.product_id,
+        variant_id: params.variant_id,
+        sort: params.sort,
+        page: params.page,
+        limit: params.limit,
+        offset: params.offset
+      },
+      unwrap: false
+    });
   }
   /** Validates against the catalog and snapshots the current price. */
   addItem(input) {
@@ -645,9 +670,40 @@ var OrdersResource = class {
       retry: false
     });
   }
-  /** Newest first. */
-  list() {
-    return this.http.request("GET", "/orders");
+  /** Newest first (paging meta is dropped). */
+  list(params = {}) {
+    return this.http.request("GET", "/orders", {
+      query: {
+        status: params.status,
+        currency: params.currency,
+        created_after: params.created_after,
+        created_before: params.created_before,
+        min_total_cents: params.min_total_cents,
+        max_total_cents: params.max_total_cents,
+        sort: params.sort,
+        page: params.page,
+        limit: params.limit,
+        offset: params.offset
+      }
+    });
+  }
+  /** Same filters as `list`, plus the `meta` paging counters. */
+  listPage(params = {}) {
+    return this.http.request("GET", "/orders", {
+      query: {
+        status: params.status,
+        currency: params.currency,
+        created_after: params.created_after,
+        created_before: params.created_before,
+        min_total_cents: params.min_total_cents,
+        max_total_cents: params.max_total_cents,
+        sort: params.sort,
+        page: params.page,
+        limit: params.limit,
+        offset: params.offset
+      },
+      unwrap: false
+    });
   }
   get(id) {
     return this.http.request("GET", `/orders/${segment(id)}`);
@@ -678,6 +734,13 @@ var PaymentsResource = class {
       retry: false
     });
   }
+  /** Creates a Stripe-hosted Checkout page and returns its URL. */
+  createCheckoutSession(orderId) {
+    return this.http.request("POST", "/payments/checkout-sessions", {
+      body: { order_id: orderId },
+      retry: false
+    });
+  }
 };
 
 // src/resources/products.ts
@@ -790,12 +853,22 @@ var ReviewsResource = class {
     this.http = http;
   }
   http;
-  /** Public aggregate plus the newest reviews for a product. */
-  summary(productId) {
+  /** Public aggregate plus one filtered review page (`summary.meta`). */
+  summary(productId, params = {}) {
     return this.http.request(
       "GET",
       `/products/${segment(productId)}/reviews`,
-      { skipAuth: true }
+      {
+        query: {
+          q: params.q,
+          rating: params.rating,
+          sort: params.sort,
+          page: params.page,
+          limit: params.limit,
+          offset: params.offset
+        },
+        skipAuth: true
+      }
     );
   }
   /** One review per user per product. */
@@ -931,9 +1004,32 @@ var WishlistResource = class {
     this.http = http;
   }
   http;
-  /** Newest first. */
-  list() {
-    return this.http.request("GET", "/wishlist");
+  /** Newest first (paging meta is dropped). */
+  list(params = {}) {
+    return this.http.request("GET", "/wishlist", {
+      query: {
+        q: params.q,
+        category_id: params.category_id,
+        sort: params.sort,
+        page: params.page,
+        limit: params.limit,
+        offset: params.offset
+      }
+    });
+  }
+  /** Same filters as `list`, plus the `meta` paging counters. */
+  listPage(params = {}) {
+    return this.http.request("GET", "/wishlist", {
+      query: {
+        q: params.q,
+        category_id: params.category_id,
+        sort: params.sort,
+        page: params.page,
+        limit: params.limit,
+        offset: params.offset
+      },
+      unwrap: false
+    });
   }
   /** Idempotent: re-hearting succeeds silently. */
   add(productId) {