@btst/stack 5.1.0 → 5.2.0

package/dist/plugins/ecommerce/api/index.d.mts

@@ -0,0 +1,70 @@
+import { g as PaymentAdapter, D as DiscountCode, I as InventoryRecord, h as OrderRecord, b as Product, i as ProductsFilters, P as ProductsPage, j as OrderLineItem, f as CartItem, d as Order } from '../../../shared/stack.DLQEXunY.mjs';
+export { k as CartLineInput, C as CheckoutInput, e as CheckoutResult, l as DiscountResult, m as ECOMMERCE_QUERY_KEYS, a as EcommerceApiRouter, n as EcommerceBackendConfig, o as EcommerceBackendHooks, E as EcommerceEndpointPartition, p as EcommerceRouteKey, O as OrderStatus, c as OrdersPage, q as PRODUCT_CONTENT_TYPE, r as PRODUCT_TYPE_SLUG, s as PaymentWebhookResult, t as ProductListParams, u as ProductListResult, v as ProductVariant, S as SerializedOrder, w as SerializedProduct, x as ShippingAddress, y as checkoutSchema, z as ecommerceBackendPlugin, A as ecommerceEndpointDiscriminator, B as productSchema, F as productVariantSchema, G as productsListDiscriminator, H as shippingAddressSchema, J as updateInventorySchema } from '../../../shared/stack.DLQEXunY.mjs';
+import * as _btst_db from '@btst/db';
+import { DBAdapter } from '@btst/db';
+export { ecommercePermissions } from '../permissions.mjs';
+import { i as SerializedContentItem } from '../../../shared/stack.DrB3L7Ih.mjs';
+import '@btst/stack/plugins/api';
+import '../../../authorization/index.mjs';
+import 'zod';
+import 'better-call';
+import '@tanstack/react-query';
+import '@btst/stack/plugins/cms/api';
+import '@btst/stack/authorization';
+
+/** Optional hosted Checkout destinations; without these, Stripe returns a PaymentIntent client secret. */
+interface StripeAdapterOptions {
+    /** Absolute success URL. Include your storefront confirmation route; its token remains in sessionStorage. */
+    successUrl?: string;
+    /** Absolute URL used when the buyer cancels hosted Checkout. */
+    cancelUrl?: string;
+}
+/** Stripe REST integration with signed raw-body webhooks and provider-side checkout idempotency. */
+declare function stripeAdapter(secretKey: string, webhookSecret: string, options?: StripeAdapterOptions): PaymentAdapter;
+
+/** Lemon Squeezy requires a generic one-time-payment variant in the store currency. */
+interface LemonSqueezyAdapterOptions {
+    /** Store that owns the generic checkout variant. */
+    storeId: string;
+    /** Generic single-payment variant. Disable buyer quantity changes and use tax-inclusive pricing. */
+    variantId: string;
+    /** Redirect after payment; `{orderId}` is replaced with the local order ID. */
+    redirectUrl?: string;
+    /** Match the provider's test mode. @default false */
+    testMode?: boolean;
+}
+/** Signed Lemon Squeezy checkout integration. The provider amount must equal the store's reserved total. */
+declare function lemonSqueezyAdapter(apiKey: string, webhookSecret: string, options: LemonSqueezyAdapterOptions): PaymentAdapter;
+
+/** Products remain CMS items; only commerce-specific records live here. */
+declare const ecommerceSchema: _btst_db.DbPlugin;
+
+/** Read-only product projection; malformed and unpublished CMS items stay private. */
+declare function listProducts(adapter: DBAdapter, filters?: ProductsFilters, mediaAvailable?: boolean): Promise<ProductsPage>;
+declare function getProduct(adapter: DBAdapter, slug: string, mediaAvailable?: boolean): Promise<Product | null>;
+declare function getOrder(adapter: DBAdapter, id: string): Promise<OrderRecord | null>;
+declare function listOrders(adapter: DBAdapter, options?: {
+    customerId?: string;
+    status?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    items: OrderRecord[];
+    total: number;
+}>;
+declare function getDiscountCode(adapter: DBAdapter, code: string): Promise<DiscountCode | null>;
+/** Read the authoritative product/variant count without initializing or changing inventory. */
+declare function getInventory(adapter: Pick<DBAdapter, "findOne">, productId: string, variantId?: string): Promise<InventoryRecord | null>;
+
+/** Lower-level CMS write; caller owns validation and authorization. */
+declare function createProduct(adapter: DBAdapter, slug: string, data: Record<string, unknown>): Promise<SerializedContentItem>;
+/** Atomically reserve initialized commerce inventory within the caller's isolated transaction. */
+declare function reserveInventory(adapter: Pick<DBAdapter, "findOne" | "update">, items: readonly Readonly<CartItem>[], currency: string, mediaAvailable?: boolean): Promise<OrderLineItem[]>;
+/** Release the exact reservation once; caller owns the order state transition and transaction. */
+declare function releaseInventory(adapter: Pick<DBAdapter, "findOne" | "update">, lines: OrderLineItem[]): Promise<void>;
+
+/** Project the safe HTTP representation without guest tokens or checkout credentials. */
+declare function serializeOrder(record: OrderRecord): Order;
+
+export { CartItem, DiscountCode, InventoryRecord, Order, OrderLineItem, OrderRecord, PaymentAdapter, Product, ProductsFilters, ProductsPage, createProduct, ecommerceSchema, getDiscountCode, getInventory, getOrder, getProduct, lemonSqueezyAdapter, listOrders, listProducts, releaseInventory, reserveInventory, serializeOrder, stripeAdapter };
+export type { LemonSqueezyAdapterOptions, StripeAdapterOptions };

package/dist/plugins/ecommerce/api/index.d.ts

@@ -0,0 +1,70 @@
+import { g as PaymentAdapter, D as DiscountCode, I as InventoryRecord, h as OrderRecord, b as Product, i as ProductsFilters, P as ProductsPage, j as OrderLineItem, f as CartItem, d as Order } from '../../../shared/stack.CsfAD5NP.js';
+export { k as CartLineInput, C as CheckoutInput, e as CheckoutResult, l as DiscountResult, m as ECOMMERCE_QUERY_KEYS, a as EcommerceApiRouter, n as EcommerceBackendConfig, o as EcommerceBackendHooks, E as EcommerceEndpointPartition, p as EcommerceRouteKey, O as OrderStatus, c as OrdersPage, q as PRODUCT_CONTENT_TYPE, r as PRODUCT_TYPE_SLUG, s as PaymentWebhookResult, t as ProductListParams, u as ProductListResult, v as ProductVariant, S as SerializedOrder, w as SerializedProduct, x as ShippingAddress, y as checkoutSchema, z as ecommerceBackendPlugin, A as ecommerceEndpointDiscriminator, B as productSchema, F as productVariantSchema, G as productsListDiscriminator, H as shippingAddressSchema, J as updateInventorySchema } from '../../../shared/stack.CsfAD5NP.js';
+import * as _btst_db from '@btst/db';
+import { DBAdapter } from '@btst/db';
+export { ecommercePermissions } from '../permissions.js';
+import { i as SerializedContentItem } from '../../../shared/stack.DrB3L7Ih.js';
+import '@btst/stack/plugins/api';
+import '../../../authorization/index.js';
+import 'zod';
+import 'better-call';
+import '@tanstack/react-query';
+import '@btst/stack/plugins/cms/api';
+import '@btst/stack/authorization';
+
+/** Optional hosted Checkout destinations; without these, Stripe returns a PaymentIntent client secret. */
+interface StripeAdapterOptions {
+    /** Absolute success URL. Include your storefront confirmation route; its token remains in sessionStorage. */
+    successUrl?: string;
+    /** Absolute URL used when the buyer cancels hosted Checkout. */
+    cancelUrl?: string;
+}
+/** Stripe REST integration with signed raw-body webhooks and provider-side checkout idempotency. */
+declare function stripeAdapter(secretKey: string, webhookSecret: string, options?: StripeAdapterOptions): PaymentAdapter;
+
+/** Lemon Squeezy requires a generic one-time-payment variant in the store currency. */
+interface LemonSqueezyAdapterOptions {
+    /** Store that owns the generic checkout variant. */
+    storeId: string;
+    /** Generic single-payment variant. Disable buyer quantity changes and use tax-inclusive pricing. */
+    variantId: string;
+    /** Redirect after payment; `{orderId}` is replaced with the local order ID. */
+    redirectUrl?: string;
+    /** Match the provider's test mode. @default false */
+    testMode?: boolean;
+}
+/** Signed Lemon Squeezy checkout integration. The provider amount must equal the store's reserved total. */
+declare function lemonSqueezyAdapter(apiKey: string, webhookSecret: string, options: LemonSqueezyAdapterOptions): PaymentAdapter;
+
+/** Products remain CMS items; only commerce-specific records live here. */
+declare const ecommerceSchema: _btst_db.DbPlugin;
+
+/** Read-only product projection; malformed and unpublished CMS items stay private. */
+declare function listProducts(adapter: DBAdapter, filters?: ProductsFilters, mediaAvailable?: boolean): Promise<ProductsPage>;
+declare function getProduct(adapter: DBAdapter, slug: string, mediaAvailable?: boolean): Promise<Product | null>;
+declare function getOrder(adapter: DBAdapter, id: string): Promise<OrderRecord | null>;
+declare function listOrders(adapter: DBAdapter, options?: {
+    customerId?: string;
+    status?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    items: OrderRecord[];
+    total: number;
+}>;
+declare function getDiscountCode(adapter: DBAdapter, code: string): Promise<DiscountCode | null>;
+/** Read the authoritative product/variant count without initializing or changing inventory. */
+declare function getInventory(adapter: Pick<DBAdapter, "findOne">, productId: string, variantId?: string): Promise<InventoryRecord | null>;
+
+/** Lower-level CMS write; caller owns validation and authorization. */
+declare function createProduct(adapter: DBAdapter, slug: string, data: Record<string, unknown>): Promise<SerializedContentItem>;
+/** Atomically reserve initialized commerce inventory within the caller's isolated transaction. */
+declare function reserveInventory(adapter: Pick<DBAdapter, "findOne" | "update">, items: readonly Readonly<CartItem>[], currency: string, mediaAvailable?: boolean): Promise<OrderLineItem[]>;
+/** Release the exact reservation once; caller owns the order state transition and transaction. */
+declare function releaseInventory(adapter: Pick<DBAdapter, "findOne" | "update">, lines: OrderLineItem[]): Promise<void>;
+
+/** Project the safe HTTP representation without guest tokens or checkout credentials. */
+declare function serializeOrder(record: OrderRecord): Order;
+
+export { CartItem, DiscountCode, InventoryRecord, Order, OrderLineItem, OrderRecord, PaymentAdapter, Product, ProductsFilters, ProductsPage, createProduct, ecommerceSchema, getDiscountCode, getInventory, getOrder, getProduct, lemonSqueezyAdapter, listOrders, listProducts, releaseInventory, reserveInventory, serializeOrder, stripeAdapter };
+export type { LemonSqueezyAdapterOptions, StripeAdapterOptions };

package/dist/plugins/ecommerce/api/index.mjs

@@ -0,0 +1,10 @@
+export { ecommerceBackendPlugin } from '../../../packages/stack/src/plugins/ecommerce/api/plugin.mjs';
+export { stripeAdapter } from '../../../packages/stack/src/plugins/ecommerce/api/adapters/stripe.mjs';
+export { lemonSqueezyAdapter } from '../../../packages/stack/src/plugins/ecommerce/api/adapters/lemon-squeezy.mjs';
+export { ecommerceSchema } from '../../../packages/stack/src/plugins/ecommerce/db.mjs';
+export { ecommercePermissions } from '../permissions.mjs';
+export { PRODUCT_CONTENT_TYPE, PRODUCT_TYPE_SLUG, checkoutSchema, productSchema, productVariantSchema, shippingAddressSchema, updateInventorySchema } from '../../../packages/stack/src/plugins/ecommerce/schemas.mjs';
+export { ECOMMERCE_QUERY_KEYS, ecommerceEndpointDiscriminator, productsListDiscriminator } from '../../../packages/stack/src/plugins/ecommerce/api/query-key-defs.mjs';
+export { getDiscountCode, getInventory, getOrder, getProduct, listOrders, listProducts } from '../../../packages/stack/src/plugins/ecommerce/api/getters.mjs';
+export { createProduct, releaseInventory, reserveInventory } from '../../../packages/stack/src/plugins/ecommerce/api/mutations.mjs';
+export { serializeOrder } from '../../../packages/stack/src/plugins/ecommerce/api/serializers.mjs';

package/dist/plugins/ecommerce/client/components/index.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+const cartDrawer = require('../../../../packages/stack/src/plugins/ecommerce/client/components/cart-drawer.cjs');
+const productImage = require('../../../../packages/stack/src/plugins/ecommerce/client/components/product-image.cjs');
+const productImagesField = require('../../../../packages/stack/src/plugins/ecommerce/client/components/product-images-field.cjs');
+const routePage = require('../../../../packages/stack/src/plugins/ecommerce/client/components/pages/route-page.cjs');
+
+
+
+exports.CartDrawer = cartDrawer.CartDrawer;
+exports.ProductImage = productImage.ProductImage;
+exports.ProductImagesField = productImagesField.ProductImagesField;
+exports.CartPageComponent = routePage.CartPageComponent;
+exports.CheckoutPageComponent = routePage.CheckoutPageComponent;
+exports.MyOrdersPageComponent = routePage.MyOrdersPageComponent;
+exports.OrderConfirmationPageComponent = routePage.OrderConfirmationPageComponent;
+exports.OrderDetailPageComponent = routePage.OrderDetailPageComponent;
+exports.OrdersAdminPageComponent = routePage.OrdersAdminPageComponent;
+exports.ProductDetailPageComponent = routePage.ProductDetailPageComponent;
+exports.ProductListPageComponent = routePage.ProductListPageComponent;

package/dist/plugins/ecommerce/client/components/index.d.cts

@@ -0,0 +1,19 @@
+import * as react from 'react';
+import { AutoFormInputComponentProps } from '../../../../components/auto-form/index.cjs';
+export { C as CartPageComponent, a as CheckoutPageComponent, M as MyOrdersPageComponent, b as OrderConfirmationPageComponent, c as OrderDetailPageComponent, O as OrdersAdminPageComponent, d as ProductDetailPageComponent, P as ProductListPageComponent } from '../../../../shared/stack.CnlgelQ1.cjs';
+import 'react-hook-form';
+import 'zod';
+
+declare function CartDrawer(): react.JSX.Element;
+
+declare function ProductImage({ image, alt, className, priority, }: {
+    image?: string;
+    alt: string;
+    className?: string;
+    priority?: boolean;
+}): react.JSX.Element;
+
+/** CMS fieldComponents["ecommerce-images"] supports optional Media Library selection and ordering. */
+declare function ProductImagesField({ field, label, isRequired, }: AutoFormInputComponentProps): react.JSX.Element;
+
+export { CartDrawer, ProductImage, ProductImagesField };

package/dist/plugins/ecommerce/client/components/index.d.mts

@@ -0,0 +1,19 @@
+import * as react from 'react';
+import { AutoFormInputComponentProps } from '../../../../components/auto-form/index.mjs';
+export { C as CartPageComponent, a as CheckoutPageComponent, M as MyOrdersPageComponent, b as OrderConfirmationPageComponent, c as OrderDetailPageComponent, O as OrdersAdminPageComponent, d as ProductDetailPageComponent, P as ProductListPageComponent } from '../../../../shared/stack.CnlgelQ1.mjs';
+import 'react-hook-form';
+import 'zod';
+
+declare function CartDrawer(): react.JSX.Element;
+
+declare function ProductImage({ image, alt, className, priority, }: {
+    image?: string;
+    alt: string;
+    className?: string;
+    priority?: boolean;
+}): react.JSX.Element;
+
+/** CMS fieldComponents["ecommerce-images"] supports optional Media Library selection and ordering. */
+declare function ProductImagesField({ field, label, isRequired, }: AutoFormInputComponentProps): react.JSX.Element;
+
+export { CartDrawer, ProductImage, ProductImagesField };

package/dist/plugins/ecommerce/client/components/index.d.ts

@@ -0,0 +1,19 @@
+import * as react from 'react';
+import { AutoFormInputComponentProps } from '../../../../components/auto-form/index.js';
+export { C as CartPageComponent, a as CheckoutPageComponent, M as MyOrdersPageComponent, b as OrderConfirmationPageComponent, c as OrderDetailPageComponent, O as OrdersAdminPageComponent, d as ProductDetailPageComponent, P as ProductListPageComponent } from '../../../../shared/stack.CnlgelQ1.js';
+import 'react-hook-form';
+import 'zod';
+
+declare function CartDrawer(): react.JSX.Element;
+
+declare function ProductImage({ image, alt, className, priority, }: {
+    image?: string;
+    alt: string;
+    className?: string;
+    priority?: boolean;
+}): react.JSX.Element;
+
+/** CMS fieldComponents["ecommerce-images"] supports optional Media Library selection and ordering. */
+declare function ProductImagesField({ field, label, isRequired, }: AutoFormInputComponentProps): react.JSX.Element;
+
+export { CartDrawer, ProductImage, ProductImagesField };

package/dist/plugins/ecommerce/client/components/index.mjs

@@ -0,0 +1,4 @@
+export { CartDrawer } from '../../../../packages/stack/src/plugins/ecommerce/client/components/cart-drawer.mjs';
+export { ProductImage } from '../../../../packages/stack/src/plugins/ecommerce/client/components/product-image.mjs';
+export { ProductImagesField } from '../../../../packages/stack/src/plugins/ecommerce/client/components/product-images-field.mjs';
+export { CartPageComponent, CheckoutPageComponent, MyOrdersPageComponent, OrderConfirmationPageComponent, OrderDetailPageComponent, OrdersAdminPageComponent, ProductDetailPageComponent, ProductListPageComponent } from '../../../../packages/stack/src/plugins/ecommerce/client/components/pages/route-page.mjs';

package/dist/plugins/ecommerce/client/hooks/index.cjs

@@ -0,0 +1,22 @@
+'use strict';
+
+const useCart = require('../../../../packages/stack/src/plugins/ecommerce/client/hooks/use-cart.cjs');
+const useProducts = require('../../../../packages/stack/src/plugins/ecommerce/client/hooks/use-products.cjs');
+const useOrders = require('../../../../packages/stack/src/plugins/ecommerce/client/hooks/use-orders.cjs');
+
+
+
+exports.useCart = useCart.useCart;
+exports.useEcommerceEndpoint = useProducts.useEcommerceEndpoint;
+exports.useProduct = useProducts.useProduct;
+exports.useProducts = useProducts.useProducts;
+exports.useSuspenseProduct = useProducts.useSuspenseProduct;
+exports.useSuspenseProducts = useProducts.useSuspenseProducts;
+exports.useCheckout = useOrders.useCheckout;
+exports.useMyOrders = useOrders.useMyOrders;
+exports.useOrder = useOrders.useOrder;
+exports.useOrderConfirmation = useOrders.useOrderConfirmation;
+exports.useOrders = useOrders.useOrders;
+exports.useUpdateOrderStatus = useOrders.useUpdateOrderStatus;
+exports.useValidateDiscount = useOrders.useValidateDiscount;
+exports.useVerifyCheckoutOrder = useOrders.useVerifyCheckoutOrder;

package/dist/plugins/ecommerce/client/hooks/index.d.cts

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { ProductFilters, OrderFilters, DiscountResult } from '../../query-keys.cjs';
+import { Product, ProductsPage, CheckoutResult, OrdersPage, Order, OrderStatus, CartItem as CartItem$1 } from '../../api/index.cjs';
+import '@btst/stack/plugins/client';
+import '@btst/stack/context';
+import '@btst/stack/plugins/api';
+import '../../../../authorization/index.cjs';
+import 'better-call';
+import '@btst/stack/plugins/cms/api';
+
+declare const CartItemSchema: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    variantName: z.ZodOptional<z.ZodString>;
+    price: z.ZodNumber;
+    currency: z.ZodString;
+    image: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+}, z.core.$strip>;
+/** Display snapshots are untrusted; checkout resolves prices and stock on the server. */
+type CartItem = z.infer<typeof CartItemSchema>;
+/** Persistent cart shared across storefront pages and drawers, scoped to the resolved store. */
+declare function useCart(): {
+    items: {
+        productId: string;
+        name: string;
+        price: number;
+        currency: string;
+        quantity: number;
+        variantId?: string | undefined;
+        variantName?: string | undefined;
+        image?: string | undefined;
+    }[];
+    isHydrated: boolean;
+    count: number;
+    subtotal: number;
+    storageAvailable: boolean;
+    storeKey: string;
+    addItem(input: Omit<CartItem, "quantity"> & {
+        quantity?: number;
+    }): void;
+    removeItem(productId: string, variantId?: string): void;
+    updateQuantity(productId: string, variantId: string | undefined, quantity: number): void;
+    clear(): void;
+};
+
+declare function useEcommerceEndpoint(): {
+    baseURL: string;
+    basePath: string;
+};
+declare function useProducts(filters?: ProductFilters): _tanstack_react_query.UseQueryResult<ProductsPage, Error>;
+declare function useSuspenseProducts(filters?: ProductFilters): _tanstack_react_query.UseSuspenseQueryResult<ProductsPage, Error>;
+declare function useProduct(slug: string): _tanstack_react_query.UseQueryResult<Product, Error>;
+declare function useSuspenseProduct(slug: string): _tanstack_react_query.UseSuspenseQueryResult<Product, Error>;
+
+declare function useOrders(filters?: OrderFilters): _tanstack_react_query.UseQueryResult<OrdersPage, Error>;
+declare function useOrder(id: string): _tanstack_react_query.UseQueryResult<Order, Error>;
+declare function useMyOrders(filters?: OrderFilters): _tanstack_react_query.UseQueryResult<OrdersPage, Error>;
+declare function useOrderConfirmation(id: string, token: string): _tanstack_react_query.UseQueryResult<Order, Error>;
+declare const useCheckout: () => _tanstack_react_query.UseMutationResult<CheckoutResult, Error, {
+    items: {
+        productId: string;
+        quantity: number;
+        variantId?: string | undefined;
+    }[];
+    email: string;
+    shippingAddress: {
+        name: string;
+        line1: string;
+        city: string;
+        postalCode: string;
+        country: string;
+        line2?: string | undefined;
+        region?: string | undefined;
+    };
+    idempotencyKey: string;
+    discountCode?: string | undefined;
+}>;
+declare const useUpdateOrderStatus: () => _tanstack_react_query.UseMutationResult<Order, Error, {
+    id: string;
+    status: OrderStatus;
+}>;
+declare const useValidateDiscount: () => _tanstack_react_query.UseMutationResult<DiscountResult, Error, {
+    code: string;
+    items: CartItem$1[];
+}>;
+/** Fresh authenticated confirmation reads used before reusing a checkout attempt. */
+declare function useVerifyCheckoutOrder(): (id: string, token: string) => Promise<Order>;
+
+export { useCart, useCheckout, useEcommerceEndpoint, useMyOrders, useOrder, useOrderConfirmation, useOrders, useProduct, useProducts, useSuspenseProduct, useSuspenseProducts, useUpdateOrderStatus, useValidateDiscount, useVerifyCheckoutOrder };
+export type { CartItem };

package/dist/plugins/ecommerce/client/hooks/index.d.mts

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { ProductFilters, OrderFilters, DiscountResult } from '../../query-keys.mjs';
+import { Product, ProductsPage, CheckoutResult, OrdersPage, Order, OrderStatus, CartItem as CartItem$1 } from '../../api/index.mjs';
+import '@btst/stack/plugins/client';
+import '@btst/stack/context';
+import '@btst/stack/plugins/api';
+import '../../../../authorization/index.mjs';
+import 'better-call';
+import '@btst/stack/plugins/cms/api';
+
+declare const CartItemSchema: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    variantName: z.ZodOptional<z.ZodString>;
+    price: z.ZodNumber;
+    currency: z.ZodString;
+    image: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+}, z.core.$strip>;
+/** Display snapshots are untrusted; checkout resolves prices and stock on the server. */
+type CartItem = z.infer<typeof CartItemSchema>;
+/** Persistent cart shared across storefront pages and drawers, scoped to the resolved store. */
+declare function useCart(): {
+    items: {
+        productId: string;
+        name: string;
+        price: number;
+        currency: string;
+        quantity: number;
+        variantId?: string | undefined;
+        variantName?: string | undefined;
+        image?: string | undefined;
+    }[];
+    isHydrated: boolean;
+    count: number;
+    subtotal: number;
+    storageAvailable: boolean;
+    storeKey: string;
+    addItem(input: Omit<CartItem, "quantity"> & {
+        quantity?: number;
+    }): void;
+    removeItem(productId: string, variantId?: string): void;
+    updateQuantity(productId: string, variantId: string | undefined, quantity: number): void;
+    clear(): void;
+};
+
+declare function useEcommerceEndpoint(): {
+    baseURL: string;
+    basePath: string;
+};
+declare function useProducts(filters?: ProductFilters): _tanstack_react_query.UseQueryResult<ProductsPage, Error>;
+declare function useSuspenseProducts(filters?: ProductFilters): _tanstack_react_query.UseSuspenseQueryResult<ProductsPage, Error>;
+declare function useProduct(slug: string): _tanstack_react_query.UseQueryResult<Product, Error>;
+declare function useSuspenseProduct(slug: string): _tanstack_react_query.UseSuspenseQueryResult<Product, Error>;
+
+declare function useOrders(filters?: OrderFilters): _tanstack_react_query.UseQueryResult<OrdersPage, Error>;
+declare function useOrder(id: string): _tanstack_react_query.UseQueryResult<Order, Error>;
+declare function useMyOrders(filters?: OrderFilters): _tanstack_react_query.UseQueryResult<OrdersPage, Error>;
+declare function useOrderConfirmation(id: string, token: string): _tanstack_react_query.UseQueryResult<Order, Error>;
+declare const useCheckout: () => _tanstack_react_query.UseMutationResult<CheckoutResult, Error, {
+    items: {
+        productId: string;
+        quantity: number;
+        variantId?: string | undefined;
+    }[];
+    email: string;
+    shippingAddress: {
+        name: string;
+        line1: string;
+        city: string;
+        postalCode: string;
+        country: string;
+        line2?: string | undefined;
+        region?: string | undefined;
+    };
+    idempotencyKey: string;
+    discountCode?: string | undefined;
+}>;
+declare const useUpdateOrderStatus: () => _tanstack_react_query.UseMutationResult<Order, Error, {
+    id: string;
+    status: OrderStatus;
+}>;
+declare const useValidateDiscount: () => _tanstack_react_query.UseMutationResult<DiscountResult, Error, {
+    code: string;
+    items: CartItem$1[];
+}>;
+/** Fresh authenticated confirmation reads used before reusing a checkout attempt. */
+declare function useVerifyCheckoutOrder(): (id: string, token: string) => Promise<Order>;
+
+export { useCart, useCheckout, useEcommerceEndpoint, useMyOrders, useOrder, useOrderConfirmation, useOrders, useProduct, useProducts, useSuspenseProduct, useSuspenseProducts, useUpdateOrderStatus, useValidateDiscount, useVerifyCheckoutOrder };
+export type { CartItem };

package/dist/plugins/ecommerce/client/hooks/index.d.ts

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { ProductFilters, OrderFilters, DiscountResult } from '../../query-keys.js';
+import { Product, ProductsPage, CheckoutResult, OrdersPage, Order, OrderStatus, CartItem as CartItem$1 } from '../../api/index.js';
+import '@btst/stack/plugins/client';
+import '@btst/stack/context';
+import '@btst/stack/plugins/api';
+import '../../../../authorization/index.js';
+import 'better-call';
+import '@btst/stack/plugins/cms/api';
+
+declare const CartItemSchema: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    variantName: z.ZodOptional<z.ZodString>;
+    price: z.ZodNumber;
+    currency: z.ZodString;
+    image: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+}, z.core.$strip>;
+/** Display snapshots are untrusted; checkout resolves prices and stock on the server. */
+type CartItem = z.infer<typeof CartItemSchema>;
+/** Persistent cart shared across storefront pages and drawers, scoped to the resolved store. */
+declare function useCart(): {
+    items: {
+        productId: string;
+        name: string;
+        price: number;
+        currency: string;
+        quantity: number;
+        variantId?: string | undefined;
+        variantName?: string | undefined;
+        image?: string | undefined;
+    }[];
+    isHydrated: boolean;
+    count: number;
+    subtotal: number;
+    storageAvailable: boolean;
+    storeKey: string;
+    addItem(input: Omit<CartItem, "quantity"> & {
+        quantity?: number;
+    }): void;
+    removeItem(productId: string, variantId?: string): void;
+    updateQuantity(productId: string, variantId: string | undefined, quantity: number): void;
+    clear(): void;
+};
+
+declare function useEcommerceEndpoint(): {
+    baseURL: string;
+    basePath: string;
+};
+declare function useProducts(filters?: ProductFilters): _tanstack_react_query.UseQueryResult<ProductsPage, Error>;
+declare function useSuspenseProducts(filters?: ProductFilters): _tanstack_react_query.UseSuspenseQueryResult<ProductsPage, Error>;
+declare function useProduct(slug: string): _tanstack_react_query.UseQueryResult<Product, Error>;
+declare function useSuspenseProduct(slug: string): _tanstack_react_query.UseSuspenseQueryResult<Product, Error>;
+
+declare function useOrders(filters?: OrderFilters): _tanstack_react_query.UseQueryResult<OrdersPage, Error>;
+declare function useOrder(id: string): _tanstack_react_query.UseQueryResult<Order, Error>;
+declare function useMyOrders(filters?: OrderFilters): _tanstack_react_query.UseQueryResult<OrdersPage, Error>;
+declare function useOrderConfirmation(id: string, token: string): _tanstack_react_query.UseQueryResult<Order, Error>;
+declare const useCheckout: () => _tanstack_react_query.UseMutationResult<CheckoutResult, Error, {
+    items: {
+        productId: string;
+        quantity: number;
+        variantId?: string | undefined;
+    }[];
+    email: string;
+    shippingAddress: {
+        name: string;
+        line1: string;
+        city: string;
+        postalCode: string;
+        country: string;
+        line2?: string | undefined;
+        region?: string | undefined;
+    };
+    idempotencyKey: string;
+    discountCode?: string | undefined;
+}>;
+declare const useUpdateOrderStatus: () => _tanstack_react_query.UseMutationResult<Order, Error, {
+    id: string;
+    status: OrderStatus;
+}>;
+declare const useValidateDiscount: () => _tanstack_react_query.UseMutationResult<DiscountResult, Error, {
+    code: string;
+    items: CartItem$1[];
+}>;
+/** Fresh authenticated confirmation reads used before reusing a checkout attempt. */
+declare function useVerifyCheckoutOrder(): (id: string, token: string) => Promise<Order>;
+
+export { useCart, useCheckout, useEcommerceEndpoint, useMyOrders, useOrder, useOrderConfirmation, useOrders, useProduct, useProducts, useSuspenseProduct, useSuspenseProducts, useUpdateOrderStatus, useValidateDiscount, useVerifyCheckoutOrder };
+export type { CartItem };

package/dist/plugins/ecommerce/client/hooks/index.mjs

@@ -0,0 +1,3 @@
+export { useCart } from '../../../../packages/stack/src/plugins/ecommerce/client/hooks/use-cart.mjs';
+export { useEcommerceEndpoint, useProduct, useProducts, useSuspenseProduct, useSuspenseProducts } from '../../../../packages/stack/src/plugins/ecommerce/client/hooks/use-products.mjs';
+export { useCheckout, useMyOrders, useOrder, useOrderConfirmation, useOrders, useUpdateOrderStatus, useValidateDiscount, useVerifyCheckoutOrder } from '../../../../packages/stack/src/plugins/ecommerce/client/hooks/use-orders.mjs';

package/dist/plugins/ecommerce/client/index.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+const plugin = require('../../../packages/stack/src/plugins/ecommerce/client/plugin.cjs');
+
+
+
+exports.ecommerceClientPlugin = plugin.ecommerceClientPlugin;