@misiki/gocommerce-connector 0.11.0 → 0.12.0

package/dist/services/index.cjs

@@ -733,7 +733,12 @@ function toCartLine(l, extra = {}) {
     variantTitle: l.variant_label ?? "",
     qty: l.quantity,
     price: toMajor(l.unit_price),
-    mrp: toMajor(l.unit_price),
+    // The variant's compare-at price, where the shop set one above what the
+    // line costs: what the basket's "you save" is measured from.
+    mrp: l.compare_at_price && l.compare_at_price.amount_minor > l.unit_price.amount_minor ? toMajor(l.compare_at_price) : toMajor(l.unit_price),
+    /** The add-on this line was bought as (D133), or null on an ordinary line. */
+    addOnId: l.add_on_id ? str(l.add_on_id) : null,
+    addOnFor: l.add_on_for ? str(l.add_on_for) : null,
     subtotal: toMajor(l.total),
     total: toMajor(l.total),
     inStock: l.in_stock,
@@ -966,6 +971,45 @@ function toUser(c) {
     updatedAt: c.updated_at
   };
 }
+function toAddOn(a) {
+  return {
+    id: str(a.id),
+    productId: str(a.item.product_id),
+    variantId: str(a.variant_id),
+    slug: a.item.slug,
+    title: a.item.title,
+    variantTitle: a.item.variant_label ?? "",
+    thumbnail: mediaUrl(a.item.image_url ?? null),
+    price: toMajor(a.offer_price ?? a.price),
+    regularPrice: toMajor(a.price),
+    hasOffer: !!a.offer_price && a.offer_price.amount_minor < a.price.amount_minor,
+    inStock: a.item.in_stock
+  };
+}
+function toCartOffer(o, currency) {
+  const isPercent = o.kind === "percentage";
+  return {
+    code: o.code,
+    title: o.title,
+    isPercent,
+    freeShipping: o.kind === "free_shipping",
+    /** The percentage for a percentage code, the amount for a fixed one. */
+    value: isPercent ? (o.value_bp ?? 0) / 100 : minorToMajor(o.value_minor ?? 0, currency),
+    minAmount: o.min_subtotal_minor ? minorToMajor(o.min_subtotal_minor, currency) : null,
+    applies: o.applies,
+    amount: o.amount ? toMajor(o.amount) : null,
+    remaining: o.remaining ? toMajor(o.remaining) : null,
+    reason: o.reason ?? ""
+  };
+}
+function toFreeShipping(f) {
+  return {
+    qualifies: f.qualifies,
+    threshold: f.threshold ? toMajor(f.threshold) : null,
+    remaining: f.remaining ? toMajor(f.remaining) : null,
+    subtotal: toMajor(f.subtotal)
+  };
+}
 
 // src/cache.ts
 var TTL_MS = 6e4;
@@ -1290,6 +1334,36 @@ var ProductService = class extends CatalogService {
     if (!category) return this.list({ page, limit });
     return this.list({ page, limit, categories: category.slug });
   }
+  /**
+   * What the shop offers with a product, ticked in its buy box (D133): each
+   * add-on at the price ticking it adds. Only add-ons that can be bought
+   * arrive; an engine without the route offers none.
+   */
+  async listAddOns({ product }) {
+    const p = await this.findProduct(String(product));
+    try {
+      return (await this.data("/api/add-ons", { query: { product_id: p.id } }) ?? []).map(toAddOn);
+    } catch (err) {
+      if (err instanceof GoCommerceError && err.status === 404) return [];
+      throw err;
+    }
+  }
+  /**
+   * "You may also like": the products the shop chose for this one, at their
+   * own prices (D133). Curated only, and empty when none were chosen: the
+   * related products already fill in from the category, and the page should
+   * not draw the same fill twice.
+   */
+  async listCrossSells({ product, limit }) {
+    const p = await this.findProduct(String(product));
+    try {
+      const rows = await this.data("/api/cross-sells", { query: { product_id: p.id, limit } }) ?? [];
+      return rows.map((r) => toProduct(r));
+    } catch (err) {
+      if (err instanceof GoCommerceError && err.status === 404) return [];
+      throw err;
+    }
+  }
   async relatedTo(slug, limit) {
     const size = Math.min(100, Math.max(1, Number(limit) || PAGE_SIZE));
     const p = await this.findProduct(slug);
@@ -1629,6 +1703,88 @@ var CartService = class extends BaseService {
       throw err;
     }
   }
+  /**
+   * Adds an add-on from a product's "Complete the set" (D133) at its offer
+   * price. The product it is offered with has to be in the bag already, so
+   * this is called after adding it; the engine refuses one too many with the
+   * sentence the shopper is shown.
+   */
+  async addAddOn({ cartId, addOnId, qty = 1 }) {
+    const id2 = clean(cartId) ?? storedCartId();
+    if (!id2) throw new GoCommerceError("Add the product to your bag first.", 409);
+    return this.present(
+      await this.data(`/api/carts/${encodeURIComponent(id2)}/line-items`, {
+        method: "POST",
+        body: { add_on_id: Number(addOnId), quantity: Number(qty) }
+      })
+    );
+  }
+  /**
+   * The codes the shop chose to show (D133), each with what it takes off this
+   * bag or how much more the bag needs. None without a bag.
+   */
+  async getOffers({ cartId } = {}) {
+    const id2 = clean(cartId) ?? storedCartId();
+    if (!id2) return [];
+    try {
+      const rows = await this.data(`/api/carts/${encodeURIComponent(id2)}/offers`) ?? [];
+      const currency = await this.currency();
+      return rows.map((o) => toCartOffer(o, o.amount?.currency ?? o.remaining?.currency ?? currency));
+    } catch (err) {
+      if (err instanceof GoCommerceError && err.status === 404) return [];
+      throw err;
+    }
+  }
+  /**
+   * How far the bag is from free delivery (D133), read from the store's own
+   * rates for the country (the store's own when none is given). Null when
+   * the engine cannot say: a bar with a made-up figure is worse than none.
+   */
+  async getFreeShipping({ cartId, country, state } = {}) {
+    const id2 = clean(cartId) ?? storedCartId();
+    if (!id2) return null;
+    const where = country ?? cartExtras(id2).shippingAddress?.country ?? void 0;
+    try {
+      return toFreeShipping(
+        await this.data(`/api/carts/${encodeURIComponent(id2)}/free-shipping`, {
+          query: { country: where || void 0, state: state || void 0 }
+        })
+      );
+    } catch (err) {
+      if (err instanceof GoCommerceError && err.status === 404) return null;
+      throw err;
+    }
+  }
+  /**
+   * "You may be interested in" (D133): what the bag's products suggest, less
+   * what it holds; with nothing curated, the first product's related
+   * products, still less what it holds.
+   */
+  async listCrossSells({ cartId, limit = 12 } = {}) {
+    const id2 = clean(cartId) ?? storedCartId();
+    if (!id2) return [];
+    let curated = [];
+    try {
+      curated = await this.data(`/api/carts/${encodeURIComponent(id2)}/cross-sells`, { query: { limit } }) ?? [];
+    } catch (err) {
+      if (!(err instanceof GoCommerceError) || err.status !== 404) throw err;
+    }
+    if (curated.length) return curated.map((p) => toProduct(p));
+    let cart;
+    try {
+      cart = await this.data(`/api/carts/${encodeURIComponent(id2)}`);
+    } catch {
+      return [];
+    }
+    const held = new Set((cart.line_items ?? []).map((l) => String(l.product_id)));
+    const first = cart.line_items?.[0];
+    if (!first) return [];
+    const related = await new ProductService(this._fetch).listRelatedProducts({
+      product: String(first.product_id),
+      limit: limit + held.size
+    });
+    return related.data.filter((p) => !held.has(String(p.id))).slice(0, limit);
+  }
   /** `qty` is the new total; 0 takes the line out. */
   async updateCart({
     cartId,
@@ -2062,7 +2218,20 @@ var paymentMethodService = new PaymentMethodService();
 // src/services/coupon-service.ts
 var CouponService = class extends BaseService {
   async listCoupons(_args = {}) {
-    return emptyPage();
+    const offers = await new CartService(this._fetch).getOffers().catch(() => []);
+    if (!offers.length) return emptyPage();
+    const data = offers.map((o) => ({
+      id: o.code,
+      code: o.code,
+      title: o.title,
+      isPercent: o.isPercent,
+      amount: o.value,
+      minAmount: o.minAmount,
+      description: o.applies ? o.title : o.remaining !== null ? `${o.title}. Add ${o.remaining} more to use this.` : o.reason || o.title,
+      applies: o.applies,
+      remaining: o.remaining
+    }));
+    return { data, count: data.length, pageSize: data.length, noOfPage: 1, page: 1 };
   }
 };
 var couponService = new CouponService();
@@ -2812,7 +2981,10 @@ var StoreService = class extends BaseService {
         },
         // The footer's sign-up box posts to ext/newsletter, and the theme editor's footer
         // switch (D131) can only show it while that is on.
-        newsletter: { ...basePlugins.newsletter, ...flag(plugins.has("newsletter")) }
+        newsletter: { ...basePlugins.newsletter, ...flag(plugins.has("newsletter")) },
+        // Discount codes are core: every GoCommerce store takes them, so
+        // the code box is shown whatever the static record says.
+        isDiscountCoupons: { ...basePlugins.isDiscountCoupons, active: true }
       },
       ...menus?.length ? { menu: menus } : {},
       ...deliverable(base, ships),