@misiki/gocommerce-connector 0.10.0 → 0.12.0

package/dist/services/index.d.cts

@@ -1 +1 @@
-export { a as AddressService, c as Approval, e as AuthService, f as AutocompleteService, B as B2bPlaced, g as B2bRole, h as B2bService, i as BannerService, j as BaseService, k as BlogService, m as CartService, n as CatalogService, p as CategoryService, q as ChatService, t as CheckoutService, w as CollectionService, x as Company, y as CompanyOrder, z as ContactService, D as CountryService, E as CouponService, G as Credit, H as CurrencyService, J as DealService, K as DemoRequestService, L as EngineRequest, M as EnquiryService, Q as FaqService, R as FeedbackService, T as GalleryService, U as HomeLayout, V as HomeLayoutSection, W as HomeService, Y as InitService, Z as Invitation, _ as LayoutCollection, $ as LayoutPage, a0 as LayoutService, a1 as Lead, a3 as MeilisearchService, a4 as Member, a7 as MenuService, aa as NewsletterService, ae as OrderService, af as PageLayout, ag as PageService, ai as PaymentMethodService, ak as PluginService, ak as PluginsService, al as PopularSearchService, am as PopularityService, aq as ProductService, ar as ProfileService, as as Quote, at as REDIRECT_GATEWAYS, au as ReelsService, av as RegionService, aw as RejectedLine, az as ReviewService, aC as SearchService, aD as SettingService, aD as SettingsService, aF as StateService, aH as StoreService, aJ as StorefrontMenu, aM as ThemeSettings, aN as ThemeSettingsResult, aO as UploadService, aP as UserService, aS as VariantService, aT as VarniCustomDesignService, aU as VarniCustomProductService, aW as VendorService, aX as WarrantyService, a_ as WishlistService, a$ as addressService, b0 as authService, b1 as autocompleteService, b2 as b2bService, b3 as bannerService, b4 as blogService, b5 as cartService, b6 as categoryService, b7 as chatService, b8 as checkoutService, b9 as collectionService, ba as contactService, bb as countryService, bc as couponService, be as currencyService, bf as dealService, bg as demoRequestService, bi as emptyPage, bj as enquiryService, bk as faqService, bl as feedbackService, bp as galleryService, bq as homeService, br as initService, bs as layoutService, bt as mediaUrl, bu as meilisearchService, bv as menuService, bx as newsletterService, by as orderService, bz as ownDomain, bA as pageService, bB as paymentMethodService, bC as pluginService, bD as pluginsService, bE as popularSearchService, bF as popularityService, bI as productService, bJ as profileService, bK as qs, bL as reelsService, bM as regionService, bN as reviewService, bO as searchService, bP as setRequestHost, bQ as settingService, bR as settingsService, bS as stateService, bT as staticStore, bU as storeForHost, bV as storeService, c4 as toPage, c7 as toStorefrontFacets, cb as uploadService, cc as userService, cd as variantService, ce as varniCustomDesignService, cf as varniCustomProductService, cg as vendorService, ch as warrantyService, ci as wishlistService } from '../index-mqcHZ96i.cjs';
+export { b as AddressService, d as Approval, f as AuthService, g as AutocompleteService, B as B2bPlaced, h as B2bRole, i as B2bService, j as BannerService, k as BaseService, l as BlogService, o as CartService, p as CatalogService, r as CategoryService, s as ChatService, v as CheckoutService, y as CollectionService, z as Company, D as CompanyOrder, E as ContactService, F as CountryService, G as CouponService, I as Credit, J as CurrencyService, L as DealService, M as DemoRequestService, N as EngineRequest, O as EnquiryService, S as FaqService, T as FeedbackService, U as FooterSettings, X as GalleryService, Y as HeaderSettings, Z as HomeLayout, _ as HomeLayoutSection, $ as HomeService, a1 as InitService, a2 as Invitation, a3 as LayoutCollection, a4 as LayoutPage, a5 as LayoutService, a6 as Lead, a8 as MeilisearchService, a9 as Member, ac as MenuService, af as NewsletterService, aj as OrderService, ak as PageLayout, al as PageService, an as PaymentMethodService, ap as PluginService, ap as PluginsService, aq as PopularSearchService, ar as PopularityService, av as ProductService, aw as ProfileService, ax as Quote, ay as REDIRECT_GATEWAYS, az as ReelsService, aA as RegionService, aB as RejectedLine, aE as ReviewService, aH as SearchService, aI as SettingService, aI as SettingsService, aK as SiteChrome, aL as SiteFooter, aM as SiteHeader, aN as SocialLink, aO as StateService, aQ as StoreService, aS as StorefrontMenu, aV as ThemeSettings, aW as ThemeSettingsResult, aX as UploadService, aY as UserService, a$ as VariantService, b0 as VarniCustomDesignService, b1 as VarniCustomProductService, b3 as VendorService, b4 as WarrantyService, b7 as WishlistService, b8 as addressService, b9 as authService, ba as autocompleteService, bb as b2bService, bc as bannerService, bd as blogService, be as cartService, bf as categoryService, bg as chatService, bh as checkoutService, bi as collectionService, bj as contactService, bk as countryService, bl as couponService, bn as currencyService, bo as dealService, bp as demoRequestService, br as emptyPage, bs as enquiryService, bt as faqService, bu as feedbackService, by as galleryService, bz as homeService, bA as initService, bB as layoutService, bC as mediaUrl, bD as meilisearchService, bE as menuService, bG as newsletterService, bH as orderService, bI as ownDomain, bJ as pageService, bK as paymentMethodService, bL as pluginService, bM as pluginsService, bN as popularSearchService, bO as popularityService, bR as productService, bS as profileService, bT as qs, bU as reelsService, bV as regionService, bW as reviewService, bX as searchService, bY as setRequestHost, bZ as settingService, b_ as settingsService, b$ as stateService, c0 as staticStore, c1 as storeForHost, c2 as storeService, cg as toPage, cj as toStorefrontFacets, cn as uploadService, co as userService, cp as variantService, cq as varniCustomDesignService, cr as varniCustomProductService, cs as vendorService, ct as warrantyService, cu as wishlistService } from '../index-Bu4bVBBm.cjs';

package/dist/services/index.d.ts

@@ -1 +1 @@
-export { a as AddressService, c as Approval, e as AuthService, f as AutocompleteService, B as B2bPlaced, g as B2bRole, h as B2bService, i as BannerService, j as BaseService, k as BlogService, m as CartService, n as CatalogService, p as CategoryService, q as ChatService, t as CheckoutService, w as CollectionService, x as Company, y as CompanyOrder, z as ContactService, D as CountryService, E as CouponService, G as Credit, H as CurrencyService, J as DealService, K as DemoRequestService, L as EngineRequest, M as EnquiryService, Q as FaqService, R as FeedbackService, T as GalleryService, U as HomeLayout, V as HomeLayoutSection, W as HomeService, Y as InitService, Z as Invitation, _ as LayoutCollection, $ as LayoutPage, a0 as LayoutService, a1 as Lead, a3 as MeilisearchService, a4 as Member, a7 as MenuService, aa as NewsletterService, ae as OrderService, af as PageLayout, ag as PageService, ai as PaymentMethodService, ak as PluginService, ak as PluginsService, al as PopularSearchService, am as PopularityService, aq as ProductService, ar as ProfileService, as as Quote, at as REDIRECT_GATEWAYS, au as ReelsService, av as RegionService, aw as RejectedLine, az as ReviewService, aC as SearchService, aD as SettingService, aD as SettingsService, aF as StateService, aH as StoreService, aJ as StorefrontMenu, aM as ThemeSettings, aN as ThemeSettingsResult, aO as UploadService, aP as UserService, aS as VariantService, aT as VarniCustomDesignService, aU as VarniCustomProductService, aW as VendorService, aX as WarrantyService, a_ as WishlistService, a$ as addressService, b0 as authService, b1 as autocompleteService, b2 as b2bService, b3 as bannerService, b4 as blogService, b5 as cartService, b6 as categoryService, b7 as chatService, b8 as checkoutService, b9 as collectionService, ba as contactService, bb as countryService, bc as couponService, be as currencyService, bf as dealService, bg as demoRequestService, bi as emptyPage, bj as enquiryService, bk as faqService, bl as feedbackService, bp as galleryService, bq as homeService, br as initService, bs as layoutService, bt as mediaUrl, bu as meilisearchService, bv as menuService, bx as newsletterService, by as orderService, bz as ownDomain, bA as pageService, bB as paymentMethodService, bC as pluginService, bD as pluginsService, bE as popularSearchService, bF as popularityService, bI as productService, bJ as profileService, bK as qs, bL as reelsService, bM as regionService, bN as reviewService, bO as searchService, bP as setRequestHost, bQ as settingService, bR as settingsService, bS as stateService, bT as staticStore, bU as storeForHost, bV as storeService, c4 as toPage, c7 as toStorefrontFacets, cb as uploadService, cc as userService, cd as variantService, ce as varniCustomDesignService, cf as varniCustomProductService, cg as vendorService, ch as warrantyService, ci as wishlistService } from '../index-mqcHZ96i.js';
+export { b as AddressService, d as Approval, f as AuthService, g as AutocompleteService, B as B2bPlaced, h as B2bRole, i as B2bService, j as BannerService, k as BaseService, l as BlogService, o as CartService, p as CatalogService, r as CategoryService, s as ChatService, v as CheckoutService, y as CollectionService, z as Company, D as CompanyOrder, E as ContactService, F as CountryService, G as CouponService, I as Credit, J as CurrencyService, L as DealService, M as DemoRequestService, N as EngineRequest, O as EnquiryService, S as FaqService, T as FeedbackService, U as FooterSettings, X as GalleryService, Y as HeaderSettings, Z as HomeLayout, _ as HomeLayoutSection, $ as HomeService, a1 as InitService, a2 as Invitation, a3 as LayoutCollection, a4 as LayoutPage, a5 as LayoutService, a6 as Lead, a8 as MeilisearchService, a9 as Member, ac as MenuService, af as NewsletterService, aj as OrderService, ak as PageLayout, al as PageService, an as PaymentMethodService, ap as PluginService, ap as PluginsService, aq as PopularSearchService, ar as PopularityService, av as ProductService, aw as ProfileService, ax as Quote, ay as REDIRECT_GATEWAYS, az as ReelsService, aA as RegionService, aB as RejectedLine, aE as ReviewService, aH as SearchService, aI as SettingService, aI as SettingsService, aK as SiteChrome, aL as SiteFooter, aM as SiteHeader, aN as SocialLink, aO as StateService, aQ as StoreService, aS as StorefrontMenu, aV as ThemeSettings, aW as ThemeSettingsResult, aX as UploadService, aY as UserService, a$ as VariantService, b0 as VarniCustomDesignService, b1 as VarniCustomProductService, b3 as VendorService, b4 as WarrantyService, b7 as WishlistService, b8 as addressService, b9 as authService, ba as autocompleteService, bb as b2bService, bc as bannerService, bd as blogService, be as cartService, bf as categoryService, bg as chatService, bh as checkoutService, bi as collectionService, bj as contactService, bk as countryService, bl as couponService, bn as currencyService, bo as dealService, bp as demoRequestService, br as emptyPage, bs as enquiryService, bt as faqService, bu as feedbackService, by as galleryService, bz as homeService, bA as initService, bB as layoutService, bC as mediaUrl, bD as meilisearchService, bE as menuService, bG as newsletterService, bH as orderService, bI as ownDomain, bJ as pageService, bK as paymentMethodService, bL as pluginService, bM as pluginsService, bN as popularSearchService, bO as popularityService, bR as productService, bS as profileService, bT as qs, bU as reelsService, bV as regionService, bW as reviewService, bX as searchService, bY as setRequestHost, bZ as settingService, b_ as settingsService, b$ as stateService, c0 as staticStore, c1 as storeForHost, c2 as storeService, cg as toPage, cj as toStorefrontFacets, cn as uploadService, co as userService, cp as variantService, cq as varniCustomDesignService, cr as varniCustomProductService, cs as vendorService, ct as warrantyService, cu as wishlistService } from '../index-Bu4bVBBm.js';

package/dist/services/index.js

@@ -731,7 +731,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,
@@ -964,6 +969,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;
@@ -1288,6 +1332,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);
@@ -1627,6 +1701,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,
@@ -2060,7 +2216,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();
@@ -2658,21 +2827,38 @@ var MenuService = class extends BaseService {
     const m = await this.data(`/x/navigation/menus/${encodeURIComponent(handle)}`);
     return { menuId: m.handle, name: m.title, items: (m.items ?? []).map(toItem) };
   }
-  /** The header and footer menus, or `null` when the module is not there. Cached: a menu is store-level. */
+  /**
+   * The header and footer menus, or `null` when the module is not there. Cached: a menu is
+   * store-level. Each is the menu the shop chose for it in the theme editor's header or footer
+   * (GoCommerce D131), still under the `header` / `footer` id every storefront looks for, so the
+   * choice reaches every place that draws one; the menus named so are the default.
+   */
   async engineMenus() {
     if (!await this.facts.pluginOn("navigation")) return null;
     return remember(`${this.engineBase()}|${this.store ?? ""}|menus`, async () => {
       const out = [];
-      for (const handle of ["header", "footer"]) {
+      for (const part of ["header", "footer"]) {
         try {
-          const m = await this.data(`/x/navigation/menus/${handle}`);
-          out.push({ menuId: handle, name: m.title, items: (m.items ?? []).map(toItem) });
+          const handle = await this.chosenMenu(part);
+          const m = await this.data(`/x/navigation/menus/${encodeURIComponent(handle)}`);
+          out.push({ menuId: part, name: m.title, items: (m.items ?? []).map(toItem) });
         } catch {
         }
       }
       return out;
     }).catch(() => null);
   }
+  /** The handle of the menu the published header or footer names, else the part's own name. */
+  async chosenMenu(part) {
+    if (!await this.facts.pluginOn("layouts")) return part;
+    try {
+      const layout = await this.data(`/x/layouts/${part}`);
+      const menu = layout?.sections?.find((s) => s.type === part)?.settings?.menu;
+      return typeof menu === "string" && menu ? menu : part;
+    } catch {
+      return part;
+    }
+  }
 };
 var menuService = new MenuService();
 var readStaticStore = async () => {
@@ -2790,7 +2976,13 @@ var StoreService = class extends BaseService {
         isProductReviewsAndRatings: {
           ...basePlugins.isProductReviewsAndRatings,
           ...flag(plugins.has("product-reviews"))
-        }
+        },
+        // 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")) },
+        // 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),
@@ -2905,6 +3097,35 @@ var LayoutService = class extends BaseService {
       return null;
     }
   }
+  /**
+   * The header the shop set in the theme editor (D131), drawn on every
+   * page: the published one, or a preview key's draft. Null — the
+   * storefront's own header — when none is published, the editor is off, the
+   * engine is older, or anything fails: a header is never worth an error page.
+   */
+  async getHeader({ preview } = {}) {
+    return this.chrome("header", preview);
+  }
+  /** The footer the shop set in the theme editor (D131); null for the storefront's own, as getHeader. */
+  async getFooter({ preview } = {}) {
+    return this.chrome("footer", preview);
+  }
+  async chrome(page, preview) {
+    let layout;
+    try {
+      layout = await this.getPageLayout(page, { preview });
+    } catch {
+      return null;
+    }
+    const section = layout?.sections.find((s) => s.type === page);
+    if (!layout || !section) return null;
+    const settings = { ...section.settings };
+    let menu = null;
+    if (typeof settings.menu === "string" && settings.menu) {
+      menu = await new MenuService(this._fetch).getMenu(settings.menu).catch(() => null);
+    }
+    return { revision: layout.revision, preview: layout.preview, settings, menu };
+  }
 };
 function tokens(v) {
   return v && typeof v === "object" && !Array.isArray(v) && Object.keys(v).length ? { ...v } : null;