@btst/stack 5.0.0 → 5.2.0

package/dist/shared/stack.CsfAD5NP.d.ts

@@ -0,0 +1,1047 @@
+import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
+import { DeepReadonly } from '@btst/stack/plugins/api';
+import { PermissionDescriptor } from '../authorization/index.js';
+import * as better_call from 'better-call';
+import { QueryClient } from '@tanstack/react-query';
+import { z } from 'zod';
+import { ContentTypeConfig } from '@btst/stack/plugins/cms/api';
+
+declare const productVariantSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    price: z.ZodOptional<z.ZodNumber>;
+    stock: z.ZodDefault<z.ZodNumber>;
+    sku: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Product data authored in CMS; all amounts are integer minor units. */
+declare const productSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodDefault<z.ZodString>;
+    price: z.ZodNumber;
+    currency: z.ZodDefault<z.ZodString>;
+    stock: z.ZodDefault<z.ZodNumber>;
+    images: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    category: z.ZodOptional<z.ZodString>;
+    collections: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        archived: "archived";
+        draft: "draft";
+        published: "published";
+    }>>;
+    variants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+        price: z.ZodOptional<z.ZodNumber>;
+        stock: z.ZodDefault<z.ZodNumber>;
+        sku: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const PRODUCT_TYPE_SLUG: "ecommerce-product";
+/** Register this alongside the Ecommerce backend plugin in CMS contentTypes. */
+declare const PRODUCT_CONTENT_TYPE: ContentTypeConfig;
+declare const productsQuerySchema: z.ZodObject<{
+    category: z.ZodOptional<z.ZodString>;
+    collection: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    minPrice: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    maxPrice: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    inStock: z.ZodPreprocess<z.ZodOptional<z.ZodBoolean>, unknown>;
+    limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+declare const cartItemSchema: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodString>;
+    quantity: z.ZodNumber;
+}, z.core.$strip>;
+declare const shippingAddressSchema: z.ZodObject<{
+    name: z.ZodString;
+    line1: z.ZodString;
+    line2: z.ZodOptional<z.ZodString>;
+    city: z.ZodString;
+    region: z.ZodOptional<z.ZodString>;
+    postalCode: z.ZodString;
+    country: z.ZodString;
+}, z.core.$strip>;
+declare const checkoutSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        productId: z.ZodString;
+        variantId: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodNumber;
+    }, z.core.$strip>>;
+    email: z.ZodEmail;
+    shippingAddress: z.ZodObject<{
+        name: z.ZodString;
+        line1: z.ZodString;
+        line2: z.ZodOptional<z.ZodString>;
+        city: z.ZodString;
+        region: z.ZodOptional<z.ZodString>;
+        postalCode: z.ZodString;
+        country: z.ZodString;
+    }, z.core.$strip>;
+    discountCode: z.ZodOptional<z.ZodString>;
+    idempotencyKey: z.ZodUUID;
+}, z.core.$strip>;
+declare const orderStatusSchema: z.ZodEnum<{
+    pending: "pending";
+    paid: "paid";
+    fulfilling: "fulfilling";
+    fulfilled: "fulfilled";
+    cancelled: "cancelled";
+}>;
+/** Restocking requires the last observed available count to prevent lost updates. */
+declare const updateInventorySchema: z.ZodObject<{
+    productId: z.ZodString;
+    variantId: z.ZodOptional<z.ZodString>;
+    stock: z.ZodNumber;
+    expectedStock: z.ZodNumber;
+}, z.core.$strip>;
+
+/** CMS product exposed by the storefront. */
+type Product = z.output<typeof productSchema> & {
+    id: string;
+    slug: string;
+    createdAt: string;
+    updatedAt: string;
+};
+type ProductVariant = z.output<typeof productVariantSchema>;
+type ProductsFilters = z.input<typeof productsQuerySchema>;
+type ProductsPage = {
+    items: Product[];
+    total: number;
+    limit: number;
+    offset: number;
+    categories: string[];
+    collections: string[];
+};
+type CartItem = z.output<typeof cartItemSchema>;
+type ShippingAddress = z.output<typeof shippingAddressSchema>;
+type CheckoutInput = z.input<typeof checkoutSchema>;
+type OrderStatus = z.output<typeof orderStatusSchema>;
+type OrderLineItem = {
+    productId: string;
+    variantId?: string;
+    name: string;
+    variantName?: string;
+    quantity: number;
+    price: number;
+    image?: string;
+};
+/** Safe order representation; access tokens and idempotency keys are never listed. */
+type Order = {
+    id: string;
+    email: string;
+    customerId?: string | null;
+    status: OrderStatus;
+    lineItems: OrderLineItem[];
+    subtotal: number;
+    discount: number;
+    shipping: number;
+    total: number;
+    currency: string;
+    shippingAddress: ShippingAddress;
+    paymentProvider: string;
+    paymentRef?: string | null;
+    paymentStatus: "pending" | "paid" | "failed" | "refunded";
+    createdAt: string;
+    updatedAt: string;
+};
+type OrdersPage = {
+    items: Order[];
+    total: number;
+};
+type OrderRecord = Omit<Order, "lineItems" | "shippingAddress" | "createdAt" | "updatedAt"> & {
+    lineItems: string;
+    shippingAddress: string;
+    createdAt: Date;
+    updatedAt: Date;
+    accessToken: string;
+    idempotencyKey: string;
+    checkoutFingerprint: string;
+    paymentData: string;
+    discountCodeId?: string | null;
+    inventoryReleased: boolean;
+    paidHookDelivered: boolean;
+};
+type DiscountCode = {
+    id: string;
+    code: string;
+    type: "percent" | "fixed";
+    value: number;
+    maxUses?: number | null;
+    uses: number;
+    expiresAt?: Date | null;
+};
+type CheckoutResult = {
+    orderId: string;
+    accessToken: string;
+    payment: {
+        redirectUrl?: string;
+        clientSecret?: string;
+    };
+};
+/** Serialized products and orders already carry ISO date strings. */
+type SerializedProduct = Product;
+type ProductListParams = ProductsFilters;
+type ProductListResult = ProductsPage;
+type SerializedOrder = Order;
+type CartLineInput = CartItem;
+type DiscountResult = {
+    code: string;
+    discount: number;
+    subtotal: number;
+    total: number;
+    currency: string;
+};
+/** Authoritative remaining stock after initialization from the CMS product. */
+type InventoryRecord = {
+    id: string;
+    key: string;
+    productId: string;
+    variantId?: string | null;
+    stock: number;
+};
+
+/** A verified provider event. Amount and currency must match the server's pending order. */
+interface PaymentWebhookResult {
+    orderId: string;
+    status: "paid" | "failed" | "refunded";
+    paymentRef: string;
+    amount: number;
+    currency: string;
+}
+/** Payment providers verify signatures before returning an event. Calls may be retried with the same orderId. */
+interface PaymentAdapter {
+    /** Provider name persisted alongside orders. */
+    name?: string;
+    /** Pure preflight before creating an order. Return a rejection message for unsupported totals; never create provider resources here. */
+    validatePayment?(options: {
+        amount: number;
+        currency: string;
+    }): string | undefined;
+    /** Use orderId as the provider idempotency key. Return a hosted checkout URL or client secret. */
+    createPayment(options: {
+        amount: number;
+        currency: string;
+        orderId: string;
+        metadata?: Record<string, string>;
+    }): Promise<{
+        clientSecret?: string;
+        redirectUrl?: string;
+    }>;
+    /** Verify the raw request body and reject invalid signatures. Ignore unrelated event types with null. */
+    handleWebhook(request: Request): Promise<PaymentWebhookResult | null>;
+}
+
+/** Authorized checkout and payment lifecycle events. */
+interface EcommerceBackendHooks {
+    onBeforeCreateOrder?: (input: DeepReadonly<z.output<typeof checkoutSchema>>, context: {
+        request?: Request;
+    }) => void | Promise<void>;
+    /** Retried on verified paid webhooks until successful. Make fulfillment idempotent by order.id. */
+    onAfterOrderPaid?: (order: DeepReadonly<Order>, context: {
+        request?: Request;
+    }) => void | Promise<void>;
+}
+/** Commerce configuration; CMS must register PRODUCT_CONTENT_TYPE. */
+interface EcommerceBackendConfig {
+    /** Provider implementation; raw webhook signatures must be verified by the adapter. */
+    paymentAdapter: PaymentAdapter;
+    /** Store currency, shared by every product and checkout. @default USD */
+    currency?: string;
+    /** Flat shipping charge in currency minor units. @default 0 */
+    shippingAmount?: number;
+    /** Post-authorization business callbacks. */
+    hooks?: EcommerceBackendHooks;
+}
+
+/** API location used to partition storefront caches shared by multiple stacks. */
+interface EcommerceEndpointPartition {
+    baseURL: string;
+    basePath: string;
+}
+declare function ecommerceEndpointDiscriminator(endpoint: EcommerceEndpointPartition): {
+    baseURL: string;
+    basePath: string;
+};
+declare function productsListDiscriminator(filters?: ProductsFilters): {
+    category: string | undefined;
+    collection: string | undefined;
+    search: string | undefined;
+    minPrice: unknown;
+    maxPrice: unknown;
+    inStock: unknown;
+    limit: {};
+    offset: {};
+};
+declare const ECOMMERCE_QUERY_KEYS: {
+    list: (filters: ProductsFilters, endpoint: EcommerceEndpointPartition) => readonly ["ecommerceProducts", "list", {
+        category: string | undefined;
+        collection: string | undefined;
+        search: string | undefined;
+        minPrice: unknown;
+        maxPrice: unknown;
+        inStock: unknown;
+        limit: {};
+        offset: {};
+    }, {
+        baseURL: string;
+        basePath: string;
+    }];
+    detail: (slug: string, endpoint: EcommerceEndpointPartition) => readonly ["ecommerceProducts", "detail", string, {
+        baseURL: string;
+        basePath: string;
+    }];
+};
+
+/** Only the public storefront routes can be statically generated. */
+type EcommerceRouteKey = "shop" | "product";
+interface EcommercePrefetchForRoute {
+    (key: "shop", queryClient: QueryClient, options: {
+        endpoint: EcommerceEndpointPartition;
+        filters?: ProductsFilters;
+    }): Promise<void>;
+    (key: "product", queryClient: QueryClient, options: {
+        endpoint: EcommerceEndpointPartition;
+        slug: string;
+    }): Promise<void>;
+}
+/** CMS-backed storefront, authoritative checkout, verified payments and protected order management. */
+declare function ecommerceBackendPlugin(config: EcommerceBackendConfig): _btst_stack_plugins_api.BackendPlugin<{
+    listProducts: better_call.StrictEndpoint<"/shop/products", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            category?: string | undefined;
+            collection?: string | undefined;
+            search?: string | undefined;
+            minPrice?: unknown;
+            maxPrice?: unknown;
+            inStock?: unknown;
+            limit?: unknown;
+            offset?: unknown;
+        }, {
+            category?: string | undefined;
+            collection?: string | undefined;
+            search?: string | undefined;
+            minPrice?: unknown;
+            maxPrice?: unknown;
+            inStock?: unknown;
+            limit?: unknown;
+            offset?: unknown;
+        }>;
+    }, {
+        readonly items: readonly {
+            readonly name: string;
+            readonly description: string;
+            readonly price: number;
+            readonly currency: string;
+            readonly stock: number;
+            readonly images: readonly string[];
+            readonly collections: readonly string[];
+            readonly tags: readonly string[];
+            readonly status: "archived" | "draft" | "published";
+            readonly variants: readonly {
+                readonly id: string;
+                readonly name: string;
+                readonly options: {
+                    readonly [x: string]: string;
+                };
+                readonly stock: number;
+                readonly price?: number | undefined;
+                readonly sku?: string | undefined;
+            }[];
+            readonly category?: string | undefined;
+            readonly id: string;
+            readonly slug: string;
+            readonly createdAt: string;
+            readonly updatedAt: string;
+        }[];
+        readonly total: number;
+        readonly limit: number;
+        readonly offset: number;
+        readonly categories: readonly string[];
+        readonly collections: readonly string[];
+    }>;
+    getProduct: better_call.StrictEndpoint<"/shop/products/:slug", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    }, {
+        readonly name: string;
+        readonly description: string;
+        readonly price: number;
+        readonly currency: string;
+        readonly stock: number;
+        readonly images: readonly string[];
+        readonly collections: readonly string[];
+        readonly tags: readonly string[];
+        readonly status: "archived" | "draft" | "published";
+        readonly variants: readonly {
+            readonly id: string;
+            readonly name: string;
+            readonly options: {
+                readonly [x: string]: string;
+            };
+            readonly stock: number;
+            readonly price?: number | undefined;
+            readonly sku?: string | undefined;
+        }[];
+        readonly category?: string | undefined;
+        readonly id: string;
+        readonly slug: string;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    createProduct: better_call.StrictEndpoint<"/shop/products", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            slug: string;
+            data: {
+                name: string;
+                price: number;
+                description?: string | undefined;
+                currency?: string | undefined;
+                stock?: number | undefined;
+                images?: string[] | undefined;
+                category?: string | undefined;
+                collections?: string[] | undefined;
+                tags?: string[] | undefined;
+                status?: "archived" | "draft" | "published" | undefined;
+                variants?: {
+                    id: string;
+                    name: string;
+                    options?: Record<string, string> | undefined;
+                    price?: number | undefined;
+                    stock?: number | undefined;
+                    sku?: string | undefined;
+                }[] | undefined;
+            };
+        }, {
+            slug: string;
+            data: {
+                name: string;
+                price: number;
+                description?: string | undefined;
+                currency?: string | undefined;
+                stock?: number | undefined;
+                images?: string[] | undefined;
+                category?: string | undefined;
+                collections?: string[] | undefined;
+                tags?: string[] | undefined;
+                status?: "archived" | "draft" | "published" | undefined;
+                variants?: {
+                    id: string;
+                    name: string;
+                    options?: Record<string, string> | undefined;
+                    price?: number | undefined;
+                    stock?: number | undefined;
+                    sku?: string | undefined;
+                }[] | undefined;
+            };
+        }>;
+    }, {
+        readonly name: string;
+        readonly description: string;
+        readonly price: number;
+        readonly currency: string;
+        readonly stock: number;
+        readonly images: readonly string[];
+        readonly collections: readonly string[];
+        readonly tags: readonly string[];
+        readonly status: "archived" | "draft" | "published";
+        readonly variants: readonly {
+            readonly id: string;
+            readonly name: string;
+            readonly options: {
+                readonly [x: string]: string;
+            };
+            readonly stock: number;
+            readonly price?: number | undefined;
+            readonly sku?: string | undefined;
+        }[];
+        readonly category?: string | undefined;
+        readonly id: string;
+        readonly slug: string;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    updateInventory: better_call.StrictEndpoint<"/shop/inventory", {
+        requireRequest: true;
+    } & {
+        method: "PATCH";
+        body: better_call.StandardSchemaV1<{
+            productId: string;
+            stock: number;
+            expectedStock: number;
+            variantId?: string | undefined;
+        }, {
+            productId: string;
+            stock: number;
+            expectedStock: number;
+            variantId?: string | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly key: string;
+        readonly productId: string;
+        readonly variantId?: string | null | undefined;
+        readonly stock: number;
+    }>;
+    createDiscountCode: better_call.StrictEndpoint<"/shop/discounts", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            code: string;
+            type: "fixed" | "percent";
+            value: number;
+            maxUses?: number | undefined;
+            expiresAt?: string | undefined;
+        }, {
+            code: string;
+            type: "fixed" | "percent";
+            value: number;
+            maxUses?: number | undefined;
+            expiresAt?: string | undefined;
+        }>;
+    }, {
+        readonly expiresAt: string | null;
+        readonly id: string;
+        readonly code: string;
+        readonly type: "percent" | "fixed";
+        readonly value: number;
+        readonly maxUses?: number | null | undefined;
+        readonly uses: number;
+    }>;
+    validateDiscountCode: better_call.StrictEndpoint<"/shop/discounts/validate", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            code: string;
+            items: {
+                productId: string;
+                quantity: number;
+                variantId?: string | undefined;
+            }[];
+        }, {
+            code: string;
+            items: {
+                productId: string;
+                quantity: number;
+                variantId?: string | undefined;
+            }[];
+        }>;
+    }, {
+        readonly code: string;
+        readonly discount: number;
+        readonly subtotal: number;
+        readonly total: number;
+        readonly currency: string;
+    }>;
+    createCheckout: better_call.StrictEndpoint<"/shop/checkout", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            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;
+        }, {
+            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;
+        }>;
+    }, {
+        readonly orderId: string;
+        readonly accessToken: string;
+        readonly payment: {
+            readonly redirectUrl?: string | undefined;
+            readonly clientSecret?: string | undefined;
+        };
+    }>;
+    listOrders: better_call.StrictEndpoint<"/shop/orders", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            status?: "pending" | "paid" | "fulfilling" | "fulfilled" | "cancelled" | undefined;
+            limit?: unknown;
+            offset?: unknown;
+        }, {
+            status?: "pending" | "paid" | "fulfilling" | "fulfilled" | "cancelled" | undefined;
+            limit?: unknown;
+            offset?: unknown;
+        }>;
+    }, {
+        readonly items: readonly {
+            readonly id: string;
+            readonly email: string;
+            readonly customerId?: string | null | undefined;
+            readonly status: OrderStatus;
+            readonly lineItems: readonly {
+                readonly productId: string;
+                readonly variantId?: string | undefined;
+                readonly name: string;
+                readonly variantName?: string | undefined;
+                readonly quantity: number;
+                readonly price: number;
+                readonly image?: string | undefined;
+            }[];
+            readonly subtotal: number;
+            readonly discount: number;
+            readonly shipping: number;
+            readonly total: number;
+            readonly currency: string;
+            readonly shippingAddress: {
+                readonly name: string;
+                readonly line1: string;
+                readonly city: string;
+                readonly postalCode: string;
+                readonly country: string;
+                readonly line2?: string | undefined;
+                readonly region?: string | undefined;
+            };
+            readonly paymentProvider: string;
+            readonly paymentRef?: string | null | undefined;
+            readonly paymentStatus: "pending" | "paid" | "failed" | "refunded";
+            readonly createdAt: string;
+            readonly updatedAt: string;
+        }[];
+        readonly total: number;
+    }>;
+    listMyOrders: better_call.StrictEndpoint<"/shop/orders/mine", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            status?: "pending" | "paid" | "fulfilling" | "fulfilled" | "cancelled" | undefined;
+            limit?: unknown;
+            offset?: unknown;
+        }, {
+            status?: "pending" | "paid" | "fulfilling" | "fulfilled" | "cancelled" | undefined;
+            limit?: unknown;
+            offset?: unknown;
+        }>;
+    }, {
+        readonly items: readonly {
+            readonly id: string;
+            readonly email: string;
+            readonly customerId?: string | null | undefined;
+            readonly status: OrderStatus;
+            readonly lineItems: readonly {
+                readonly productId: string;
+                readonly variantId?: string | undefined;
+                readonly name: string;
+                readonly variantName?: string | undefined;
+                readonly quantity: number;
+                readonly price: number;
+                readonly image?: string | undefined;
+            }[];
+            readonly subtotal: number;
+            readonly discount: number;
+            readonly shipping: number;
+            readonly total: number;
+            readonly currency: string;
+            readonly shippingAddress: {
+                readonly name: string;
+                readonly line1: string;
+                readonly city: string;
+                readonly postalCode: string;
+                readonly country: string;
+                readonly line2?: string | undefined;
+                readonly region?: string | undefined;
+            };
+            readonly paymentProvider: string;
+            readonly paymentRef?: string | null | undefined;
+            readonly paymentStatus: "pending" | "paid" | "failed" | "refunded";
+            readonly createdAt: string;
+            readonly updatedAt: string;
+        }[];
+        readonly total: number;
+    }>;
+    getOrder: better_call.StrictEndpoint<"/shop/orders/:id", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    }, {
+        readonly id: string;
+        readonly email: string;
+        readonly customerId?: string | null | undefined;
+        readonly status: OrderStatus;
+        readonly lineItems: readonly {
+            readonly productId: string;
+            readonly variantId?: string | undefined;
+            readonly name: string;
+            readonly variantName?: string | undefined;
+            readonly quantity: number;
+            readonly price: number;
+            readonly image?: string | undefined;
+        }[];
+        readonly subtotal: number;
+        readonly discount: number;
+        readonly shipping: number;
+        readonly total: number;
+        readonly currency: string;
+        readonly shippingAddress: {
+            readonly name: string;
+            readonly line1: string;
+            readonly city: string;
+            readonly postalCode: string;
+            readonly country: string;
+            readonly line2?: string | undefined;
+            readonly region?: string | undefined;
+        };
+        readonly paymentProvider: string;
+        readonly paymentRef?: string | null | undefined;
+        readonly paymentStatus: "pending" | "paid" | "failed" | "refunded";
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    getOrderConfirmation: better_call.StrictEndpoint<"/shop/orders/:id/confirmation", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            token: string;
+        }, {
+            token: string;
+        }>;
+    }, {
+        readonly id: string;
+        readonly email: string;
+        readonly customerId?: string | null | undefined;
+        readonly status: OrderStatus;
+        readonly lineItems: readonly {
+            readonly productId: string;
+            readonly variantId?: string | undefined;
+            readonly name: string;
+            readonly variantName?: string | undefined;
+            readonly quantity: number;
+            readonly price: number;
+            readonly image?: string | undefined;
+        }[];
+        readonly subtotal: number;
+        readonly discount: number;
+        readonly shipping: number;
+        readonly total: number;
+        readonly currency: string;
+        readonly shippingAddress: {
+            readonly name: string;
+            readonly line1: string;
+            readonly city: string;
+            readonly postalCode: string;
+            readonly country: string;
+            readonly line2?: string | undefined;
+            readonly region?: string | undefined;
+        };
+        readonly paymentProvider: string;
+        readonly paymentRef?: string | null | undefined;
+        readonly paymentStatus: "pending" | "paid" | "failed" | "refunded";
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    updateOrderStatus: better_call.StrictEndpoint<"/shop/orders/:id", {
+        requireRequest: true;
+    } & {
+        method: "PATCH";
+        body: better_call.StandardSchemaV1<{
+            status: "pending" | "paid" | "fulfilling" | "fulfilled" | "cancelled";
+        }, {
+            status: "pending" | "paid" | "fulfilling" | "fulfilled" | "cancelled";
+        }>;
+    }, {
+        readonly id: string;
+        readonly email: string;
+        readonly customerId?: string | null | undefined;
+        readonly status: OrderStatus;
+        readonly lineItems: readonly {
+            readonly productId: string;
+            readonly variantId?: string | undefined;
+            readonly name: string;
+            readonly variantName?: string | undefined;
+            readonly quantity: number;
+            readonly price: number;
+            readonly image?: string | undefined;
+        }[];
+        readonly subtotal: number;
+        readonly discount: number;
+        readonly shipping: number;
+        readonly total: number;
+        readonly currency: string;
+        readonly shippingAddress: {
+            readonly name: string;
+            readonly line1: string;
+            readonly city: string;
+            readonly postalCode: string;
+            readonly country: string;
+            readonly line2?: string | undefined;
+            readonly region?: string | undefined;
+        };
+        readonly paymentProvider: string;
+        readonly paymentRef?: string | null | undefined;
+        readonly paymentStatus: "pending" | "paid" | "failed" | "refunded";
+        readonly createdAt: string;
+        readonly updatedAt: string;
+    }>;
+    handleWebhook: better_call.StrictEndpoint<"/shop/webhook", {
+        requireRequest: true;
+        disableBody: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
+    }, {
+        readonly received: true;
+    }>;
+}, {
+    prefetchForRoute: EcommercePrefetchForRoute;
+}, {
+    listProducts: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        category: z.ZodOptional<z.ZodString>;
+        collection: z.ZodOptional<z.ZodString>;
+        search: z.ZodOptional<z.ZodString>;
+        minPrice: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        maxPrice: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+        inStock: z.ZodPreprocess<z.ZodOptional<z.ZodBoolean>, unknown>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:product.read", z.ZodObject<{
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>, ProductsPage, false>;
+    getProduct: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        slug: z.ZodString;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:product.read", z.ZodObject<{
+        slug: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>, {
+        name: string;
+        description: string;
+        price: number;
+        currency: string;
+        stock: number;
+        images: string[];
+        collections: string[];
+        tags: string[];
+        status: "archived" | "draft" | "published";
+        variants: {
+            id: string;
+            name: string;
+            options: Record<string, string>;
+            stock: number;
+            price?: number | undefined;
+            sku?: string | undefined;
+        }[];
+        category?: string | undefined;
+    } & {
+        id: string;
+        slug: string;
+        createdAt: string;
+        updatedAt: string;
+    }, false>;
+    createProduct: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        slug: z.ZodString;
+        data: z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodDefault<z.ZodString>;
+            price: z.ZodNumber;
+            currency: z.ZodDefault<z.ZodString>;
+            stock: z.ZodDefault<z.ZodNumber>;
+            images: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            category: z.ZodOptional<z.ZodString>;
+            collections: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+            status: z.ZodDefault<z.ZodEnum<{
+                archived: "archived";
+                draft: "draft";
+                published: "published";
+            }>>;
+            variants: z.ZodDefault<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                options: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+                price: z.ZodOptional<z.ZodNumber>;
+                stock: z.ZodDefault<z.ZodNumber>;
+                sku: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+        }, z.core.$strip>;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:product.manage", z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>, {
+        name: string;
+        description: string;
+        price: number;
+        currency: string;
+        stock: number;
+        images: string[];
+        collections: string[];
+        tags: string[];
+        status: "archived" | "draft" | "published";
+        variants: {
+            id: string;
+            name: string;
+            options: Record<string, string>;
+            stock: number;
+            price?: number | undefined;
+            sku?: string | undefined;
+        }[];
+        category?: string | undefined;
+    } & {
+        id: string;
+        slug: string;
+        createdAt: string;
+        updatedAt: string;
+    }, false>;
+    updateInventory: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        productId: z.ZodString;
+        variantId: z.ZodOptional<z.ZodString>;
+        stock: z.ZodNumber;
+        expectedStock: z.ZodNumber;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:product.manage", z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>, InventoryRecord, false>;
+    createDiscountCode: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        code: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        type: z.ZodEnum<{
+            fixed: "fixed";
+            percent: "percent";
+        }>;
+        value: z.ZodNumber;
+        maxUses: z.ZodOptional<z.ZodNumber>;
+        expiresAt: z.ZodOptional<z.ZodISODateTime>;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:discount.manage", z.ZodObject<{}, z.core.$strip>>, {
+        expiresAt: string | null;
+        id: string;
+        code: string;
+        type: "percent" | "fixed";
+        value: number;
+        maxUses?: number | null;
+        uses: number;
+    }, false>;
+    validateDiscountCode: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        code: z.ZodString;
+        items: z.ZodArray<z.ZodObject<{
+            productId: z.ZodString;
+            variantId: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodNumber;
+        }, z.core.$strip>>;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:discount.validate", z.ZodObject<{}, z.core.$strip>>, DiscountResult, false>;
+    createCheckout: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        items: z.ZodArray<z.ZodObject<{
+            productId: z.ZodString;
+            variantId: z.ZodOptional<z.ZodString>;
+            quantity: z.ZodNumber;
+        }, z.core.$strip>>;
+        email: z.ZodEmail;
+        shippingAddress: z.ZodObject<{
+            name: z.ZodString;
+            line1: z.ZodString;
+            line2: z.ZodOptional<z.ZodString>;
+            city: z.ZodString;
+            region: z.ZodOptional<z.ZodString>;
+            postalCode: z.ZodString;
+            country: z.ZodString;
+        }, z.core.$strip>;
+        discountCode: z.ZodOptional<z.ZodString>;
+        idempotencyKey: z.ZodUUID;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:checkout.create", z.ZodObject<{}, z.core.$strip>>, CheckoutResult, false>;
+    listOrders: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        status: z.ZodOptional<z.ZodEnum<{
+            pending: "pending";
+            paid: "paid";
+            fulfilling: "fulfilling";
+            fulfilled: "fulfilled";
+            cancelled: "cancelled";
+        }>>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:order.read", z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>, {
+        items: Order[];
+        total: number;
+    }, false>;
+    getOrder: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:order.read", z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>, Order, false>;
+    listMyOrders: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        status: z.ZodOptional<z.ZodEnum<{
+            pending: "pending";
+            paid: "paid";
+            fulfilling: "fulfilling";
+            fulfilled: "fulfilled";
+            cancelled: "cancelled";
+        }>>;
+        limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+        offset: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:order.own", z.ZodObject<{
+        customerId: z.ZodString;
+    }, z.core.$strip>>, {
+        items: Order[];
+        total: number;
+    }, false>;
+    getOrderConfirmation: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        id: z.ZodString;
+        token: z.ZodString;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:order.confirmation", z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strip>>, Order, false>;
+    updateOrderStatus: _btst_stack_plugins_api.Operation<z.ZodObject<{
+        id: z.ZodString;
+        status: z.ZodEnum<{
+            pending: "pending";
+            paid: "paid";
+            fulfilling: "fulfilling";
+            fulfilled: "fulfilled";
+            cancelled: "cancelled";
+        }>;
+    }, z.core.$strip>, PermissionDescriptor<"ecommerce:order.update", z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>, Order, false>;
+    handleWebhook: _btst_stack_plugins_api.Operation<z.ZodObject<{}, z.core.$strip>, PermissionDescriptor<"ecommerce:checkout.webhook", z.ZodObject<{}, z.core.$strip>>, {
+        received: true;
+    }, false>;
+}, "ecommerce">;
+type EcommerceApiRouter = ReturnType<ReturnType<typeof ecommerceBackendPlugin>["routes"]>;
+
+export { ecommerceEndpointDiscriminator as A, productSchema as B, productVariantSchema as F, productsListDiscriminator as G, shippingAddressSchema as H, updateInventorySchema as J, ECOMMERCE_QUERY_KEYS as m, PRODUCT_CONTENT_TYPE as q, PRODUCT_TYPE_SLUG as r, checkoutSchema as y, ecommerceBackendPlugin as z };
+export type { CheckoutInput as C, DiscountCode as D, EcommerceEndpointPartition as E, InventoryRecord as I, OrderStatus as O, ProductsPage as P, SerializedOrder as S, EcommerceApiRouter as a, Product as b, OrdersPage as c, Order as d, CheckoutResult as e, CartItem as f, PaymentAdapter as g, OrderRecord as h, ProductsFilters as i, OrderLineItem as j, CartLineInput as k, DiscountResult as l, EcommerceBackendConfig as n, EcommerceBackendHooks as o, EcommerceRouteKey as p, PaymentWebhookResult as s, ProductListParams as t, ProductListResult as u, ProductVariant as v, SerializedProduct as w, ShippingAddress as x };