@takeshape/purchase-order-chat 1.51.0-beta.1

package/dist/tailwind.d.ts

@@ -0,0 +1,1502 @@
+import { JSX } from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+import { RequestOptions } from 'graphql-request';
+import { ResultOf } from 'gql.tada';
+import { TadaDocumentNode } from 'gql.tada';
+import { Variables } from 'graphql-request';
+
+declare class B2BClient {
+    private b2bToken;
+    private companyId;
+    private channelId;
+    private graphQLClient;
+    private getB2BJwt;
+    readonly initPromise: Promise<void>;
+    constructor(config: B2BClientConfig);
+    get isAvailable(): boolean;
+    private init;
+    /**
+     * Execute a request with retry logic (up to 5 attempts with exponential backoff)
+     */
+    private request;
+    private getB2BStorefrontToken;
+    private getB2BCompanyId;
+    getCompanyAddresses(): Promise<CustomerAddress[]>;
+    createCartRedirectUrls(cartId: string): Promise<{
+        redirectedCheckoutUrl: string;
+    }>;
+}
+
+export declare interface B2BClientConfig {
+    channelId: number;
+    /** Optional B2B JWT fetcher. Receives channelId and returns a B2B storefront token. If not provided, B2B features are disabled. */
+    getB2BJwt?: (channelId: number) => Promise<string | null>;
+}
+
+declare class BigCommerceClient {
+    private endpoint;
+    private storefrontToken;
+    private graphQLClient;
+    private isProcessing;
+    private requestQueue;
+    readonly channelId: number;
+    constructor(config: BigCommerceConfig);
+    /**
+     * Execute a request with retry logic (up to 5 attempts with exponential backoff)
+     */
+    private executeWithRetry;
+    /**
+     * Process the next request in the queue
+     */
+    private processNextInQueue;
+    request<const R, V extends Variables | undefined>(options: TadaRequestOptions<R, V>): Promise<R>;
+    /**
+     * Get an existing cart by ID
+     */
+    getCart(cartEntityId?: string): Promise<{
+        id: string;
+        entityId: string;
+        lineItems: {
+            physicalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+            digitalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+        };
+        amount: {
+            value: number;
+            currencyCode: string;
+        };
+        baseAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        discountedAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        createdAt: {
+            utc: string;
+        };
+        updatedAt: {
+            utc: string;
+        };
+    } | null>;
+    /**
+     * Create a new cart with line items
+     * Batches items if more than CART_BATCH_SIZE
+     */
+    createCart(lineItems: CartLineItemInput[]): Promise<{
+        id: string;
+        entityId: string;
+        lineItems: {
+            physicalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+            digitalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+        };
+        amount: {
+            value: number;
+            currencyCode: string;
+        };
+        baseAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        discountedAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        createdAt: {
+            utc: string;
+        };
+        updatedAt: {
+            utc: string;
+        };
+    }>;
+    /**
+     * Add a single batch of line items to a cart
+     * Returns the updated cart or null if the operation failed
+     */
+    private addBatchToCart;
+    /**
+     * Add line items to an existing cart
+     * Batches items if more than CART_BATCH_SIZE
+     */
+    addCartLineItems(cartEntityId: string, lineItems: CartLineItemInput[]): Promise<{
+        id: string;
+        entityId: string;
+        lineItems: {
+            physicalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+            digitalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+        };
+        amount: {
+            value: number;
+            currencyCode: string;
+        };
+        baseAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        discountedAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        createdAt: {
+            utc: string;
+        };
+        updatedAt: {
+            utc: string;
+        };
+    } | null>;
+    /**
+     * Update the quantity of a cart line item
+     */
+    updateCartLineItem(cartEntityId: string, lineItemEntityId: string, quantity: number, productEntityId: number, variantEntityId?: number): Promise<{
+        id: string;
+        entityId: string;
+        lineItems: {
+            physicalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+            digitalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+        };
+        amount: {
+            value: number;
+            currencyCode: string;
+        };
+        baseAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        discountedAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        createdAt: {
+            utc: string;
+        };
+        updatedAt: {
+            utc: string;
+        };
+    } | null>;
+    /**
+     * Remove a line item from the cart
+     */
+    deleteCartLineItem(cartEntityId: string, lineItemEntityId: string): Promise<{
+        id: string;
+        entityId: string;
+        lineItems: {
+            physicalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+            digitalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+        };
+        amount: {
+            value: number;
+            currencyCode: string;
+        };
+        baseAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        discountedAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        createdAt: {
+            utc: string;
+        };
+        updatedAt: {
+            utc: string;
+        };
+    } | null>;
+    /**
+     * Delete an entire cart
+     */
+    deleteCart(cartEntityId: string): Promise<string | null>;
+    /**
+     * Create a cart or add to existing cart
+     * Convenience method that handles both cases
+     */
+    addToCart(lineItems: CartLineItemInput[], existingCartId?: string): Promise<{
+        id: string;
+        entityId: string;
+        lineItems: {
+            physicalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+            digitalItems: {
+                entityId: string;
+                productEntityId: number;
+                variantEntityId: number | null;
+                quantity: number;
+                name: string;
+                sku: string | null;
+                originalPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                listPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedListPrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                extendedSalePrice: {
+                    value: number;
+                    currencyCode: string;
+                };
+                imageUrl: string | null;
+            }[];
+        };
+        amount: {
+            value: number;
+            currencyCode: string;
+        };
+        baseAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        discountedAmount: {
+            value: number;
+            currencyCode: string;
+        };
+        createdAt: {
+            utc: string;
+        };
+        updatedAt: {
+            utc: string;
+        };
+    } | null>;
+    /**
+     * Create single-use redirect URLs for a cart
+     * URLs should be generated just-in-time (within 30s of use)
+     */
+    createCartRedirectUrls(cartEntityId: string): Promise<CartRedirectUrls | null>;
+    /**
+     * Create a metafield on a cart
+     */
+    createCartMetafield(cartEntityId: string, key: string, value: string): Promise<void>;
+    /**
+     * Get checkout by entity ID
+     * Checkouts are automatically created when a cart is created
+     */
+    getCheckout(checkoutEntityId?: string): Promise<{
+        entityId: string;
+        subtotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        taxTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        grandTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        shippingCostTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        handlingCostTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        billingAddress: {
+            firstName: string | null;
+            lastName: string | null;
+            address1: string | null;
+            address2: string | null;
+            city: string | null;
+            stateOrProvince: string | null;
+            stateOrProvinceCode: string | null;
+            countryCode: string;
+            postalCode: string | null;
+            phone: string | null;
+            email: string | null;
+        } | null;
+        shippingConsignments: {
+            entityId: string;
+            address: {
+                firstName: string | null;
+                lastName: string | null;
+                address1: string | null;
+                address2: string | null;
+                city: string | null;
+                stateOrProvince: string | null;
+                stateOrProvinceCode: string | null;
+                countryCode: string;
+                postalCode: string | null;
+                phone: string | null;
+                email: string | null;
+            };
+            availableShippingOptions: {
+                entityId: string;
+                description: string;
+                type: string;
+                cost: {
+                    value: number;
+                    currencyCode: string;
+                };
+            }[] | null;
+            selectedShippingOption: {
+                entityId: string;
+                description: string;
+                type: string;
+                cost: {
+                    value: number;
+                    currencyCode: string;
+                };
+            } | null;
+            shippingCost: {
+                value: number;
+                currencyCode: string;
+            } | null;
+            lineItemIds: string[];
+        }[] | null;
+    } | null>;
+    /**
+     * Add shipping consignments (addresses) to a checkout
+     * This is required for tax calculation
+     */
+    setCheckoutShippingAddress(checkoutEntityId: string, address: CheckoutAddress, lineItems: CheckoutConsignmentLineItem[]): Promise<{
+        entityId: string;
+        subtotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        taxTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        grandTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        shippingCostTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        handlingCostTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        billingAddress: {
+            firstName: string | null;
+            lastName: string | null;
+            address1: string | null;
+            address2: string | null;
+            city: string | null;
+            stateOrProvince: string | null;
+            stateOrProvinceCode: string | null;
+            countryCode: string;
+            postalCode: string | null;
+            phone: string | null;
+            email: string | null;
+        } | null;
+        shippingConsignments: {
+            entityId: string;
+            address: {
+                firstName: string | null;
+                lastName: string | null;
+                address1: string | null;
+                address2: string | null;
+                city: string | null;
+                stateOrProvince: string | null;
+                stateOrProvinceCode: string | null;
+                countryCode: string;
+                postalCode: string | null;
+                phone: string | null;
+                email: string | null;
+            };
+            availableShippingOptions: {
+                entityId: string;
+                description: string;
+                type: string;
+                cost: {
+                    value: number;
+                    currencyCode: string;
+                };
+            }[] | null;
+            selectedShippingOption: {
+                entityId: string;
+                description: string;
+                type: string;
+                cost: {
+                    value: number;
+                    currencyCode: string;
+                };
+            } | null;
+            shippingCost: {
+                value: number;
+                currencyCode: string;
+            } | null;
+            lineItemIds: string[];
+        }[] | null;
+    } | null>;
+    /**
+     * Add shipping consignments (addresses) to a checkout
+     * This is required for tax calculation
+     */
+    setCheckoutBillingAddress(checkoutEntityId: string, address: CheckoutAddress): Promise<{
+        entityId: string;
+        subtotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        taxTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        grandTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        shippingCostTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        handlingCostTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        billingAddress: {
+            firstName: string | null;
+            lastName: string | null;
+            address1: string | null;
+            address2: string | null;
+            city: string | null;
+            stateOrProvince: string | null;
+            stateOrProvinceCode: string | null;
+            countryCode: string;
+            postalCode: string | null;
+            phone: string | null;
+            email: string | null;
+        } | null;
+        shippingConsignments: {
+            entityId: string;
+            address: {
+                firstName: string | null;
+                lastName: string | null;
+                address1: string | null;
+                address2: string | null;
+                city: string | null;
+                stateOrProvince: string | null;
+                stateOrProvinceCode: string | null;
+                countryCode: string;
+                postalCode: string | null;
+                phone: string | null;
+                email: string | null;
+            };
+            availableShippingOptions: {
+                entityId: string;
+                description: string;
+                type: string;
+                cost: {
+                    value: number;
+                    currencyCode: string;
+                };
+            }[] | null;
+            selectedShippingOption: {
+                entityId: string;
+                description: string;
+                type: string;
+                cost: {
+                    value: number;
+                    currencyCode: string;
+                };
+            } | null;
+            shippingCost: {
+                value: number;
+                currencyCode: string;
+            } | null;
+            lineItemIds: string[];
+        }[] | null;
+    } | null>;
+    /**
+     * Get customer's saved addresses and customer info
+     * Requires the customer to be logged in
+     * Automatically paginates through all addresses
+     */
+    getCustomerAddresses(): Promise<{
+        customerInfo: CustomerInfo | null;
+        addresses: CustomerAddress[];
+    }>;
+    /**
+     * Update checkout customer message (order notes)
+     * This message will be included with the order
+     */
+    updateCheckoutCustomerMessage(checkoutEntityId: string, options: {
+        purchaseOrderNumber: string | null;
+        threadId: string | null;
+    }): Promise<{
+        entityId: string;
+        subtotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        taxTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        grandTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        shippingCostTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        handlingCostTotal: {
+            value: number;
+            currencyCode: string;
+        } | null;
+        billingAddress: {
+            firstName: string | null;
+            lastName: string | null;
+            address1: string | null;
+            address2: string | null;
+            city: string | null;
+            stateOrProvince: string | null;
+            stateOrProvinceCode: string | null;
+            countryCode: string;
+            postalCode: string | null;
+            phone: string | null;
+            email: string | null;
+        } | null;
+        shippingConsignments: {
+            entityId: string;
+            address: {
+                firstName: string | null;
+                lastName: string | null;
+                address1: string | null;
+                address2: string | null;
+                city: string | null;
+                stateOrProvince: string | null;
+                stateOrProvinceCode: string | null;
+                countryCode: string;
+                postalCode: string | null;
+                phone: string | null;
+                email: string | null;
+            };
+            availableShippingOptions: {
+                entityId: string;
+                description: string;
+                type: string;
+                cost: {
+                    value: number;
+                    currencyCode: string;
+                };
+            }[] | null;
+            selectedShippingOption: {
+                entityId: string;
+                description: string;
+                type: string;
+                cost: {
+                    value: number;
+                    currencyCode: string;
+                };
+            } | null;
+            shippingCost: {
+                value: number;
+                currencyCode: string;
+            } | null;
+            lineItemIds: string[];
+        }[] | null;
+    } | null>;
+    /**
+     * Get product variant details for multiple products
+     * Returns product options and all variants with their option values
+     * Automatically paginates through all variants, options, and option values
+     */
+    getProductVariantDetails(productEntityIds: number[]): Promise<ProductVariantDetails[]>;
+    /**
+     * Get product paths for building product page URLs
+     * Returns a map of productEntityId to path
+     */
+    getProductPaths(productEntityIds: number[]): Promise<Map<number, string>>;
+    /**
+     * Get products for display (used by showProducts tool)
+     * Returns product names, images, prices, and variant information
+     */
+    getProductsForDisplay(productEntityIds: number[]): Promise<ProductForDisplay[]>;
+}
+
+export declare interface BigCommerceConfig {
+    endpoint: string;
+    /** Storefront API token. Optional when using a proxy that handles authentication server-side. */
+    storefrontToken?: string;
+    channelId?: number;
+}
+
+export declare interface BigCommerceConfigProps {
+    /** GraphQL endpoint URL (absolute or relative for proxy) */
+    endpoint: string;
+    /** Storefront API token. Optional when using a proxy that handles authentication server-side. */
+    storefrontToken?: string;
+    /** BigCommerce channel ID */
+    channelId: number;
+    /** B2B JWT fetcher. Receives channelId and returns a B2B storefront token. For Stencil, use `stencilB2BJwt`. */
+    getB2BJwt?: (channelId: number) => Promise<string | null>;
+}
+
+export declare interface BigCommerceIntegration {
+    client: BigCommerceClient | MockBigCommerceClient;
+    onViewProduct?: (product: {
+        productEntityId?: number;
+        sku: string;
+        name: string;
+        path?: string;
+    }) => void;
+    /** Called when checkout is initiated. If not provided, defaults to window.location.href redirect. */
+    onCheckout?: (checkoutUrl: string) => void | Promise<void>;
+    /** B2B JWT fetcher. Receives channelId and returns a B2B storefront token. For Stencil, use `stencilB2BJwt`. */
+    getB2BJwt?: (channelId: number) => Promise<string | null>;
+}
+
+declare type Cart = ResultOf<typeof CartFragment>;
+
+declare const CartFragment: TadaDocumentNode<    {
+id: string;
+entityId: string;
+lineItems: {
+physicalItems: {
+entityId: string;
+productEntityId: number;
+variantEntityId: number | null;
+quantity: number;
+name: string;
+sku: string | null;
+originalPrice: {
+value: number;
+currencyCode: string;
+};
+listPrice: {
+value: number;
+currencyCode: string;
+};
+extendedListPrice: {
+value: number;
+currencyCode: string;
+};
+extendedSalePrice: {
+value: number;
+currencyCode: string;
+};
+imageUrl: string | null;
+}[];
+digitalItems: {
+entityId: string;
+productEntityId: number;
+variantEntityId: number | null;
+quantity: number;
+name: string;
+sku: string | null;
+originalPrice: {
+value: number;
+currencyCode: string;
+};
+listPrice: {
+value: number;
+currencyCode: string;
+};
+extendedListPrice: {
+value: number;
+currencyCode: string;
+};
+extendedSalePrice: {
+value: number;
+currencyCode: string;
+};
+imageUrl: string | null;
+}[];
+};
+amount: {
+value: number;
+currencyCode: string;
+};
+baseAmount: {
+value: number;
+currencyCode: string;
+};
+discountedAmount: {
+value: number;
+currencyCode: string;
+};
+createdAt: {
+utc: string;
+};
+updatedAt: {
+utc: string;
+};
+}, {}, {
+fragment: "CartFields";
+on: "Cart";
+masked: true;
+}>;
+
+export declare interface CartItem extends Product {
+    quantity: number;
+    status: 'matched' | 'price-mismatch' | 'unavailable' | 'pending';
+    poPriceValue?: number;
+    poPriceCurrencyCode?: string;
+    catalogPriceCurrencyCode?: string;
+    bcLineItemEntityId?: string;
+}
+
+declare interface CartLineItemInput {
+    productEntityId: number;
+    variantEntityId?: number;
+    quantity: number;
+}
+
+declare interface CartRedirectUrls {
+    redirectedCheckoutUrl: string;
+}
+
+declare type Checkout = ResultOf<typeof CheckoutFragment>;
+
+declare interface CheckoutAddress {
+    firstName?: string;
+    lastName?: string;
+    company?: string;
+    address1?: string;
+    address2?: string;
+    city?: string;
+    stateOrProvince?: string;
+    stateOrProvinceCode?: string;
+    countryCode: string;
+    postalCode?: string;
+    phone?: string;
+    email?: string;
+    shouldSaveAddress: boolean;
+}
+
+declare interface CheckoutConsignmentLineItem {
+    lineItemEntityId: string;
+    quantity: number;
+}
+
+declare const CheckoutFragment: TadaDocumentNode<    {
+entityId: string;
+subtotal: {
+value: number;
+currencyCode: string;
+} | null;
+taxTotal: {
+value: number;
+currencyCode: string;
+} | null;
+grandTotal: {
+value: number;
+currencyCode: string;
+} | null;
+shippingCostTotal: {
+value: number;
+currencyCode: string;
+} | null;
+handlingCostTotal: {
+value: number;
+currencyCode: string;
+} | null;
+billingAddress: {
+firstName: string | null;
+lastName: string | null;
+address1: string | null;
+address2: string | null;
+city: string | null;
+stateOrProvince: string | null;
+stateOrProvinceCode: string | null;
+countryCode: string;
+postalCode: string | null;
+phone: string | null;
+email: string | null;
+} | null;
+shippingConsignments: {
+entityId: string;
+address: {
+firstName: string | null;
+lastName: string | null;
+address1: string | null;
+address2: string | null;
+city: string | null;
+stateOrProvince: string | null;
+stateOrProvinceCode: string | null;
+countryCode: string;
+postalCode: string | null;
+phone: string | null;
+email: string | null;
+};
+availableShippingOptions: {
+entityId: string;
+description: string;
+type: string;
+cost: {
+value: number;
+currencyCode: string;
+};
+}[] | null;
+selectedShippingOption: {
+entityId: string;
+description: string;
+type: string;
+cost: {
+value: number;
+currencyCode: string;
+};
+} | null;
+shippingCost: {
+value: number;
+currencyCode: string;
+} | null;
+lineItemIds: string[];
+}[] | null;
+}, {}, {
+fragment: "CheckoutFields";
+on: "Checkout";
+masked: true;
+}>;
+
+/**
+ * Create a B2B client with the given configuration.
+ */
+export declare function createB2BClient(config: B2BClientConfig): B2BClient;
+
+/**
+ * Create a BigCommerce client instance
+ */
+export declare function createBigCommerceClient(config: BigCommerceConfig): BigCommerceClient;
+
+/**
+ * Construct the BigCommerce GraphQL Storefront API endpoint from a store hash.
+ * Use this when you have a store hash (e.g., from Catalyst's BIGCOMMERCE_STORE_HASH).
+ *
+ * @example
+ * const endpoint = createBigCommerceEndpoint('abc123');
+ * // Returns: 'https://store-abc123.mybigcommerce.com/graphql'
+ */
+export declare function createBigCommerceEndpoint(storeHash: string): string;
+
+/**
+ * Create a mock BigCommerce client instance
+ */
+export declare function createMockBigCommerceClient(config?: BigCommerceConfig): MockBigCommerceClient;
+
+declare interface CustomerAddress {
+    source: 'storefront' | 'b2b' | 'po';
+    id: string;
+    firstName: string;
+    lastName: string;
+    address1: string;
+    address2?: string;
+    city: string;
+    stateOrProvince?: string;
+    postalCode?: string;
+    countryCode: string;
+    country?: string;
+    phone?: string;
+    isShipping: boolean;
+    isBilling: boolean;
+    isDefaultShipping: boolean;
+    isDefaultBilling: boolean;
+    label?: string;
+}
+
+declare interface CustomerInfo {
+    entityId: number;
+    firstName: string;
+    lastName: string;
+    email: string;
+}
+
+export declare class MockBigCommerceClient {
+    private carts;
+    private checkouts;
+    private checkoutToCartId;
+    private nextCartId;
+    private nextCheckoutId;
+    private nextLineItemId;
+    private nextConsignmentId;
+    private nextShippingOptionId;
+    readonly channelId = 1;
+    constructor(_config?: BigCommerceConfig);
+    /**
+     * Helper: Create a Money object
+     */
+    private createMoney;
+    /**
+     * Helper: Generate cart entity ID
+     */
+    private generateCartId;
+    /**
+     * Helper: Generate checkout entity ID
+     */
+    private generateCheckoutId;
+    /**
+     * Helper: Generate line item entity ID
+     */
+    private generateLineItemId;
+    /**
+     * Helper: Generate consignment entity ID
+     */
+    private generateConsignmentId;
+    /**
+     * Helper: Generate shipping option entity ID
+     */
+    private generateShippingOptionId;
+    /**
+     * Helper: Create a cart line item from input
+     */
+    private createCartLineItem;
+    /**
+     * Helper: Calculate cart totals
+     */
+    private calculateCartTotals;
+    /**
+     * Helper: Calculate checkout totals
+     */
+    private calculateCheckoutTotals;
+    /**
+     * Get an existing cart by ID
+     */
+    getCart(cartEntityId?: string): Promise<Cart | null>;
+    /**
+     * Create a new cart with line items
+     */
+    createCart(lineItems: CartLineItemInput[]): Promise<Cart | null>;
+    /**
+     * Add line items to an existing cart
+     */
+    addCartLineItems(cartEntityId: string, lineItems: CartLineItemInput[]): Promise<Cart | null>;
+    /**
+     * Update the quantity of a cart line item
+     */
+    updateCartLineItem(cartEntityId: string, lineItemEntityId: string, quantity: number, _productEntityId: number, _variantEntityId?: number): Promise<Cart | null>;
+    /**
+     * Remove a line item from the cart
+     */
+    deleteCartLineItem(cartEntityId: string, lineItemEntityId: string): Promise<Cart | null>;
+    /**
+     * Delete an entire cart
+     */
+    deleteCart(cartEntityId: string): Promise<string | null>;
+    /**
+     * Create a cart or add to existing cart
+     * Convenience method that handles both cases
+     */
+    addToCart(lineItems: CartLineItemInput[], existingCartId?: string): Promise<Cart | null>;
+    /**
+     * Create single-use redirect URLs for a cart
+     */
+    createCartRedirectUrls(cartEntityId: string): Promise<CartRedirectUrls | null>;
+    /**
+     * Get checkout by entity ID
+     */
+    getCheckout(checkoutEntityId?: string): Promise<Checkout | null>;
+    /**
+     * Add shipping consignments (addresses) to a checkout
+     */
+    setCheckoutShippingAddress(checkoutEntityId: string, address: CheckoutAddress, lineItems: CheckoutConsignmentLineItem[]): Promise<Checkout | null>;
+    /**
+     * Add billing address to a checkout
+     */
+    setCheckoutBillingAddress(checkoutEntityId: string, address: CheckoutAddress): Promise<Checkout | null>;
+    /**
+     * Get customer's saved addresses and customer info
+     * Always returns empty for mock (simulates logged-out state)
+     */
+    getCustomerAddresses(): Promise<{
+        customerInfo: CustomerInfo | null;
+        addresses: CustomerAddress[];
+    }>;
+    /**
+     * Update checkout customer message (order notes)
+     */
+    updateCheckoutCustomerMessage(checkoutEntityId: string, _message: any): Promise<Checkout | null>;
+    /**
+     * Create a metafield on a cart (no-op in mock)
+     */
+    createCartMetafield(_cartEntityId: string, _key: string, _value: string): Promise<void>;
+    /**
+     * Low-level request method (not implemented in mock)
+     */
+    request<T = unknown>(_options: unknown): Promise<T>;
+    /**
+     * Get product paths for building product page URLs
+     * Returns a map of productEntityId to path
+     */
+    getProductPaths(productEntityIds: number[]): Promise<Map<number, string>>;
+    /**
+     * Get products for display (used by showProducts tool)
+     * Returns mock product names, images, prices, and variant information
+     */
+    getProductsForDisplay(productEntityIds: number[]): Promise<ProductForDisplay[]>;
+    /**
+     * Get product variant details for multiple products
+     * Returns mock product options and variants
+     */
+    getProductVariantDetails(productEntityIds: number[]): Promise<ProductVariantDetails[]>;
+    /**
+     * Reset all state (useful for testing)
+     */
+    reset(): void;
+}
+
+export declare interface Product {
+    id: string;
+    sku: string;
+    name: string;
+    path?: string;
+    price?: number;
+    imageUrl?: string;
+    availableQuantity?: number;
+    isInStock?: boolean;
+    productEntityId?: number;
+    variantEntityId?: number;
+    defaultImage?: {
+        urlTemplate?: string;
+    };
+}
+
+declare interface ProductForDisplay {
+    entityId: number;
+    name: string;
+    sku: string;
+    path?: string;
+    defaultImage?: {
+        urlTemplate: string;
+    };
+    variants: Array<{
+        entityId: number;
+        sku: string;
+        isPurchasable: boolean;
+        defaultImage?: {
+            urlTemplate: string;
+        };
+        prices?: {
+            price?: {
+                value: number;
+                currencyCode: string;
+            };
+        };
+        inventory?: {
+            isInStock: boolean;
+            aggregated?: {
+                availableToSell: number;
+                warningLevel: number;
+            };
+        };
+    }>;
+}
+
+declare interface ProductOption {
+    entityId: number;
+    displayName: string;
+    isRequired: boolean;
+    isVariantOption: boolean;
+    displayStyle?: string;
+    values: ProductOptionValue[];
+}
+
+declare interface ProductOptionValue {
+    entityId: number;
+    label: string;
+    isDefault: boolean;
+}
+
+declare interface ProductVariant {
+    entityId: number;
+    sku: string;
+    isPurchasable: boolean;
+    defaultImage?: {
+        urlTemplate: string;
+    };
+    prices?: {
+        price?: {
+            value: number;
+            currencyCode: string;
+        };
+    };
+    inventory?: {
+        isInStock?: boolean;
+        aggregated?: {
+            availableToSell: number;
+            warningLevel: number;
+        };
+    };
+    options: VariantOption[];
+}
+
+declare interface ProductVariantDetails {
+    entityId: number;
+    productOptions: ProductOption[];
+    variants: ProductVariant[];
+}
+
+export declare function PurchaseOrderChat(props: PurchaseOrderChatProps): JSX.Element;
+
+export declare interface PurchaseOrderChatProps {
+    className?: string;
+    /** TakeShape agent name. Defaults to 'bigcommercePurchaseOrderAgent'. */
+    agentName?: string;
+    /** TakeShape input name. Defaults to 'bigcommercePurchaseOrderAgent'. */
+    inputName?: string;
+    bigcommerce: BigCommerceIntegration;
+    /** When true, launches ChatView in a fullscreen modal on transition to ready state */
+    expandOnReady?: boolean;
+}
+
+/**
+ * Simplified PurchaseOrderChatWidget component that handles all configuration internally.
+ * This is the recommended way to integrate the component in most applications.
+ *
+ * For advanced use cases requiring custom provider setup, use PurchaseOrderChat
+ * with TakeShapeConfigProvider directly.
+ */
+export declare function PurchaseOrderChatWidget({ takeshape, bigcommerce, agentName, inputName, onViewProduct, onCheckout, className, expandOnReady }: PurchaseOrderChatWidgetProps): JSX.Element;
+
+export declare interface PurchaseOrderChatWidgetProps {
+    /** TakeShape API configuration */
+    takeshape: TakeShapeConfigProps;
+    /** BigCommerce storefront configuration */
+    bigcommerce: BigCommerceConfigProps;
+    /** TakeShape agent name. Defaults to 'bigcommercePurchaseOrderAgent'. */
+    agentName?: string;
+    /** TakeShape input name. Defaults to 'bigcommercePurchaseOrderAgent'. */
+    inputName?: string;
+    /** Called when user clicks to view a product */
+    onViewProduct?: (product: {
+        productEntityId?: number;
+        sku: string;
+        name: string;
+        path?: string;
+    }) => void;
+    /** Called when checkout is initiated. If not provided, defaults to window.location.href redirect. */
+    onCheckout?: (checkoutUrl: string) => void | Promise<void>;
+    /** CSS class for the container */
+    className?: string;
+    /** When true, launches ChatView in a fullscreen modal on transition to ready state */
+    expandOnReady?: boolean;
+}
+
+/**
+ * B2B JWT fetcher for Stencil storefronts.
+ * Fetches the customer JWT from /customer/current.jwt and exchanges it for a B2B storefront token.
+ *
+ * @param channelId - BigCommerce channel ID (passed by the B2BClient)
+ * @returns B2B storefront token, or null if not available
+ *
+ * @example
+ * ```tsx
+ * import { stencilB2BJwt } from '@takeshape/purchase-order-chat';
+ *
+ * <PurchaseOrderChat
+ *   bigCommerce={{
+ *     endpoint: '/graphql',
+ *     channelId: 1,
+ *     getB2BJwt: stencilB2BJwt
+ *   }}
+ *   // ...
+ * />
+ * ```
+ */
+export declare function stencilB2BJwt(channelId: number): Promise<string | null>;
+
+declare type TadaRequestOptions<R, V> = RequestOptions & {
+    document: TadaDocumentNode<R, V>;
+    variables?: V;
+};
+
+export declare type TakeShapeConfig = {
+    projectId: string;
+    apiKey: string;
+    origin: string;
+    sseOrigin: string;
+};
+
+export declare interface TakeShapeConfigProps {
+    projectId: string;
+    apiKey: string;
+    origin?: string;
+    sseOrigin?: string;
+}
+
+export declare function TakeShapeConfigProvider({ projectId, apiKey, origin, sseOrigin, children }: TakeShapeConfigProviderProps): JSX.Element;
+
+declare type TakeShapeConfigProviderProps = {
+    projectId: string;
+    apiKey: string;
+    origin?: string;
+    sseOrigin?: string;
+    children: ReactNode;
+};
+
+declare interface VariantOption {
+    entityId: number;
+    displayName: string;
+    values: VariantOptionValue[];
+}
+
+declare interface VariantOptionValue {
+    entityId: number;
+    label: string;
+}
+
+export { }