@misiki/gocommerce-connector 0.11.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, S as FooterSettings, U as GalleryService, V as HeaderSettings, W as HomeLayout, X as HomeLayoutSection, Y as HomeService, _ as InitService, $ as Invitation, a0 as LayoutCollection, a1 as LayoutPage, a2 as LayoutService, a3 as Lead, a5 as MeilisearchService, a6 as Member, a9 as MenuService, ac as NewsletterService, ag as OrderService, ah as PageLayout, ai as PageService, ak as PaymentMethodService, am as PluginService, am as PluginsService, an as PopularSearchService, ao as PopularityService, as as ProductService, at as ProfileService, au as Quote, av as REDIRECT_GATEWAYS, aw as ReelsService, ax as RegionService, ay as RejectedLine, aB as ReviewService, aE as SearchService, aF as SettingService, aF as SettingsService, aH as SiteChrome, aI as SiteFooter, aJ as SiteHeader, aK as SocialLink, aL as StateService, aN as StoreService, aP as StorefrontMenu, aS as ThemeSettings, aT as ThemeSettingsResult, aU as UploadService, aV as UserService, aY as VariantService, aZ as VarniCustomDesignService, a_ as VarniCustomProductService, b0 as VendorService, b1 as WarrantyService, b4 as WishlistService, b5 as addressService, b6 as authService, b7 as autocompleteService, b8 as b2bService, b9 as bannerService, ba as blogService, bb as cartService, bc as categoryService, bd as chatService, be as checkoutService, bf as collectionService, bg as contactService, bh as countryService, bi as couponService, bk as currencyService, bl as dealService, bm as demoRequestService, bo as emptyPage, bp as enquiryService, bq as faqService, br as feedbackService, bv as galleryService, bw as homeService, bx as initService, by as layoutService, bz as mediaUrl, bA as meilisearchService, bB as menuService, bD as newsletterService, bE as orderService, bF as ownDomain, bG as pageService, bH as paymentMethodService, bI as pluginService, bJ as pluginsService, bK as popularSearchService, bL as popularityService, bO as productService, bP as profileService, bQ as qs, bR as reelsService, bS as regionService, bT as reviewService, bU as searchService, bV as setRequestHost, bW as settingService, bX as settingsService, bY as stateService, bZ as staticStore, b_ as storeForHost, b$ as storeService, ca as toPage, cd as toStorefrontFacets, ch as uploadService, ci as userService, cj as variantService, ck as varniCustomDesignService, cl as varniCustomProductService, cm as vendorService, cn as warrantyService, co as wishlistService } from '../index-90wdO5MM.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, S as FooterSettings, U as GalleryService, V as HeaderSettings, W as HomeLayout, X as HomeLayoutSection, Y as HomeService, _ as InitService, $ as Invitation, a0 as LayoutCollection, a1 as LayoutPage, a2 as LayoutService, a3 as Lead, a5 as MeilisearchService, a6 as Member, a9 as MenuService, ac as NewsletterService, ag as OrderService, ah as PageLayout, ai as PageService, ak as PaymentMethodService, am as PluginService, am as PluginsService, an as PopularSearchService, ao as PopularityService, as as ProductService, at as ProfileService, au as Quote, av as REDIRECT_GATEWAYS, aw as ReelsService, ax as RegionService, ay as RejectedLine, aB as ReviewService, aE as SearchService, aF as SettingService, aF as SettingsService, aH as SiteChrome, aI as SiteFooter, aJ as SiteHeader, aK as SocialLink, aL as StateService, aN as StoreService, aP as StorefrontMenu, aS as ThemeSettings, aT as ThemeSettingsResult, aU as UploadService, aV as UserService, aY as VariantService, aZ as VarniCustomDesignService, a_ as VarniCustomProductService, b0 as VendorService, b1 as WarrantyService, b4 as WishlistService, b5 as addressService, b6 as authService, b7 as autocompleteService, b8 as b2bService, b9 as bannerService, ba as blogService, bb as cartService, bc as categoryService, bd as chatService, be as checkoutService, bf as collectionService, bg as contactService, bh as countryService, bi as couponService, bk as currencyService, bl as dealService, bm as demoRequestService, bo as emptyPage, bp as enquiryService, bq as faqService, br as feedbackService, bv as galleryService, bw as homeService, bx as initService, by as layoutService, bz as mediaUrl, bA as meilisearchService, bB as menuService, bD as newsletterService, bE as orderService, bF as ownDomain, bG as pageService, bH as paymentMethodService, bI as pluginService, bJ as pluginsService, bK as popularSearchService, bL as popularityService, bO as productService, bP as profileService, bQ as qs, bR as reelsService, bS as regionService, bT as reviewService, bU as searchService, bV as setRequestHost, bW as settingService, bX as settingsService, bY as stateService, bZ as staticStore, b_ as storeForHost, b$ as storeService, ca as toPage, cd as toStorefrontFacets, ch as uploadService, ci as userService, cj as variantService, ck as varniCustomDesignService, cl as varniCustomProductService, cm as vendorService, cn as warrantyService, co as wishlistService } from '../index-90wdO5MM.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();
@@ -2810,7 +2979,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),