@misiki/gocommerce-connector 0.2.0 → 0.3.1

package/dist/{index-CJ836ZI3.d.cts → index-D8lNRhqJ.d.cts}

@@ -36,6 +36,14 @@ interface Credentials {
      * listing belong to, when the store sells through more than one.
      */
     channel?: string;
+    /**
+     * `PUBLIC_GOCOMMERCE_LANGUAGE` — the language to ask the engine for, `fr`. Sent
+     * as `?lang=` on every read, which wins over the browser's Accept-Language
+     * and needs no CORS preflight. Product titles and descriptions follow it when
+     * the store has a translator installed, and content pages always do. Unset,
+     * the engine answers in the store's default language.
+     */
+    language?: string;
 }
 
 /**
@@ -479,6 +487,20 @@ type SearchResult = {
     limit: number;
     offset: number;
 };
+/** One approved vendor's offer on a variant, from `GET /api/variants/{id}/offers`. Cheapest first. */
+type Offer = {
+    vendor_id: number;
+    vendor: string;
+    vendor_slug: string;
+    price: Money;
+    in_stock: boolean;
+    variant_id: number;
+};
+/** A menu's name, from `GET /x/navigation/menus`. */
+type MenuSummary = {
+    handle: string;
+    title: string;
+};
 
 /**
  * The state this connector keeps in the shopper's browser, and only there.
@@ -678,6 +700,7 @@ declare function toProduct(p: Product, extra?: {
     attributes: {
         name: string;
         value: string;
+        handle: string;
     }[];
     metadata: Record<string, unknown> | null;
     createdAt: string;
@@ -1105,6 +1128,16 @@ type EngineRequest = {
     /** Send the signed-in shopper's bearer token. Only ext/identity reads it. */
     auth?: boolean;
 };
+/**
+ * A media URL the shopper's browser can load. The engine answers its own
+ * uploads root-relative (`/media/ab12.png`), which a browser resolves against
+ * the storefront's origin, where no such file is. Through the proxy path when
+ * one is set — a root-relative path that reads the same in SSR and in the
+ * browser, so hydration agrees — and otherwise from the engine's origin.
+ * Absolute URLs, such as pictures the media library links rather than holds,
+ * pass through untouched.
+ */
+declare function mediaUrl(url: string | null | undefined): string | null;
 /**
  * BaseService — the one place this connector talks to the engine.
  *
@@ -1227,6 +1260,13 @@ type CatalogQuery = {
     category?: string;
     priceFrom?: number;
     priceTo?: number;
+    /**
+     * Attribute answers, `{ color: ['Red', 'Blue'] }`: one handle's values OR-ed,
+     * different handles AND-ed. The engine filters on them in the whole-shop
+     * listing only — its category route takes none — so inside a category they
+     * are not applied.
+     */
+    attributes?: Record<string, string[]>;
 };
 type CatalogPage = {
     data: ReturnType<typeof toProduct>[] | ReturnType<typeof fromSearchDoc>[];
@@ -1374,6 +1414,7 @@ declare class ProductService extends CatalogService {
         attributes: {
             name: string;
             value: string;
+            handle: string;
         }[];
         metadata: Record<string, unknown> | null;
         createdAt: string;
@@ -1486,6 +1527,7 @@ declare class ProductService extends CatalogService {
             attributes: {
                 name: string;
                 value: string;
+                handle: string;
             }[];
             metadata: Record<string, unknown> | null;
             createdAt: string;
@@ -1633,6 +1675,7 @@ declare class ProductService extends CatalogService {
             attributes: {
                 name: string;
                 value: string;
+                handle: string;
             }[];
             metadata: Record<string, unknown> | null;
             createdAt: string;
@@ -1779,6 +1822,7 @@ declare class ProductService extends CatalogService {
             attributes: {
                 name: string;
                 value: string;
+                handle: string;
             }[];
             metadata: Record<string, unknown> | null;
             createdAt: string;
@@ -1927,6 +1971,7 @@ declare class ProductService extends CatalogService {
             attributes: {
                 name: string;
                 value: string;
+                handle: string;
             }[];
             metadata: Record<string, unknown> | null;
             createdAt: string;
@@ -2130,6 +2175,7 @@ declare class SearchService extends CatalogService {
             attributes: {
                 name: string;
                 value: string;
+                handle: string;
             }[];
             metadata: Record<string, unknown> | null;
             createdAt: string;
@@ -2301,6 +2347,7 @@ declare class MeilisearchService extends CatalogService {
             attributes: {
                 name: string;
                 value: string;
+                handle: string;
             }[];
             metadata: Record<string, unknown> | null;
             createdAt: string;
@@ -2487,6 +2534,7 @@ declare class MeilisearchService extends CatalogService {
             attributes: {
                 name: string;
                 value: string;
+                handle: string;
             }[];
             metadata: Record<string, unknown> | null;
             createdAt: string;
@@ -2675,6 +2723,7 @@ declare class CollectionService extends BaseService {
             attributes: {
                 name: string;
                 value: string;
+                handle: string;
             }[];
             metadata: Record<string, unknown> | null;
             createdAt: string;
@@ -2782,6 +2831,7 @@ declare class CollectionService extends BaseService {
                 attributes: {
                     name: string;
                     value: string;
+                    handle: string;
                 }[];
                 metadata: Record<string, unknown> | null;
                 createdAt: string;
@@ -3858,8 +3908,37 @@ declare class CheckoutService extends BaseService {
     }>;
     checkoutStripe(): Promise<never>;
     checkoutStripeCapture(): Promise<never>;
-    checkoutPaypal(): Promise<never>;
-    capturePaypalPayment(): Promise<never>;
+    /**
+     * The storefront's generic redirect flow, which it reaches through the code
+     * `PAYPAL`. The engine has no PayPal gateway; paymentMethodService puts the
+     * store's first hosted-page gateway — Adyen, Paddle, Lemon Squeezy, Creem,
+     * Hyperswitch or RevenueCat — under that code, with its own name and a
+     * neutral icon, because this is the one storefront flow that sends a shopper
+     * to a URL and back. The shopper returns to the success page; the gateway's
+     * webhook tells the engine the order is paid.
+     */
+    checkoutPaypal({ cartId, origin }?: {
+        cartId?: string;
+        origin?: string;
+        return_url?: string;
+    }): Promise<{
+        redirect_url: string;
+        order_no: string;
+    }>;
+    /**
+     * Nothing to capture: a hosted-page gateway confirms the payment to the
+     * engine by webhook. Answering, rather than throwing, sends the storefront's
+     * process page on to the success page instead of the failure page.
+     */
+    capturePaypalPayment({ order_no, }?: {
+        order_no?: string;
+        token?: string;
+        PayerID?: string;
+        storeId?: string;
+    }): Promise<{
+        order_no: string | null;
+        status: string;
+    }>;
     checkoutCashfree(): Promise<never>;
     captureCashfreePayment(): Promise<never>;
     checkoutPhonepe(): Promise<never>;
@@ -3867,6 +3946,142 @@ declare class CheckoutService extends BaseService {
     confirmAffirmOrder(): Promise<never>;
     cancelAffirmOrder(): Promise<never>;
     checkoutPOS(): Promise<never>;
+    /**
+     * Any payment method the engine has switched on, by its engine code —
+     * `cod`, `stripe`, `razorpay`, `adyen`, `paddle`, `helcim`… For a storefront
+     * that drives the payment itself: the answer says what to do next.
+     *
+     * - `kind: 'none'` — nothing to pay now (cash on delivery).
+     * - `kind: 'client_action'` — mount the gateway's own widget with
+     *   `clientData`: Stripe's Payment Element takes `clientSecret`, Razorpay's
+     *   modal `razorpay_order_id` and `key_id`, Helcim's `checkout_token`.
+     * - `kind: 'redirect'` — send the shopper to `redirectUrl`; `returnUrl` is
+     *   where the gateway brings them back.
+     *
+     * Either way the gateway's webhook tells the engine when the money arrives;
+     * read `orderService.getOrder(orderNo).paymentStatus` to see it.
+     */
+    checkout(code: string, { cartId, returnUrl, paymentData, metadata, }?: {
+        cartId?: string;
+        returnUrl?: string;
+        paymentData?: Record<string, string>;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        orderNo: string;
+        order: {
+            id: string;
+            orderNo: string;
+            orderNumber: string;
+            number: string;
+            parentOrderNo: string;
+            status: string;
+            engineStatus: string;
+            paymentStatus: string;
+            paymentMethod: string;
+            currencyCode: string;
+            subtotal: number;
+            shippingCharges: number;
+            discount: number;
+            tax: number;
+            taxIncluded: boolean;
+            total: number;
+            refunded: number;
+            codCharges: number;
+            coupon: {
+                code: string;
+            } | null;
+            userEmail: string;
+            email: string;
+            phone: string | null;
+            shippingAddress: {
+                firstName: string;
+                lastName: string;
+                email: string | null;
+                phone: string | null;
+                address_1: string;
+                address_2: string;
+                city: string;
+                state: string;
+                zip: string;
+                country: string;
+                countryCode: string;
+            } | null;
+            billingAddress: {
+                firstName: string;
+                lastName: string;
+                email: string | null;
+                phone: string | null;
+                address_1: string;
+                address_2: string;
+                city: string;
+                state: string;
+                zip: string;
+                country: string;
+                countryCode: string;
+            } | null;
+            shippingMethod: string | null;
+            shippingRate: {
+                name: string;
+            } | null;
+            lineItems: {
+                id: string;
+                productId: string;
+                variantId: string;
+                sku: string;
+                title: string;
+                name: string;
+                slug: string;
+                thumbnail: string | null;
+                img: string | null;
+                variantTitle: string;
+                qty: number;
+                shippedQty: number;
+                price: number;
+                mrp: number;
+                subtotal: number;
+                total: number;
+                currencyCode: string;
+                status: string;
+                files: never[];
+                usedOptions: never[];
+            }[];
+            fulfillments: {
+                id: string;
+                status: string;
+                carrier: string;
+                trackingNumber: string | null;
+                trackingUrl: string | null;
+                lineItems: {
+                    id: string;
+                    title: string;
+                    qty: number;
+                }[];
+                createdAt: string;
+            }[];
+            tracking: never[];
+            orderHistory: never[];
+            isReplaceOrReturn: boolean;
+            createdAt: string;
+            updatedAt: string;
+        };
+        payment: {
+            kind: "none" | "client_action" | "redirect";
+            provider: string;
+            reference: string | null;
+            clientSecret: string;
+            redirectUrl: string;
+            clientData: Record<string, string>;
+        };
+    }>;
+    /** Every payment method the engine has switched on, by engine code and name — drivable here or not. */
+    listMethods(): Promise<{
+        methods: {
+            code: string;
+            name: string;
+        }[];
+        currency: string;
+    }>;
+    private redirectGateway;
     /**
      * One checkout attempt.
      *
@@ -3879,6 +4094,8 @@ declare class CheckoutService extends BaseService {
      */
     private place;
 }
+/** The engine's gateways that take payment on their own hosted page. */
+declare const REDIRECT_GATEWAYS: Set<string>;
 declare const checkoutService: CheckoutService;
 
 declare class PaymentMethodService extends BaseService {
@@ -4381,6 +4598,137 @@ declare class UserService extends BaseService {
         createdAt: string;
         updatedAt: string;
     }>;
+    /**
+     * Mails the signed-in shopper a link to confirm their address. The engine
+     * sends none at signup, and a confirmed address is what customer-group
+     * prices are keyed on. 409 once confirmed; 429 within a minute of the last.
+     */
+    requestEmailVerification(): Promise<{
+        accepted: boolean;
+    }>;
+    /** Extends the session another thirty days. The token stays the same. */
+    refreshSession(): Promise<{
+        id: string;
+        userId: string;
+        email: string;
+        phone: string | null;
+        firstName: string;
+        lastName: string;
+        name: string;
+        fullName: string;
+        avatar: null;
+        role: string;
+        emailVerified: boolean;
+        storeId: null;
+    }>;
+    /**
+     * Files a guest order under the signed-in account, so it appears in their
+     * order history. The order's access token is the proof of ownership: pass
+     * it, or leave it out for an order placed from this browser, whose token was
+     * kept at checkout.
+     *
+     * Never done automatically at sign-in. On a shared computer that would file
+     * one person's orders — address and all — under whoever signed in next.
+     */
+    claimOrder({ number, token }: {
+        number: string;
+        token?: string;
+    }): Promise<{
+        id: string;
+        orderNo: string;
+        orderNumber: string;
+        number: string;
+        parentOrderNo: string;
+        status: string;
+        engineStatus: string;
+        paymentStatus: string;
+        paymentMethod: string;
+        currencyCode: string;
+        subtotal: number;
+        shippingCharges: number;
+        discount: number;
+        tax: number;
+        taxIncluded: boolean;
+        total: number;
+        refunded: number;
+        codCharges: number;
+        coupon: {
+            code: string;
+        } | null;
+        userEmail: string;
+        email: string;
+        phone: string | null;
+        shippingAddress: {
+            firstName: string;
+            lastName: string;
+            email: string | null;
+            phone: string | null;
+            address_1: string;
+            address_2: string;
+            city: string;
+            state: string;
+            zip: string;
+            country: string;
+            countryCode: string;
+        } | null;
+        billingAddress: {
+            firstName: string;
+            lastName: string;
+            email: string | null;
+            phone: string | null;
+            address_1: string;
+            address_2: string;
+            city: string;
+            state: string;
+            zip: string;
+            country: string;
+            countryCode: string;
+        } | null;
+        shippingMethod: string | null;
+        shippingRate: {
+            name: string;
+        } | null;
+        lineItems: {
+            id: string;
+            productId: string;
+            variantId: string;
+            sku: string;
+            title: string;
+            name: string;
+            slug: string;
+            thumbnail: string | null;
+            img: string | null;
+            variantTitle: string;
+            qty: number;
+            shippedQty: number;
+            price: number;
+            mrp: number;
+            subtotal: number;
+            total: number;
+            currencyCode: string;
+            status: string;
+            files: never[];
+            usedOptions: never[];
+        }[];
+        fulfillments: {
+            id: string;
+            status: string;
+            carrier: string;
+            trackingNumber: string | null;
+            trackingUrl: string | null;
+            lineItems: {
+                id: string;
+                title: string;
+                qty: number;
+            }[];
+            createdAt: string;
+        }[];
+        tracking: never[];
+        orderHistory: never[];
+        isReplaceOrReturn: boolean;
+        createdAt: string;
+        updatedAt: string;
+    }>;
     deleteUser(): Promise<never>;
     checkEmail(): Promise<never>;
     joinAsVendor(): Promise<never>;
@@ -4698,6 +5046,7 @@ declare class WishlistService extends BaseService {
                 attributes: {
                     name: string;
                     value: string;
+                    handle: string;
                 }[];
                 metadata: Record<string, unknown> | null;
                 createdAt: string;
@@ -4730,9 +5079,16 @@ declare class WishlistService extends BaseService {
         productId: string;
         variantId?: string | null;
     }[]>;
-    private current;
-    private create;
-}
+    /**
+     * The address the store may write to when a saved product is back in stock
+     * or on sale; `''` takes it off. A list that does not exist yet is made.
+     */
+    setEmail(email: string): Promise<{
+        email: string | null;
+    }>;
+    private current;
+    private create;
+}
 declare const wishlistService: WishlistService;
 
 /**
@@ -4834,6 +5190,10 @@ type StorefrontMenuItem = {
 declare class MenuService extends BaseService {
     private readonly facts;
     list(_args?: Record<string, unknown>): Promise<{} | null>;
+    /** Every menu the store keeps, by handle — not only the header and footer. */
+    listMenus(): Promise<MenuSummary[]>;
+    /** One menu by handle, in the storefront's shape: `{ menuId, name, items: [{ id, name, link, items }] }`. */
+    getMenu(handle: string): Promise<StorefrontMenu>;
     /** The header and footer menus, or `null` when the module is not there. Cached: a menu is store-level. */
     engineMenus(): Promise<StorefrontMenu[] | null>;
 }
@@ -4872,6 +5232,12 @@ declare class StoreService extends BaseService {
      * clean 404 rather than a crash.
      */
     get<T = any>(path: string): Promise<T>;
+    /**
+     * The storefront's newsletter box posts `{ email }` to Litekart's
+     * `/api/newsletter/subscribe` through this verb; ext/newsletter is where
+     * that list lives here.
+     */
+    post<T = any>(path: string, data?: unknown): Promise<T>;
     private live;
 }
 declare const storeService: StoreService;
@@ -5274,6 +5640,7 @@ declare class AutocompleteService extends MeilisearchService {
             attributes: {
                 name: string;
                 value: string;
+                handle: string;
             }[];
             metadata: Record<string, unknown> | null;
             createdAt: string;
@@ -5421,4 +5788,675 @@ declare const varniCustomProductService: VarniCustomProductService;
 declare const pluginsService: PluginService;
 declare const settingsService: SettingService;
 
-export { type Plugin as $, type Address as A, BannerService as B, type Cart as C, DealService as D, type EngineRequest as E, EnquiryService as F, type Envelope as G, type Faq as H, FaqService as I, FeedbackService as J, type Fulfillment as K, GalleryService as L, HomeService as M, type IdentityAddress as N, InitService as O, type ListMeta as P, MeilisearchService as Q, type Menu as R, type MenuItem as S, MenuService as T, type Money as U, type Order as V, type OrderLine as W, OrderService as X, PageService as Y, type PaymentIntent as Z, PaymentMethodService as _, AddressService as a, meilisearchService as a$, PluginService as a0, PopularSearchService as a1, PopularityService as a2, type Product as a3, type ProductOption as a4, ProductService as a5, ProfileService as a6, ReelsService as a7, RegionService as a8, type Review as a9, authService as aA, autocompleteService as aB, bannerService as aC, blogService as aD, cartService as aE, categoryService as aF, chatService as aG, checkoutService as aH, collectionService as aI, contactService as aJ, countryService as aK, couponService as aL, currencyExponent as aM, currencyService as aN, dealService as aO, demoRequestService as aP, emptyCart as aQ, emptyPage as aR, enquiryService as aS, faqService as aT, feedbackService as aU, fromEngineAddress as aV, fromIdentityAddress as aW, fromSearchDoc as aX, galleryService as aY, homeService as aZ, initService as a_, type ReviewPage as aa, ReviewService as ab, type SearchDoc as ac, type SearchResult as ad, SearchService as ae, SettingService as af, type ShippingRate as ag, StateService as ah, StoreService as ai, type StorefrontCategory as aj, type StorefrontMenu as ak, type StorefrontOrder as al, type StorefrontProduct as am, UploadService as an, UserService as ao, type Variant as ap, type VariantImage as aq, VarniCustomDesignService as ar, VarniCustomProductService as as, type Vendor as at, VendorService as au, WarrantyService as av, type Wishlist as aw, type WishlistItem as ax, WishlistService as ay, addressService as az, type AppliedDiscount as b, menuService as b0, minorToMajor as b1, orderService as b2, pageService as b3, paymentMethodService as b4, pluginService as b5, pluginsService as b6, popularSearchService as b7, popularityService as b8, priceOf as b9, toUser as bA, toVariant as bB, toVendor as bC, uploadService as bD, userService as bE, varniCustomDesignService as bF, varniCustomProductService as bG, vendorService as bH, warrantyService as bI, wishlistService as bJ, productImages as ba, productService as bb, profileService as bc, qs as bd, reelsService as be, regionService as bf, reviewService as bg, searchService as bh, settingService as bi, settingsService as bj, stateService as bk, staticStore as bl, storeService as bm, toCart as bn, toCartLine as bo, toCategory as bp, toCmsPage as bq, toCollection as br, toEngineAddress as bs, toIdentityAddress as bt, toMajor as bu, toMinor as bv, toOrder as bw, toPage as bx, toProduct as by, toRating as bz, type AuthResponse as c, AuthService as d, AutocompleteService as e, BaseService as f, BlogService as g, type CartLine as h, CartService as i, CatalogService as j, type Category as k, CategoryService as l, ChatService as m, type CheckoutOptions as n, type CheckoutResult as o, CheckoutService as p, type CmsPage as q, type Collection as r, CollectionService as s, ContactService as t, CountryService as u, CouponService as v, type Credentials as w, CurrencyService as x, type Customer as y, DemoRequestService as z };
+/**
+ * Variants on their own, and the marketplace's offers on one.
+ *
+ * Svelte Commerce reads variants through their product, so this service is
+ * for code written against GoCommerce: it answers the engine's own shapes —
+ * numeric ids, money as `{ amount_minor, currency }` — with a major-unit
+ * `amount` added beside each price so a template need not divide.
+ */
+declare class VariantService extends BaseService {
+    /** A product's variants, inactive ones included (filter on `active`), in the merchant's order. */
+    list(productId: string | number, { page, limit }?: {
+        page?: number;
+        limit?: number;
+    }): Promise<{
+        data: {
+            price: {
+                amount: number;
+                amount_minor: number;
+                currency: string;
+            };
+            compare_at_price: {
+                amount: number;
+                amount_minor: number;
+                currency: string;
+            } | undefined;
+            id: number;
+            product_id: number;
+            sku: string;
+            barcode?: string;
+            taxable: boolean;
+            requires_shipping: boolean;
+            options: string[] | null;
+            label: string;
+            available: number;
+            track_inventory: boolean;
+            continue_selling: boolean;
+            active: boolean;
+            origin_country?: string;
+            hs_code?: string;
+            weight_grams?: number;
+            dimensions?: {
+                length_mm?: number;
+                width_mm?: number;
+                height_mm?: number;
+            };
+            images?: VariantImage[];
+            image?: VariantImage;
+            position: number;
+            metadata?: Record<string, unknown>;
+        }[];
+        meta: ListMeta | undefined;
+    }>;
+    getOne(id: string | number): Promise<{
+        price: {
+            amount: number;
+            amount_minor: number;
+            currency: string;
+        };
+        compare_at_price: {
+            amount: number;
+            amount_minor: number;
+            currency: string;
+        } | undefined;
+        id: number;
+        product_id: number;
+        sku: string;
+        barcode?: string;
+        taxable: boolean;
+        requires_shipping: boolean;
+        options: string[] | null;
+        label: string;
+        available: number;
+        track_inventory: boolean;
+        continue_selling: boolean;
+        active: boolean;
+        origin_country?: string;
+        hs_code?: string;
+        weight_grams?: number;
+        dimensions?: {
+            length_mm?: number;
+            width_mm?: number;
+            height_mm?: number;
+        };
+        images?: VariantImage[];
+        image?: VariantImage;
+        position: number;
+        metadata?: Record<string, unknown>;
+    }>;
+    /**
+     * What each approved seller asks for this variant, cheapest first. A cart
+     * line takes a variant, not an offer, so this informs a shopper rather than
+     * choosing who fulfils.
+     */
+    offers(variantId: string | number): Promise<{
+        price: {
+            amount: number;
+            amount_minor: number;
+            currency: string;
+        };
+        vendor_id: number;
+        vendor: string;
+        vendor_slug: string;
+        in_stock: boolean;
+        variant_id: number;
+    }[]>;
+}
+declare const variantService: VariantService;
+
+/**
+ * The signup box and its unsubscribe link (ext/newsletter). Subscribing twice
+ * is not an error, and unsubscribing answers the same whether or not the token
+ * matched, so neither call tells a stranger whether an address is on the list.
+ */
+declare class NewsletterService extends BaseService {
+    subscribe({ email, name, source }: {
+        email: string;
+        name?: string;
+        source?: string;
+    }): Promise<{
+        status: "subscribed";
+    }>;
+    /** The token from the unsubscribe link in a newsletter email. */
+    unsubscribe(token: string): Promise<{
+        status: "unsubscribed";
+    }>;
+}
+declare const newsletterService: NewsletterService;
+
+type B2bRole = 'admin' | 'approver' | 'buyer';
+type Company = {
+    id: number;
+    code: string;
+    name: string;
+    tax_id: string;
+    status: 'active' | 'on_hold' | 'closed';
+    group_id: number | null;
+    /** `null`: no account with the store — the company pays up front. */
+    credit_limit: Money | null;
+    net_days: number;
+    /** `null`: a buyer never needs approval. */
+    approval_threshold: Money | null;
+    require_po: boolean;
+    member_count: number;
+    /** More than 0: the company is a dealer, and receives leads. */
+    territory_count: number;
+    created_at: string;
+    updated_at: string;
+};
+type Credit = {
+    limit: Money | null;
+    outstanding: Money;
+    available: Money | null;
+    overdue: Money;
+    overdue_orders: number;
+    net_days: number;
+};
+type Member = {
+    company_id: number;
+    customer_id: number;
+    email: string;
+    confirmed: boolean;
+    name: string;
+    role: B2bRole;
+    created_at: string;
+};
+type Invitation = {
+    id: number;
+    company_id: number;
+    email: string;
+    role: B2bRole;
+    invited_by: string;
+    expires_at: string;
+    accepted_at?: string;
+    created_at: string;
+};
+type CompanyOrder = {
+    order_id: number;
+    number: string;
+    status: string;
+    payment_status: string;
+    total: Money;
+    po_number: string;
+    placed_by: string;
+    on_account: boolean;
+    due_at?: string;
+    overdue: boolean;
+    company_id: number;
+    company_name: string;
+    approval_id?: number;
+    quote_id?: number;
+    created_at: string;
+};
+type Approval = {
+    id: number;
+    company_id: number;
+    kind: 'cart' | 'quote';
+    quote_id?: number;
+    status: 'pending' | 'placing' | 'approved' | 'rejected' | 'cancelled';
+    requested_by: number;
+    requested_by_email: string;
+    lines: {
+        variant_id: number;
+        sku: string;
+        quantity: number;
+        unit_price: Money;
+    }[];
+    subtotal: Money;
+    total: Money;
+    payment_method: string;
+    po_number: string;
+    decided_by?: number;
+    decided_at?: string;
+    reason?: string;
+    last_error?: string;
+    order_id?: number;
+    order_number?: string;
+    created_at: string;
+    updated_at: string;
+};
+type Quote = {
+    id: number;
+    number: string;
+    company_id: number;
+    company_name: string;
+    status: 'requested' | 'quoted' | 'awaiting_approval' | 'accepted' | 'declined' | 'expired';
+    requested_by: number;
+    requested_by_email: string;
+    note: string;
+    reply: string;
+    declined_by?: string;
+    lines: {
+        variant_id: number;
+        sku: string;
+        title: string;
+        quantity: number;
+        unit_price: Money | null;
+    }[];
+    total: Money | null;
+    expires_at?: string;
+    quoted_at?: string;
+    accepted_at?: string;
+    order_id?: number;
+    order_number?: string;
+    created_at: string;
+    updated_at: string;
+};
+type Lead = {
+    id: number;
+    name: string;
+    email: string;
+    phone: string;
+    message: string;
+    country: string;
+    state: string;
+    postal_code: string;
+    variant_id: number | null;
+    product_id: number | null;
+    product_title?: string;
+    variant_sku?: string;
+    status: 'new' | 'contacted' | 'won' | 'lost';
+    company_id: number | null;
+    company_name?: string;
+    routed_by: 'territory' | 'store' | 'unrouted';
+    source: string;
+    created_at: string;
+    updated_at: string;
+};
+type RejectedLine = {
+    sku: string;
+    variant_id: number | null;
+    quantity: number;
+    reason: 'not_found' | 'inactive' | 'insufficient_stock' | 'invalid';
+    message: string;
+};
+type Paged<T> = {
+    data: T[];
+    meta?: ListMeta;
+};
+type PlaceOptions = {
+    /** An engine payment code; omitted, the company's account (`on_account`) when it has one. */
+    paymentMethod?: string;
+    /** Required when the company says so (`company.require_po`). */
+    poNumber?: string;
+    name?: string;
+    phone?: string;
+    /** Defaults to the address the checkout's address step kept for this cart. */
+    address?: StorefrontAddress | Address;
+};
+/** A checkout or quote acceptance either placed an order or, for a buyer over the limit, asked for approval. */
+type B2bPlaced = {
+    kind: 'order';
+    orderNo: string;
+    order: ReturnType<typeof toOrder>;
+    payment: PaymentIntent;
+} | {
+    kind: 'approval';
+    approval: Approval;
+};
+/**
+ * Buying for a business (ext/b2b): a company with buyers in roles, orders on
+ * account against a credit limit, approvals, quotes, a quick order by SKU, a
+ * repeat order, and a dealer's leads.
+ *
+ * Every call but `submitLead` needs a signed-in shopper (ext/identity) who is
+ * a member of a company; a signed-in account that is not answers 403, so
+ * `me()` is how a storefront tells a business account from a consumer one.
+ * Answers are the engine's own shapes — numeric ids, money as
+ * `{ amount_minor, currency }` — except carts, which come back as the
+ * storefront's bag so a quick-order page can hand them straight to it.
+ */
+declare class B2bService extends BaseService {
+    /** The company, the caller's role in it, and its credit: limit, outstanding, available, overdue. */
+    me(): Promise<{
+        company: Company;
+        role: B2bRole;
+        credit: Credit;
+    }>;
+    members(): Promise<Member[]>;
+    /** Admin only. Demoting the last admin is refused (409). */
+    setMemberRole(customerId: number | string, role: B2bRole): Promise<Member>;
+    /** An admin removes anyone; any member may remove themselves. */
+    removeMember(customerId: number | string): Promise<void>;
+    /** Admin only. Open invitations: not accepted, not expired. */
+    invitations(): Promise<Invitation[]>;
+    /** Admin only. Emails a link; a second invitation to the same address replaces the first. */
+    invite({ email, role }: {
+        email: string;
+        role: B2bRole;
+    }): Promise<Invitation>;
+    withdrawInvitation(invitationId: number | string): Promise<void>;
+    /**
+     * The token from the invitation email, accepted by the account it was sent
+     * to — which also confirms that account's email address.
+     */
+    acceptInvitation(token: string): Promise<Member>;
+    /**
+     * A quick order: up to 500 lines by SKU or variant id, into the bag (or a new
+     * one), at the company's prices. A line that will not go in is reported in
+     * `rejected` with its reason; the rest are added.
+     */
+    addLines({ cartId, lines, }: {
+        cartId?: string;
+        lines: {
+            sku?: string;
+            variantId?: number | string;
+            quantity: number;
+        }[];
+    }): Promise<{
+        cart: {
+            id: string;
+            status: "open" | "converted" | "abandoned";
+            email: string | null;
+            phone: string | null;
+            name: string | null;
+            lineItems: {
+                id: string;
+                productId: string;
+                variantId: string;
+                sku: string;
+                title: string;
+                name: string;
+                slug: string;
+                thumbnail: string | null;
+                variantTitle: string;
+                qty: number;
+                price: number;
+                mrp: number;
+                subtotal: number;
+                total: number;
+                inStock: boolean;
+                priceChanged: boolean;
+                currentPrice: number;
+                isSelectedForCheckout: boolean;
+                variant: {
+                    id: string;
+                    options: {
+                        option: {
+                            title: string;
+                        };
+                        value: string;
+                    }[];
+                };
+                product: {
+                    id: string;
+                    categories: unknown[];
+                };
+            }[];
+            qty: number;
+            currencyCode: string;
+            currency: string;
+            subtotal: number;
+            discountAmount: number;
+            savingAmount: number;
+            couponCode: string | null;
+            discount: AppliedDiscount | null;
+            shippingCharges: number;
+            shippingRateId: string | null;
+            shippingMethod: string | null;
+            tax: number;
+            taxIncluded: boolean;
+            codCharges: number;
+            total: number;
+            shippingAddress: StorefrontAddress | null;
+            shippingAddressId: string | null;
+            billingAddress: StorefrontAddress | null;
+            billingAddressId: string | null;
+            paymentMethod: null;
+            needAddress: boolean;
+            completedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+            expiresAt: string;
+        };
+        rejected: RejectedLine[];
+    }>;
+    /** A past order's lines in a new bag, at today's prices. Nothing is placed. */
+    reorder(orderId: number | string): Promise<{
+        cart: {
+            id: string;
+            status: "open" | "converted" | "abandoned";
+            email: string | null;
+            phone: string | null;
+            name: string | null;
+            lineItems: {
+                id: string;
+                productId: string;
+                variantId: string;
+                sku: string;
+                title: string;
+                name: string;
+                slug: string;
+                thumbnail: string | null;
+                variantTitle: string;
+                qty: number;
+                price: number;
+                mrp: number;
+                subtotal: number;
+                total: number;
+                inStock: boolean;
+                priceChanged: boolean;
+                currentPrice: number;
+                isSelectedForCheckout: boolean;
+                variant: {
+                    id: string;
+                    options: {
+                        option: {
+                            title: string;
+                        };
+                        value: string;
+                    }[];
+                };
+                product: {
+                    id: string;
+                    categories: unknown[];
+                };
+            }[];
+            qty: number;
+            currencyCode: string;
+            currency: string;
+            subtotal: number;
+            discountAmount: number;
+            savingAmount: number;
+            couponCode: string | null;
+            discount: AppliedDiscount | null;
+            shippingCharges: number;
+            shippingRateId: string | null;
+            shippingMethod: string | null;
+            tax: number;
+            taxIncluded: boolean;
+            codCharges: number;
+            total: number;
+            shippingAddress: StorefrontAddress | null;
+            shippingAddressId: string | null;
+            billingAddress: StorefrontAddress | null;
+            billingAddressId: string | null;
+            paymentMethod: null;
+            needAddress: boolean;
+            completedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+            expiresAt: string;
+        };
+        rejected: RejectedLine[];
+    }>;
+    /**
+     * Places the bag through the company: on account by default, with a PO
+     * number, optionally only some lines (`lineIds`). A buyer over the company's
+     * approval threshold gets `{ kind: 'approval' }` instead of an order — the
+     * bag stays as it was, and an approver places it later.
+     *
+     * Over the credit limit is 403 `credit_limit_exceeded`; `me().credit` says
+     * how much is available before the shopper tries.
+     */
+    checkout({ cartId, lineIds, shippingRateId, returnUrl, paymentData, ...opts }?: PlaceOptions & {
+        cartId?: string;
+        lineIds?: (number | string)[];
+        shippingRateId?: number | string;
+        returnUrl?: string;
+        paymentData?: Record<string, string>;
+    }): Promise<B2bPlaced>;
+    /** Admins and approvers see the company's; a buyer sees their own. `q` matches the number, PO or email. */
+    orders({ page, limit, q, overdue, }?: {
+        page?: number;
+        limit?: number;
+        q?: string;
+        overdue?: boolean;
+    }): Promise<Paged<CompanyOrder>>;
+    approvals({ page, limit, status, }?: {
+        page?: number;
+        limit?: number;
+        status?: Approval['status'];
+    }): Promise<Paged<Approval>>;
+    approval(approvalId: number | string): Promise<Approval>;
+    /**
+     * Admin or approver: places the requested order at the prices it was
+     * requested at. Credit limits and holds still apply. The payment intent is
+     * the approver's to act on — for an account order there is nothing to do.
+     */
+    approve(approvalId: number | string): Promise<{
+        approval: Approval;
+        orderNo: string;
+        order: {
+            id: string;
+            orderNo: string;
+            orderNumber: string;
+            number: string;
+            parentOrderNo: string;
+            status: string;
+            engineStatus: string;
+            paymentStatus: string;
+            paymentMethod: string;
+            currencyCode: string;
+            subtotal: number;
+            shippingCharges: number;
+            discount: number;
+            tax: number;
+            taxIncluded: boolean;
+            total: number;
+            refunded: number;
+            codCharges: number;
+            coupon: {
+                code: string;
+            } | null;
+            userEmail: string;
+            email: string;
+            phone: string | null;
+            shippingAddress: {
+                firstName: string;
+                lastName: string;
+                email: string | null;
+                phone: string | null;
+                address_1: string;
+                address_2: string;
+                city: string;
+                state: string;
+                zip: string;
+                country: string;
+                countryCode: string;
+            } | null;
+            billingAddress: {
+                firstName: string;
+                lastName: string;
+                email: string | null;
+                phone: string | null;
+                address_1: string;
+                address_2: string;
+                city: string;
+                state: string;
+                zip: string;
+                country: string;
+                countryCode: string;
+            } | null;
+            shippingMethod: string | null;
+            shippingRate: {
+                name: string;
+            } | null;
+            lineItems: {
+                id: string;
+                productId: string;
+                variantId: string;
+                sku: string;
+                title: string;
+                name: string;
+                slug: string;
+                thumbnail: string | null;
+                img: string | null;
+                variantTitle: string;
+                qty: number;
+                shippedQty: number;
+                price: number;
+                mrp: number;
+                subtotal: number;
+                total: number;
+                currencyCode: string;
+                status: string;
+                files: never[];
+                usedOptions: never[];
+            }[];
+            fulfillments: {
+                id: string;
+                status: string;
+                carrier: string;
+                trackingNumber: string | null;
+                trackingUrl: string | null;
+                lineItems: {
+                    id: string;
+                    title: string;
+                    qty: number;
+                }[];
+                createdAt: string;
+            }[];
+            tracking: never[];
+            orderHistory: never[];
+            isReplaceOrReturn: boolean;
+            createdAt: string;
+            updatedAt: string;
+        };
+        payment: PaymentIntent;
+    }>;
+    reject(approvalId: number | string, reason?: string): Promise<Approval>;
+    /** The buyer who asked withdraws the request. */
+    cancelApproval(approvalId: number | string): Promise<Approval>;
+    quotes({ page, limit, status }?: {
+        page?: number;
+        limit?: number;
+        status?: Quote['status'];
+    }): Promise<Paged<Quote>>;
+    quote(quoteId: number | string): Promise<Quote>;
+    /** Asks the store to price these lines. The store answers with unit prices and an expiry. */
+    requestQuote({ lines, note }: {
+        lines: {
+            variantId: number | string;
+            quantity: number;
+        }[];
+        note?: string;
+    }): Promise<Quote>;
+    /** Places the quote at its agreed prices — or, for a buyer over the threshold, asks for approval. */
+    acceptQuote(quoteId: number | string, opts?: PlaceOptions): Promise<B2bPlaced>;
+    declineQuote(quoteId: number | string): Promise<Quote>;
+    /**
+     * The public "find a dealer" form: no account needed. The engine routes it to
+     * the dealer whose territory covers the address — or keeps it — and answers
+     * the same either way, so the form never reveals who got it.
+     */
+    submitLead(lead: {
+        name?: string;
+        email?: string;
+        phone?: string;
+        message?: string;
+        country?: string;
+        state?: string;
+        postalCode?: string;
+        productId?: number | string;
+        variantId?: number | string;
+        source?: string;
+    }): Promise<{
+        accepted: boolean;
+    }>;
+    /** A dealer's admins and approvers: the leads routed to their company. */
+    leads({ page, limit, status }?: {
+        page?: number;
+        limit?: number;
+        status?: Lead['status'];
+    }): Promise<Paged<Lead>>;
+    setLeadStatus(leadId: number | string, status: Lead['status']): Promise<Lead>;
+    /** The fields checkout and quote acceptance share. Only declared ones: the engine refuses the rest. */
+    private placeBody;
+    private placed;
+}
+declare const b2bService: B2bService;
+
+export { type Menu as $, type Address as A, type B2bPlaced as B, type Cart as C, CountryService as D, CouponService as E, type Credentials as F, type Credit as G, CurrencyService as H, type Customer as I, DealService as J, DemoRequestService as K, type EngineRequest as L, EnquiryService as M, type Envelope as N, type Faq as O, FaqService as P, FeedbackService as Q, type Fulfillment as R, GalleryService as S, HomeService as T, type IdentityAddress as U, InitService as V, type Invitation as W, type Lead as X, type ListMeta as Y, MeilisearchService as Z, type Member as _, AddressService as a, contactService as a$, type MenuItem as a0, MenuService as a1, type MenuSummary as a2, type Money as a3, NewsletterService as a4, type Offer as a5, type Order as a6, type OrderLine as a7, OrderService as a8, PageService as a9, type StorefrontMenu as aA, type StorefrontOrder as aB, type StorefrontProduct as aC, UploadService as aD, UserService as aE, type Variant as aF, type VariantImage as aG, VariantService as aH, VarniCustomDesignService as aI, VarniCustomProductService as aJ, type Vendor as aK, VendorService as aL, WarrantyService as aM, type Wishlist as aN, type WishlistItem as aO, WishlistService as aP, addressService as aQ, authService as aR, autocompleteService as aS, b2bService as aT, bannerService as aU, blogService as aV, cartService as aW, categoryService as aX, chatService as aY, checkoutService as aZ, collectionService as a_, type PaymentIntent as aa, PaymentMethodService as ab, type Plugin as ac, PluginService as ad, PopularSearchService as ae, PopularityService as af, type Product as ag, type ProductOption as ah, ProductService as ai, ProfileService as aj, type Quote as ak, REDIRECT_GATEWAYS as al, ReelsService as am, RegionService as an, type RejectedLine as ao, type Review as ap, type ReviewPage as aq, ReviewService as ar, type SearchDoc as as, type SearchResult as at, SearchService as au, SettingService as av, type ShippingRate as aw, StateService as ax, StoreService as ay, type StorefrontCategory as az, type AppliedDiscount as b, varniCustomProductService as b$, countryService as b0, couponService as b1, currencyExponent as b2, currencyService as b3, dealService as b4, demoRequestService as b5, emptyCart as b6, emptyPage as b7, enquiryService as b8, faqService as b9, reviewService as bA, searchService as bB, settingService as bC, settingsService as bD, stateService as bE, staticStore as bF, storeService as bG, toCart as bH, toCartLine as bI, toCategory as bJ, toCmsPage as bK, toCollection as bL, toEngineAddress as bM, toIdentityAddress as bN, toMajor as bO, toMinor as bP, toOrder as bQ, toPage as bR, toProduct as bS, toRating as bT, toUser as bU, toVariant as bV, toVendor as bW, uploadService as bX, userService as bY, variantService as bZ, varniCustomDesignService as b_, feedbackService as ba, fromEngineAddress as bb, fromIdentityAddress as bc, fromSearchDoc as bd, galleryService as be, homeService as bf, initService as bg, mediaUrl as bh, meilisearchService as bi, menuService as bj, minorToMajor as bk, newsletterService as bl, orderService as bm, pageService as bn, paymentMethodService as bo, pluginService as bp, pluginsService as bq, popularSearchService as br, popularityService as bs, priceOf as bt, productImages as bu, productService as bv, profileService as bw, qs as bx, reelsService as by, regionService as bz, type Approval as c, vendorService as c0, warrantyService as c1, wishlistService as c2, type AuthResponse as d, AuthService as e, AutocompleteService as f, type B2bRole as g, B2bService as h, BannerService as i, BaseService as j, BlogService as k, type CartLine as l, CartService as m, CatalogService as n, type Category as o, CategoryService as p, ChatService as q, type CheckoutOptions as r, type CheckoutResult as s, CheckoutService as t, type CmsPage as u, type Collection as v, CollectionService as w, type Company as x, type CompanyOrder as y, ContactService as z };