@misiki/gocommerce-connector 0.11.0 → 0.13.0

package/dist/index.cjs

@@ -498,9 +498,27 @@ function productImages(p) {
     if (url && !out.includes(url)) out.push(url);
   };
   push(mediaUrl(p.image_url));
+  for (const m of arr(p.media)) if (m.kind === "image") push(mediaUrl(m.url));
   for (const v of arr(p.variants)) for (const url of variantImages(v)) push(url);
   return out;
 }
+function productVideos(p) {
+  const out = [];
+  for (const m of arr(p.media)) {
+    const url = m.kind === "video" ? mediaUrl(m.url) : null;
+    if (url && !out.includes(url)) out.push(url);
+  }
+  return out;
+}
+function highlightsOf(p) {
+  const raw = p.metadata?.highlights;
+  if (!Array.isArray(raw)) return [];
+  return raw.filter((s) => typeof s === "string").map((s) => s.trim()).filter(Boolean);
+}
+function freeGiftOf(p) {
+  const raw = p.metadata?.free_gift;
+  return typeof raw === "string" && raw.trim() ? raw.trim() : null;
+}
 function toVariant(v, p, optionless) {
   const images = variantImages(v);
   const options = arr(p.options);
@@ -548,6 +566,7 @@ function toProduct(p, extra = {}) {
   const lead = live[0] ?? arr(p.variants)[0];
   const optionless = arr(p.options).length === 0;
   const images = productImages(p);
+  const videos = productVideos(p);
   const prices = live.map((v) => toMajor(v.price));
   const tracked = live.filter((v) => v.track_inventory);
   const category = p.category;
@@ -574,8 +593,14 @@ function toProduct(p, extra = {}) {
     originCountry: lead?.origin_country ?? null,
     thumbnail: images[0] ?? null,
     image_url: images[0] ?? null,
-    images: images.join(","),
+    images: [...images, ...videos].join(","),
     imageList: images,
+    videos,
+    // What the buy box says beside the price (D134): plain text, drawn as text.
+    highlights: highlightsOf(p),
+    freeGift: freeGiftOf(p),
+    // Counted by the engine, rounded down, and absent rather than zero.
+    soldAtLeast: typeof p.sold_at_least === "number" && p.sold_at_least > 0 ? p.sold_at_least : null,
     // Product-level stock is what a card shows before a variant is picked:
     // buyable when any live variant is, counted only where counting means
     // something.
@@ -748,7 +773,9 @@ function toIdentityAddress(a) {
     state: e.state ?? "",
     postal_code: e.postal_code,
     country: e.country,
-    ...a.label ? { label: String(a.label) } : {},
+    // Sent whenever the form has it, empty included: the engine keeps a label it is not sent, so
+    // leaving out an emptied one would keep the old Home or Work (D134).
+    ...typeof a.label === "string" ? { label: a.label } : {},
     ...a.isPrimary ? { is_default: true } : {}
   };
 }
@@ -765,7 +792,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,
@@ -999,6 +1031,45 @@ function toUser(c) {
   };
 }
 var priceOf = (m) => m ? toMajor(m) : 0;
+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/services/facts.ts
 var StoreFacts = class extends BaseService {
@@ -1309,6 +1380,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);
@@ -1648,6 +1749,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,
@@ -2081,7 +2264,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();
@@ -2519,6 +2715,24 @@ var AddressService = class extends BaseService {
     });
     return fromIdentityAddress(a, currentMe()?.email);
   }
+  /**
+   * The city and state for a postcode (D134), for the address form to fill
+   * in. India's six-digit PIN codes only, from the directory the engine was
+   * given; null for anything it cannot answer, so the form simply leaves the
+   * fields to the shopper.
+   */
+  async lookupPostcode({ country = "IN", postcode }) {
+    const code = String(postcode ?? "").trim();
+    const cc = String(country ?? "").trim().toUpperCase();
+    if (cc !== "IN" || !/^[1-9][0-9]{5}$/.test(code)) return null;
+    try {
+      const p = await this.data(`/api/postcodes/${cc}/${code}`);
+      return { country: p.country, postcode: p.postcode, city: p.city, state: p.state, stateCode: p.state_code };
+    } catch (err) {
+      if (err instanceof GoCommerceError && (err.status === 404 || err.status === 400)) return null;
+      throw err;
+    }
+  }
   async deleteAddress(id2) {
     await this.engine(`/x/identity/me/addresses/${enc(id2)}`, { method: "DELETE", auth: true });
     return { id: String(id2), deleted: true };
@@ -2828,7 +3042,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),
@@ -3640,6 +3857,7 @@ exports.popularityService = popularityService;
 exports.priceOf = priceOf;
 exports.productImages = productImages;
 exports.productService = productService;
+exports.productVideos = productVideos;
 exports.profileService = profileService;
 exports.qs = qs;
 exports.readStaticStore = readStaticStore;
@@ -3656,12 +3874,15 @@ exports.stateService = stateService;
 exports.staticStore = staticStore;
 exports.storeForHost = storeForHost;
 exports.storeService = storeService;
+exports.toAddOn = toAddOn;
 exports.toCart = toCart;
 exports.toCartLine = toCartLine;
+exports.toCartOffer = toCartOffer;
 exports.toCategory = toCategory;
 exports.toCmsPage = toCmsPage;
 exports.toCollection = toCollection;
 exports.toEngineAddress = toEngineAddress;
+exports.toFreeShipping = toFreeShipping;
 exports.toIdentityAddress = toIdentityAddress;
 exports.toMajor = toMajor;
 exports.toMinor = toMinor;