@malawistore/store-sdk 0.1.2 → 0.2.0

package/dist/index.js

@@ -431,6 +431,11 @@ var AuthResource = class {
   }
 };
 
+// src/headers.ts
+function idempotencyHeaders(key) {
+  return key ? { "Idempotency-Key": key } : void 0;
+}
+
 // src/path.ts
 function segment(value) {
   return encodeURIComponent(value);
@@ -442,9 +447,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) {
@@ -453,6 +483,22 @@ var CartResource = class {
       retry: false
     });
   }
+  /**
+   * Adds up to MAX_BULK_ITEMS lines in one request. Per-line results carry
+   * the written line, plus the full updated cart.
+   */
+  addItems(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.request(
+      "POST",
+      "/cart/items/bulk",
+      {
+        body,
+        headers: idempotencyHeaders(idempotencyKey),
+        retry: false
+      }
+    );
+  }
   /** `qty: 0` removes the line. */
   setQty(itemId, qty) {
     return this.http.request(
@@ -475,12 +521,11 @@ var CartResource = class {
 };
 
 // src/upload.ts
-function createUploadForm(file, field = "file") {
-  const form = new FormData();
+function appendFile(form, file, field) {
   if (typeof Blob !== "undefined" && file instanceof Blob) {
     const name = typeof File !== "undefined" && file instanceof File ? file.name : "upload";
     form.append(field, file, name);
-    return form;
+    return;
   }
   if (typeof file !== "object" || file === null || !("data" in file) || typeof file.name !== "string") {
     throw new TypeError(
@@ -491,6 +536,19 @@ function createUploadForm(file, field = "file") {
     type: file.type ?? "application/octet-stream"
   });
   form.append(field, blob, file.name);
+}
+function createUploadForm(file, field = "file") {
+  const form = new FormData();
+  appendFile(form, file, field);
+  return form;
+}
+function createUploadFormMany(files, field = "files") {
+  const list = Array.isArray(files) ? files : [files];
+  if (list.length === 0) {
+    throw new TypeError("At least one UploadFile is required");
+  }
+  const form = new FormData();
+  for (const file of list) appendFile(form, file, field);
   return form;
 }
 
@@ -595,6 +653,21 @@ var InventoryResource = class {
       }
     });
   }
+  /**
+   * Reads availability for up to MAX_BULK_ITEMS variants in one request.
+   * Unknown ids are returned in `notFound` instead of failing.
+   */
+  getStockByVariants(variantIds) {
+    return this.http.request(
+      "GET",
+      "/admin/inventory/stock",
+      {
+        query: {
+          variantIds: Array.isArray(variantIds) ? variantIds : [variantIds]
+        }
+      }
+    );
+  }
   /** Upserts the on-hand quantity (restocking). */
   setStock(input) {
     return this.http.request("POST", "/admin/inventory/stock", {
@@ -602,6 +675,19 @@ var InventoryResource = class {
       retry: false
     });
   }
+  /** Sets on-hand stock for many SKUs; `atomic` commits all or none. */
+  setStockBulk(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.request(
+      "POST",
+      "/admin/inventory/stock/bulk",
+      {
+        body,
+        headers: idempotencyHeaders(idempotencyKey),
+        retry: false
+      }
+    );
+  }
   /** Holds all lines atomically; one short line fails the whole order. */
   reserve(input) {
     return this.http.request(
@@ -643,9 +729,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)}`);
@@ -699,6 +816,7 @@ var ProductsResource = class {
     return this.http.request("GET", "/products", {
       query: {
         q: params.q,
+        ids: params.ids,
         category_id: params.category_id,
         category_slug: params.category_slug,
         min_price_cents: params.min_price_cents,
@@ -722,6 +840,7 @@ var ProductsResource = class {
     return this.http.request("GET", "/products", {
       query: {
         q: params.q,
+        ids: params.ids,
         category_id: params.category_id,
         category_slug: params.category_slug,
         min_price_cents: params.min_price_cents,
@@ -787,6 +906,86 @@ var ProductsResource = class {
       { form: createUploadForm(file), retry: false }
     );
   }
+  /**
+   * Admin only. Creates products in bulk. Per-item failures stay inside
+   * the 200 envelope; `atomic` rolls the whole batch back.
+   */
+  bulkCreate(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.request(
+      "POST",
+      "/admin/products/bulk",
+      {
+        body,
+        headers: idempotencyHeaders(idempotencyKey),
+        retry: false
+      }
+    );
+  }
+  /** Admin only. Applies one partial patch per product id. */
+  bulkUpdate(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.request(
+      "PATCH",
+      "/admin/products/bulk",
+      {
+        body,
+        headers: idempotencyHeaders(idempotencyKey),
+        retry: false
+      }
+    );
+  }
+  /**
+   * Admin only. POST rather than DELETE so the id list can travel in JSON.
+   * `dryRun` reports `wouldDelete` without writing.
+   */
+  bulkDelete(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.request(
+      "POST",
+      "/admin/products/bulk-delete",
+      {
+        body,
+        headers: idempotencyHeaders(idempotencyKey),
+        retry: false
+      }
+    );
+  }
+  /** Admin only. Gallery rows, including uploads still queued (empty url). */
+  async listImages(id) {
+    const result = await this.http.request(
+      "GET",
+      `/admin/products/${segment(id)}/images`
+    );
+    return result.images;
+  }
+  /**
+   * Admin only. Multipart with repeated `files` parts (up to 20 per
+   * request). Each accepted file is queued asynchronously (HTTP 202).
+   */
+  async uploadImages(id, files) {
+    return this.http.request(
+      "POST",
+      `/admin/products/${segment(id)}/images`,
+      { form: createUploadFormMany(files), retry: false }
+    );
+  }
+  /** Admin only. Promotes the next ready image when the primary is deleted. */
+  deleteImage(id, imageId) {
+    return this.http.request(
+      "DELETE",
+      `/admin/products/${segment(id)}/images/${segment(imageId)}`,
+      { retry: false }
+    );
+  }
+  /** Admin only. Points the storefront primary image at one gallery row. */
+  setPrimaryImage(id, imageId) {
+    return this.http.request(
+      "PUT",
+      `/admin/products/${segment(id)}/images/${segment(imageId)}/primary`,
+      { retry: false }
+    );
+  }
 };
 
 // src/resources/reviews.ts
@@ -795,14 +994,47 @@ 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
+      }
     );
   }
+  /** The caller's own reviews with product context (paging meta dropped). */
+  listMine(params = {}) {
+    return this.http.request("GET", "/reviews/me", {
+      query: {
+        sort: params.sort,
+        page: params.page,
+        limit: params.limit,
+        offset: params.offset
+      }
+    });
+  }
+  /** Same as `listMine`, plus the `meta` paging counters. */
+  listMinePage(params = {}) {
+    return this.http.request("GET", "/reviews/me", {
+      query: {
+        sort: params.sort,
+        page: params.page,
+        limit: params.limit,
+        offset: params.offset
+      },
+      unwrap: false
+    });
+  }
   /** One review per user per product. */
   create(productId, input) {
     return this.http.request(
@@ -847,8 +1079,9 @@ var UsersResource = class {
   me() {
     return this.http.request("GET", "/users/me");
   }
+  /** Admin only. There is no public `GET /users/{id}` — owners use `me()`. */
   get(id) {
-    return this.http.request("GET", `/users/${segment(id)}`);
+    return this.http.request("GET", `/admin/users/${segment(id)}`);
   }
   /** Admin only. User directory without envelope metadata. */
   list(params = {}) {
@@ -928,6 +1161,32 @@ var VariantsResource = class {
       { retry: false }
     );
   }
+  /** Admin only. Creates up to MAX_BULK_ITEMS SKUs for one product. */
+  createBulk(productId, input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.request(
+      "POST",
+      `/products/${segment(productId)}/variants/bulk`,
+      {
+        body,
+        headers: idempotencyHeaders(idempotencyKey),
+        retry: false
+      }
+    );
+  }
+  /** Admin only. Applies one partial patch per variant id. */
+  updateBulk(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.request(
+      "PATCH",
+      "/admin/variants/bulk",
+      {
+        body,
+        headers: idempotencyHeaders(idempotencyKey),
+        retry: false
+      }
+    );
+  }
 };
 
 // src/resources/wishlist.ts
@@ -936,9 +1195,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) {
@@ -955,6 +1237,35 @@ var WishlistResource = class {
       { retry: false }
     );
   }
+  /** Hearts up to MAX_BULK_ITEMS products; already-hearted rows succeed. */
+  addBulk(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.request(
+      "POST",
+      "/wishlist/bulk",
+      {
+        body,
+        headers: idempotencyHeaders(idempotencyKey),
+        retry: false
+      }
+    );
+  }
+  /**
+   * Unhearts by product id. `dryRun` reports `wouldDelete` without
+   * writing; already-removed rows succeed.
+   */
+  removeBulk(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.request(
+      "POST",
+      "/wishlist/bulk-delete",
+      {
+        body,
+        headers: idempotencyHeaders(idempotencyKey),
+        retry: false
+      }
+    );
+  }
 };
 
 // src/client.ts
@@ -1111,6 +1422,6 @@ async function constructStripeEvent(options) {
   return JSON.parse(text);
 }
 
-export { MalawiStore, MalawiStoreError, buildQuery, constructStripeEvent, createUploadForm, isMalawiStoreError, verifyStripeSignature };
+export { MalawiStore, MalawiStoreError, buildQuery, constructStripeEvent, createUploadForm, createUploadFormMany, isMalawiStoreError, verifyStripeSignature };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map