@misiki/gocommerce-connector 0.23.0 → 0.24.0

package/dist/{index-BM6hYdQs.d.ts → index-BWg1KptA.d.ts}

@@ -257,6 +257,9 @@ type CartLine = {
     /** The add-on this line was bought as (D133), and the product it is offered with. */
     add_on_id?: number;
     add_on_for?: number;
+    /** The shopper's own design this line is made to (D162), and its picture. */
+    design_id?: string;
+    design_preview_url?: string;
     compare_at_price?: Money;
 };
 /** A variant offered with a product, optionally at an offer price (D133). */
@@ -346,6 +349,13 @@ type OrderLine = {
     shipped_quantity: number;
     unit_price: Money;
     total: Money;
+    /** `design` is a copy of the design a line was made to (D162), kept whatever later happens to it. */
+    metadata?: {
+        design?: {
+            id: string;
+            preview_url: string;
+        };
+    } & Record<string, unknown>;
 };
 type Fulfillment = {
     id: number;
@@ -448,6 +458,97 @@ type GoogleSurvey = {
     estimated_delivery_date: string;
     opt_in_style?: string;
 };
+/** `GET /x/customizer/products/{id}` (ext/customizer, D162): a product's design editor, in the mockup's pixels. */
+type CustomizerSetup = {
+    product_id: number;
+    mockup: {
+        url: string;
+        width: number;
+        height: number;
+    };
+    overlay_url: string | null;
+    print_area: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        radius: number;
+    };
+    print_size: {
+        width_mm: number;
+        height_mm: number;
+        dpi: number;
+    };
+    tools: {
+        upload: boolean;
+        text: boolean;
+        shapes: boolean;
+        background: boolean;
+        stickers: boolean;
+    };
+    fonts: {
+        key: string;
+        family: string;
+    }[];
+    stickers: {
+        id: number;
+        url: string;
+        width: number;
+        height: number;
+    }[];
+    min_photo_px: number;
+    consent: string;
+};
+/** `POST /x/customizer/uploads`: the file as the engine kept it, turned upright, so its size is as seen. */
+type CustomizerUpload = {
+    upload_id: string;
+    url: string;
+    width: number;
+    height: number;
+};
+/** `POST /x/customizer/designs`. */
+type CustomizerDesign = {
+    design_id: string;
+    preview_url: string;
+};
+/**
+ * A design, version 1, as the engine checks it and stores it on the order:
+ * coordinates in the mockup's pixels from the print area's top left corner,
+ * layers drawn first to last. The engine refuses a field a layer's type does
+ * not carry.
+ */
+type CustomizerDocument = {
+    version: 1;
+    background?: string | null;
+    layers: CustomizerLayer[];
+};
+type CustomizerLayer = {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    /** Degrees clockwise about the box's centre. */
+    rotation: number;
+    opacity: number;
+} & ({
+    type: 'image';
+    upload_id: string;
+} | {
+    type: 'text';
+    text: string;
+    font: string;
+    color: string;
+    font_size: number;
+    align?: 'left' | 'center' | 'right';
+} | {
+    type: 'shape';
+    shape: 'rect' | 'circle' | 'heart' | 'star';
+    color: string;
+} | {
+    type: 'sticker';
+    sticker_media_id: number;
+});
 /** `GET /api/store`: what anyone may read about the shop. */
 type StoreProfile = {
     name: string;
@@ -1021,6 +1122,9 @@ declare function toCartLine(l: CartLine, extra?: {
     /** The add-on this line was bought as (D133), or null on an ordinary line. */
     addOnId: string | null;
     addOnFor: string | null;
+    /** The shopper's own design this line is made to (D162) and its picture, or null on a line sold as it is. */
+    designId: string | null;
+    designPreview: string | null;
     subtotal: number;
     total: number;
     inStock: boolean;
@@ -1072,6 +1176,9 @@ declare function toCart(c: Cart, extras?: CartExtras, lineExtra?: (l: CartLine)
         /** The add-on this line was bought as (D133), or null on an ordinary line. */
         addOnId: string | null;
         addOnFor: string | null;
+        /** The shopper's own design this line is made to (D162) and its picture, or null on a line sold as it is. */
+        designId: string | null;
+        designPreview: string | null;
         subtotal: number;
         total: number;
         inStock: boolean;
@@ -1214,6 +1321,8 @@ declare function toOrder(o: Order): {
         total: number;
         currencyCode: string;
         status: string;
+        designId: string | null;
+        designPreview: string | null;
         files: never[];
         usedOptions: never[];
     }[];
@@ -3282,6 +3391,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -3368,6 +3479,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -3459,6 +3572,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -3526,14 +3641,17 @@ declare class CartService extends BaseService {
     }>;
     /**
      * `qty` is a change, not a total: +1 from a product page, −1 from a card's
-     * minus button. With no cart yet, one is opened and remembered.
+     * minus button. With no cart yet, one is opened and remembered. A
+     * `designId` from `customizerService.saveDesign` makes the variant to the
+     * shopper's design, on a line of its own.
      */
-    addToCart({ cartId, lineId, qty, variantId, }: {
+    addToCart({ cartId, lineId, qty, variantId, designId, }: {
         cartId?: string | null;
         lineId?: string | null;
         qty?: number;
         productId?: string;
         variantId?: string;
+        designId?: string;
     }): Promise<{
         id: string;
         status: "open" | "converted" | "abandoned";
@@ -3555,6 +3673,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -3651,6 +3771,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -3768,6 +3890,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -3857,6 +3981,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -3955,6 +4081,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -4049,6 +4177,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -4116,6 +4246,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -4206,6 +4338,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -4296,6 +4430,8 @@ declare class CartService extends BaseService {
             mrp: number;
             addOnId: string | null;
             addOnFor: string | null;
+            designId: string | null;
+            designPreview: string | null;
             subtotal: number;
             total: number;
             inStock: boolean;
@@ -4372,6 +4508,82 @@ declare class CartService extends BaseService {
 }
 declare const cartService: CartService;
 
+/** What a product's design editor draws and offers, in the mockup's pixels. */
+type CustomizerEditor = {
+    productId: string;
+    mockup: {
+        url: string;
+        width: number;
+        height: number;
+    };
+    /** Drawn above the design: the camera cut-out, the case's edges. */
+    overlayUrl: string | null;
+    printArea: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        radius: number;
+    };
+    printSize: {
+        widthMm: number;
+        heightMm: number;
+        dpi: number;
+    };
+    tools: {
+        upload: boolean;
+        text: boolean;
+        shapes: boolean;
+        background: boolean;
+        stickers: boolean;
+    };
+    fonts: {
+        key: string;
+        family: string;
+    }[];
+    stickers: {
+        id: number;
+        url: string;
+        width: number;
+        height: number;
+    }[];
+    /** A photo whose shorter side is below this is likely to print soft: warn, the engine still takes it. */
+    minPhotoPx: number;
+    /** Shown before the shopper chooses a photo. */
+    consent: string;
+};
+type CustomizerFile = {
+    uploadId: string;
+    url: string;
+    width: number;
+    height: number;
+};
+type CustomizerSavedDesign = {
+    designId: string;
+    previewUrl: string;
+};
+/**
+ * A shopper's own design on a product (ext/customizer, D162). Every URL goes
+ * through the proxy path when one is set, so it is same-origin and a canvas
+ * that draws it can still be exported.
+ */
+declare class CustomizerService extends BaseService {
+    private readonly facts;
+    /** Null when the product cannot be designed, or on any failure: the page draws without the editor. */
+    setup(productId: string | number): Promise<CustomizerEditor | null>;
+    /** A photo, or the finished preview or print file. The engine's refusal is thrown with its message. */
+    upload(file: Blob, filename?: string): Promise<CustomizerFile>;
+    /** The document goes as it is: the order keeps it, and whatever renders the print reads it there. */
+    saveDesign(design: {
+        productId: string | number;
+        variantId: string | number;
+        previewUploadId: string;
+        printUploadId: string;
+        document: CustomizerDocument;
+    }): Promise<CustomizerSavedDesign>;
+}
+declare const customizerService: CustomizerService;
+
 /**
  * Placing an order.
  *
@@ -4571,6 +4783,8 @@ declare class CheckoutService extends BaseService {
                 total: number;
                 currencyCode: string;
                 status: string;
+                designId: string | null;
+                designPreview: string | null;
                 files: never[];
                 usedOptions: never[];
             }[];
@@ -4780,6 +4994,8 @@ declare class OrderService extends BaseService {
                 total: number;
                 currencyCode: string;
                 status: string;
+                designId: string | null;
+                designPreview: string | null;
                 files: never[];
                 usedOptions: never[];
             }[];
@@ -4884,6 +5100,8 @@ declare class OrderService extends BaseService {
                 total: number;
                 currencyCode: string;
                 status: string;
+                designId: string | null;
+                designPreview: string | null;
                 files: never[];
                 usedOptions: never[];
             }[];
@@ -4986,6 +5204,8 @@ declare class OrderService extends BaseService {
             total: number;
             currencyCode: string;
             status: string;
+            designId: string | null;
+            designPreview: string | null;
             files: never[];
             usedOptions: never[];
         }[];
@@ -5110,6 +5330,8 @@ declare class OrderService extends BaseService {
                 total: number;
                 currencyCode: string;
                 status: string;
+                designId: string | null;
+                designPreview: string | null;
                 files: never[];
                 usedOptions: never[];
             }[];
@@ -5216,6 +5438,8 @@ declare class OrderService extends BaseService {
                 total: number;
                 currencyCode: string;
                 status: string;
+                designId: string | null;
+                designPreview: string | null;
                 files: never[];
                 usedOptions: never[];
             }[];
@@ -5334,6 +5558,8 @@ declare class OrderService extends BaseService {
                 total: number;
                 currencyCode: string;
                 status: string;
+                designId: string | null;
+                designPreview: string | null;
                 files: never[];
                 usedOptions: never[];
             }[];
@@ -5593,6 +5819,8 @@ declare class UserService extends BaseService {
             total: number;
             currencyCode: string;
             status: string;
+            designId: string | null;
+            designPreview: string | null;
             files: never[];
             usedOptions: never[];
         }[];
@@ -7433,6 +7661,8 @@ declare class B2bService extends BaseService {
                 mrp: number;
                 addOnId: string | null;
                 addOnFor: string | null;
+                designId: string | null;
+                designPreview: string | null;
                 subtotal: number;
                 total: number;
                 inStock: boolean;
@@ -7504,6 +7734,8 @@ declare class B2bService extends BaseService {
                 mrp: number;
                 addOnId: string | null;
                 addOnFor: string | null;
+                designId: string | null;
+                designPreview: string | null;
                 subtotal: number;
                 total: number;
                 inStock: boolean;
@@ -7663,6 +7895,8 @@ declare class B2bService extends BaseService {
                 total: number;
                 currencyCode: string;
                 status: string;
+                designId: string | null;
+                designPreview: string | null;
                 files: never[];
                 usedOptions: never[];
             }[];
@@ -7739,4 +7973,4 @@ declare class B2bService extends BaseService {
 }
 declare const b2bService: B2bService;
 
-export { type GoogleReviews as $, type AddOn as A, type B2bPlaced as B, type Cart as C, type CompanyOrder as D, ContactService as E, CountryService as F, CouponService as G, type Credentials as H, type Credit as I, CurrencyService as J, type Customer as K, DealService as L, DemoRequestService as M, type EngineRequest as N, EnquiryService as O, type Envelope as P, type FacetValue as Q, type Faq as R, FaqService as S, FeedbackService as T, type FooterSettings as U, type FreeShipping as V, type Fulfillment as W, GalleryService as X, type GooglePlace as Y, type GoogleReview as Z, GoogleReviewService as _, type Address as a, type StorefrontProduct as a$, type GoogleSurvey as a0, type HeaderSettings as a1, type HomeLayout as a2, type HomeLayoutSection as a3, HomeService as a4, type IdentityAddress as a5, InitService as a6, type Invitation as a7, type LayoutCollection as a8, type LayoutPage as a9, type ProductFacets as aA, type ProductOption as aB, ProductService as aC, ProfileService as aD, type Quote as aE, REDIRECT_GATEWAYS as aF, ReelsService as aG, RegionService as aH, type RejectedLine as aI, type Review as aJ, type ReviewPage as aK, ReviewService as aL, type SearchDoc as aM, type SearchResult as aN, SearchService as aO, SettingService as aP, type ShippingRate as aQ, type SiteChrome as aR, type SiteFooter as aS, type SiteHeader as aT, type SocialLink as aU, StateService as aV, type StoreProfile as aW, StoreService as aX, type StorefrontCategory as aY, type StorefrontMenu as aZ, type StorefrontOrder as a_, LayoutService as aa, type Lead as ab, type ListMeta as ac, MeilisearchService as ad, type Member as ae, type Menu as af, type MenuItem as ag, MenuService as ah, type MenuSummary as ai, type Money as aj, NewsletterService as ak, type Offer as al, type OpeningHours as am, type Order as an, type OrderLine as ao, OrderService as ap, type PageLayout as aq, PageService as ar, type PaymentIntent as as, PaymentMethodService as at, type Plugin as au, PluginService as av, PopularSearchService as aw, PopularityService as ax, type Postcode as ay, type Product as az, AddressService as b, productImages as b$, type ThemeSettings as b0, type ThemeSettingsResult as b1, UploadService as b2, UserService as b3, type Variant as b4, type VariantImage as b5, VariantService as b6, VarniCustomDesignService as b7, VarniCustomProductService as b8, type Vendor as b9, emptyCart as bA, emptyPage as bB, enquiryService as bC, faqService as bD, feedbackService as bE, fromEngineAddress as bF, fromIdentityAddress as bG, fromSearchDoc as bH, galleryService as bI, googleReviewService as bJ, homeService as bK, initService as bL, layoutService as bM, mediaUrl as bN, meilisearchService as bO, menuService as bP, minorToMajor as bQ, newsletterService as bR, orderService as bS, ownDomain as bT, pageService as bU, paymentMethodService as bV, pluginService as bW, pluginsService as bX, popularSearchService as bY, popularityService as bZ, priceOf as b_, VendorService as ba, WarrantyService as bb, type WhatsappConsent as bc, type WhatsappConsentOffer as bd, WhatsappService as be, type Wishlist as bf, type WishlistItem as bg, WishlistService as bh, addressService as bi, authService as bj, autocompleteService as bk, b2bService as bl, bannerService as bm, blogService as bn, cartService as bo, categoryService as bp, chatService as bq, checkoutService as br, collectionService as bs, contactService as bt, countryService as bu, couponService as bv, currencyExponent as bw, currencyService as bx, dealService as by, demoRequestService as bz, type AppliedDiscount as c, productService as c0, productVideos as c1, profileService as c2, qs as c3, reelsService as c4, regionService as c5, reviewService as c6, searchService as c7, setRequestHost as c8, settingService as c9, userService as cA, variantService as cB, varniCustomDesignService as cC, varniCustomProductService as cD, vendorService as cE, warrantyService as cF, whatsappService as cG, wishlistService as cH, settingsService as ca, stateService as cb, staticStore as cc, storeForHost as cd, storeService as ce, toAddOn as cf, toCart as cg, toCartLine as ch, toCartOffer as ci, toCategory as cj, toCmsPage as ck, toCollection as cl, toEngineAddress as cm, toFreeShipping as cn, toIdentityAddress as co, toMajor as cp, toMinor as cq, toOrder as cr, toPage as cs, toProduct as ct, toRating as cu, toStorefrontFacets as cv, toUser as cw, toVariant as cx, toVendor as cy, uploadService as cz, type Approval as d, type AuthResponse as e, AuthService as f, AutocompleteService as g, type B2bRole as h, B2bService as i, BannerService as j, BaseService as k, BlogService as l, type CartLine as m, type CartOffer as n, CartService as o, CatalogService as p, type Category as q, CategoryService as r, ChatService as s, type CheckoutOptions as t, type CheckoutResult as u, CheckoutService as v, type CmsPage as w, type Collection as x, CollectionService as y, type Company as z };
+export { FaqService as $, type AddOn as A, type B2bPlaced as B, type Cart as C, type CompanyOrder as D, ContactService as E, CountryService as F, CouponService as G, type Credentials as H, type Credit as I, CurrencyService as J, type Customer as K, type CustomizerDesign as L, type CustomizerDocument as M, type CustomizerEditor as N, type CustomizerFile as O, type CustomizerLayer as P, type CustomizerSavedDesign as Q, CustomizerService as R, type CustomizerSetup as S, type CustomizerUpload as T, DealService as U, DemoRequestService as V, type EngineRequest as W, EnquiryService as X, type Envelope as Y, type FacetValue as Z, type Faq as _, type Address as a, type SiteFooter as a$, FeedbackService as a0, type FooterSettings as a1, type FreeShipping as a2, type Fulfillment as a3, GalleryService as a4, type GooglePlace as a5, type GoogleReview as a6, GoogleReviewService as a7, type GoogleReviews as a8, type GoogleSurvey as a9, PageService as aA, type PaymentIntent as aB, PaymentMethodService as aC, type Plugin as aD, PluginService as aE, PopularSearchService as aF, PopularityService as aG, type Postcode as aH, type Product as aI, type ProductFacets as aJ, type ProductOption as aK, ProductService as aL, ProfileService as aM, type Quote as aN, REDIRECT_GATEWAYS as aO, ReelsService as aP, RegionService as aQ, type RejectedLine as aR, type Review as aS, type ReviewPage as aT, ReviewService as aU, type SearchDoc as aV, type SearchResult as aW, SearchService as aX, SettingService as aY, type ShippingRate as aZ, type SiteChrome as a_, type HeaderSettings as aa, type HomeLayout as ab, type HomeLayoutSection as ac, HomeService as ad, type IdentityAddress as ae, InitService as af, type Invitation as ag, type LayoutCollection as ah, type LayoutPage as ai, LayoutService as aj, type Lead as ak, type ListMeta as al, MeilisearchService as am, type Member as an, type Menu as ao, type MenuItem as ap, MenuService as aq, type MenuSummary as ar, type Money as as, NewsletterService as at, type Offer as au, type OpeningHours as av, type Order as aw, type OrderLine as ax, OrderService as ay, type PageLayout as az, AddressService as b, newsletterService as b$, type SiteHeader as b0, type SocialLink as b1, StateService as b2, type StoreProfile as b3, StoreService as b4, type StorefrontCategory as b5, type StorefrontMenu as b6, type StorefrontOrder as b7, type StorefrontProduct as b8, type ThemeSettings as b9, checkoutService as bA, collectionService as bB, contactService as bC, countryService as bD, couponService as bE, currencyExponent as bF, currencyService as bG, customizerService as bH, dealService as bI, demoRequestService as bJ, emptyCart as bK, emptyPage as bL, enquiryService as bM, faqService as bN, feedbackService as bO, fromEngineAddress as bP, fromIdentityAddress as bQ, fromSearchDoc as bR, galleryService as bS, googleReviewService as bT, homeService as bU, initService as bV, layoutService as bW, mediaUrl as bX, meilisearchService as bY, menuService as bZ, minorToMajor as b_, type ThemeSettingsResult as ba, UploadService as bb, UserService as bc, type Variant as bd, type VariantImage as be, VariantService as bf, VarniCustomDesignService as bg, VarniCustomProductService as bh, type Vendor as bi, VendorService as bj, WarrantyService as bk, type WhatsappConsent as bl, type WhatsappConsentOffer as bm, WhatsappService as bn, type Wishlist as bo, type WishlistItem as bp, WishlistService as bq, addressService as br, authService as bs, autocompleteService as bt, b2bService as bu, bannerService as bv, blogService as bw, cartService as bx, categoryService as by, chatService as bz, type AppliedDiscount as c, orderService as c0, ownDomain as c1, pageService as c2, paymentMethodService as c3, pluginService as c4, pluginsService as c5, popularSearchService as c6, popularityService as c7, priceOf as c8, productImages as c9, toMinor as cA, toOrder as cB, toPage as cC, toProduct as cD, toRating as cE, toStorefrontFacets as cF, toUser as cG, toVariant as cH, toVendor as cI, uploadService as cJ, userService as cK, variantService as cL, varniCustomDesignService as cM, varniCustomProductService as cN, vendorService as cO, warrantyService as cP, whatsappService as cQ, wishlistService as cR, productService as ca, productVideos as cb, profileService as cc, qs as cd, reelsService as ce, regionService as cf, reviewService as cg, searchService as ch, setRequestHost as ci, settingService as cj, settingsService as ck, stateService as cl, staticStore as cm, storeForHost as cn, storeService as co, toAddOn as cp, toCart as cq, toCartLine as cr, toCartOffer as cs, toCategory as ct, toCmsPage as cu, toCollection as cv, toEngineAddress as cw, toFreeShipping as cx, toIdentityAddress as cy, toMajor as cz, type Approval as d, type AuthResponse as e, AuthService as f, AutocompleteService as g, type B2bRole as h, B2bService as i, BannerService as j, BaseService as k, BlogService as l, type CartLine as m, type CartOffer as n, CartService as o, CatalogService as p, type Category as q, CategoryService as r, ChatService as s, type CheckoutOptions as t, type CheckoutResult as u, CheckoutService as v, type CmsPage as w, type Collection as x, CollectionService as y, type Company as z };

package/dist/index.cjs

@@ -377,7 +377,8 @@ var BaseService = class _BaseService {
     const lang = (req.method ?? "GET") === "GET" ? this.creds.language : void 0;
     const url = this.engineURL(path, lang ? { lang, ...req.query } : req.query);
     const headers = { Accept: "application/json", ...req.headers };
-    if (req.body !== void 0) headers["Content-Type"] = "application/json";
+    const form = req.body instanceof FormData ? req.body : void 0;
+    if (req.body !== void 0 && !form) headers["Content-Type"] = "application/json";
     const store = this.store;
     if (store) headers["X-Store"] = store;
     if (req.auth) {
@@ -388,7 +389,7 @@ var BaseService = class _BaseService {
     const init = {
       method: req.method ?? "GET",
       headers,
-      body: req.body === void 0 ? void 0 : JSON.stringify(req.body)
+      body: form ?? (req.body === void 0 ? void 0 : JSON.stringify(req.body))
     };
     let res;
     try {
@@ -844,6 +845,9 @@ function toCartLine(l, extra = {}) {
     /** 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,
+    /** The shopper's own design this line is made to (D162) and its picture, or null on a line sold as it is. */
+    designId: l.design_id ?? null,
+    designPreview: mediaUrl(l.design_preview_url),
     subtotal: toMajor(l.total),
     total: toMajor(l.total),
     inStock: l.in_stock,
@@ -958,6 +962,8 @@ function toOrderLine(l, currency) {
     total: toMajor(l.total),
     currencyCode: currency,
     status: l.shipped_quantity >= l.quantity ? "Shipped" : "Pending",
+    designId: l.metadata?.design?.id ?? null,
+    designPreview: mediaUrl(l.metadata?.design?.preview_url),
     files: [],
     usedOptions: []
   };
@@ -1775,13 +1781,16 @@ var CartService = class extends BaseService {
   }
   /**
    * `qty` is a change, not a total: +1 from a product page, −1 from a card's
-   * minus button. With no cart yet, one is opened and remembered.
+   * minus button. With no cart yet, one is opened and remembered. A
+   * `designId` from `customizerService.saveDesign` makes the variant to the
+   * shopper's design, on a line of its own.
    */
   async addToCart({
     cartId,
     lineId,
     qty = 1,
-    variantId
+    variantId,
+    designId
   }) {
     let id2 = clean(cartId) ?? storedCartId();
     if (lineId && id2) {
@@ -1795,21 +1804,16 @@ var CartService = class extends BaseService {
     if (qty === REMOVE || Number(qty) <= 0) return this.getCartByCartId(id2);
     if (!variantId) throw new GoCommerceError("Please choose an option before adding this to your bag.", 400);
     if (!id2) id2 = await this.open();
+    const body = { variant_id: Number(variantId), quantity: Number(qty), ...designId ? { design_id: designId } : {} };
     try {
       return await this.present(
-        await this.data(`/api/carts/${encodeURIComponent(id2)}/line-items`, {
-          method: "POST",
-          body: { variant_id: Number(variantId), quantity: Number(qty) }
-        })
+        await this.data(`/api/carts/${encodeURIComponent(id2)}/line-items`, { method: "POST", body })
       );
     } catch (err) {
-      if (err instanceof GoCommerceError && (err.status === 404 || /checked out/.test(err.message))) {
+      if (err instanceof GoCommerceError && /cart not found|checked out/.test(err.message)) {
         const fresh = await this.open();
         return this.present(
-          await this.data(`/api/carts/${encodeURIComponent(fresh)}/line-items`, {
-            method: "POST",
-            body: { variant_id: Number(variantId), quantity: Number(qty) }
-          })
+          await this.data(`/api/carts/${encodeURIComponent(fresh)}/line-items`, { method: "POST", body })
         );
       }
       throw err;
@@ -2046,6 +2050,54 @@ var CartService = class extends BaseService {
 var clean = (id2) => id2 && id2 !== "undefined" && id2 !== "null" ? id2 : null;
 var cartService = new CartService();
 
+// src/services/customizer-service.ts
+var CustomizerService = class extends BaseService {
+  facts = new StoreFacts(this._fetch);
+  /** Null when the product cannot be designed, or on any failure: the page draws without the editor. */
+  async setup(productId) {
+    const plugins = await this.facts.plugins().catch(() => null);
+    if (plugins && !plugins.has("customizer")) return null;
+    const path = `/x/customizer/products/${encodeURIComponent(String(productId))}`;
+    const s = await this.data(path).catch(() => null);
+    if (!s) return null;
+    return {
+      productId: String(s.product_id),
+      mockup: { ...s.mockup, url: media(s.mockup.url) },
+      overlayUrl: mediaUrl(s.overlay_url),
+      printArea: s.print_area,
+      printSize: { widthMm: s.print_size.width_mm, heightMm: s.print_size.height_mm, dpi: s.print_size.dpi },
+      tools: s.tools,
+      fonts: s.fonts,
+      stickers: s.stickers.map((k) => ({ ...k, url: media(k.url) })),
+      minPhotoPx: s.min_photo_px,
+      consent: s.consent
+    };
+  }
+  /** A photo, or the finished preview or print file. The engine's refusal is thrown with its message. */
+  async upload(file, filename) {
+    const body = new FormData();
+    body.append("file", file, filename);
+    const u = await this.data("/x/customizer/uploads", { method: "POST", body });
+    return { uploadId: u.upload_id, url: media(u.url), width: u.width, height: u.height };
+  }
+  /** The document goes as it is: the order keeps it, and whatever renders the print reads it there. */
+  async saveDesign(design) {
+    const d = await this.data("/x/customizer/designs", {
+      method: "POST",
+      body: {
+        product_id: Number(design.productId),
+        variant_id: Number(design.variantId),
+        preview_upload_id: design.previewUploadId,
+        print_upload_id: design.printUploadId,
+        document: design.document
+      }
+    });
+    return { designId: d.design_id, previewUrl: media(d.preview_url) };
+  }
+};
+var media = (url) => mediaUrl(url) ?? url;
+var customizerService = new CustomizerService();
+
 // src/services/checkout-service.ts
 var CheckoutService = class extends BaseService {
   /** Delivery options for the address on the cart: `{ data: [{ id, name, base_rate }] }`. */
@@ -4042,6 +4094,7 @@ exports.ContactService = ContactService;
 exports.CountryService = CountryService;
 exports.CouponService = CouponService;
 exports.CurrencyService = CurrencyService;
+exports.CustomizerService = CustomizerService;
 exports.DealService = DealService;
 exports.DemoRequestService = DemoRequestService;
 exports.EnquiryService = EnquiryService;
@@ -4102,6 +4155,7 @@ exports.countryService = countryService;
 exports.couponService = couponService;
 exports.currencyExponent = currencyExponent;
 exports.currencyService = currencyService;
+exports.customizerService = customizerService;
 exports.dealService = dealService;
 exports.demoRequestService = demoRequestService;
 exports.emptyCart = emptyCart;