/**
 * This file was auto-generated by openapi-typescript.
 * Do not make direct changes to the file.
 */

export interface paths {
    "/v1/health": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Service health check
         * @description Returns service status. No authentication required.
         */
        get: operations["healthCheck"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/auth/login": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Authenticate user
         * @description Authenticate with email and password. Returns a bearer token.
         */
        post: operations["login"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/auth/register": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Register a new user
         * @description Create a new user account. Returns a bearer token on success.
         */
        post: operations["register"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/auth/logout": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Revoke current token
         * @description Revoke the authenticated user's current bearer token.
         */
        post: operations["logout"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/auth/me": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get authenticated user
         * @description Returns the currently authenticated user's profile.
         */
        get: operations["authMe"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/auth/social/{provider}/redirect": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get OAuth redirect URL
         * @description Returns the OAuth provider redirect URL for social login.
         */
        get: operations["socialRedirect"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/users/me": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get user profile
         * @description Returns the authenticated user's profile.
         */
        get: operations["getUserProfile"];
        /**
         * Update user profile
         * @description Update the authenticated user's profile fields.
         */
        put: operations["updateUserProfile"];
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get store details
         * @description Returns public details for a store.
         */
        get: operations["getStore"];
        /**
         * Update store
         * @description Update store details. Requires store owner role.
         */
        put: operations["updateStore"];
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List verified stores
         * @description Returns a list of all verified stores.
         */
        get: operations["listStores"];
        put?: never;
        /**
         * Create store
         * @description Create a new store. Admin only.
         */
        post: operations["createStore"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/settings": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get store settings
         * @description Returns store settings. Requires store owner role.
         */
        get: operations["getStoreSettings"];
        /**
         * Update store settings
         * @description Update store settings. Requires store owner role.
         */
        put: operations["updateStoreSettings"];
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/items": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Browse marketplace items
         * @description Returns paginated list of active items from verified stores with faceted counts.
         *     Supports full-text search, filtering by category, brand, size, condition, color,
         *     store, and price range.
         */
        get: operations["listItems"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/items/{item}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get item detail
         * @description Returns full detail for a single active item from a verified store.
         */
        get: operations["getItem"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/items": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List store's items
         * @description Returns paginated list of items for a store. Requires store owner auth.
         */
        get: operations["listStoreItems"];
        put?: never;
        /**
         * Create a new item
         * @description Creates a new item in draft status. Requires store owner auth.
         */
        post: operations["createItem"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/items/{item}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get store item detail
         * @description Returns full item detail for store owner. Requires store owner auth.
         */
        get: operations["getStoreItem"];
        /**
         * Update an item
         * @description Updates item fields. Requires store owner auth.
         */
        put: operations["updateItem"];
        post?: never;
        /**
         * Soft-delete an item
         * @description Soft-deletes an item. Requires store owner auth.
         */
        delete: operations["deleteItem"];
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/items/{item}/images": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Upload images to an item
         * @description Upload one or more images. Images are processed (EXIF stripped, converted to WebP). Requires store owner auth.
         */
        post: operations["uploadItemImages"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/items/{item}/images/{mediaId}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        /** Remove an image from an item */
        delete: operations["removeItemImage"];
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/items/{item}/publish": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Publish a draft item
         * @description Transitions item from draft to active. Dispatches ItemPublished event.
         */
        post: operations["publishItem"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/items/{item}/remove": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Remove an active item
         * @description Transitions item from active to removed. Dispatches ItemRemoved event.
         */
        post: operations["removeItem"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/items/{item}/relist": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Relist a removed item
         * @description Transitions item from removed to active. Dispatches ItemRelisted event.
         */
        post: operations["relistItem"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/categories": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get the full public category tree
         * @description Returns the complete category taxonomy as a nested tree structure.
         */
        get: operations["listCategories"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/snap/items": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Snap auto-publish item
         * @description Creates an item with images and immediately publishes it (active status).
         *     Used by the Snap desktop app. Skips draft state.
         */
        post: operations["snapPublishItem"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/parcel-presets": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List store parcel presets */
        get: operations["listParcelPresets"];
        put?: never;
        /** Create parcel preset */
        post: operations["createParcelPreset"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/parcel-presets/{preset}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        /** Delete parcel preset */
        delete: operations["deleteParcelPreset"];
        options?: never;
        head?: never;
        /** Update parcel preset */
        patch: operations["updateParcelPreset"];
        trace?: never;
    };
    "/v1/cart": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get current user's cart
         * @description Returns cart items grouped by store with live prices. Prices are always fetched fresh from the items table.
         */
        get: operations["getCart"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/cart/items": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Add item to cart */
        post: operations["addCartItem"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/cart/items/{item_id}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        /** Remove item from cart */
        delete: operations["removeCartItem"];
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/checkout": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Initiate checkout
         * @description Validates cart, acquires Redis locks, calculates totals, creates Stripe PaymentIntent.
         */
        post: operations["initiateCheckout"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/checkout/{checkout_id}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        /** Cancel checkout and release locks */
        delete: operations["cancelCheckout"];
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stripe/webhook": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Handle Stripe webhook events
         * @description Authenticated via Stripe signature, not bearer token.
         */
        post: operations["stripeWebhook"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/purchases": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List buyer's purchases */
        get: operations["listPurchases"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/purchases/{purchase_id}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Get purchase detail with orders */
        get: operations["getPurchase"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/orders": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List orders for a store (seller) */
        get: operations["listStoreOrders"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/orders/{order}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Get order detail (seller) */
        get: operations["getStoreOrder"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/webhooks/easypost": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** EasyPost tracker webhook */
        post: operations["easypostWebhook"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/orders/{order}/cancel": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Buyer cancels an unshipped order */
        post: operations["buyerCancelOrder"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/orders/{order}/cancel": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Seller cancels an unshipped order */
        post: operations["sellerCancelOrder"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/orders/{order}/labels": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Purchase shipping label for an order
         * @description Buys the cheapest available label via the configured LabelProvider and marks the order shipped.
         */
        post: operations["buyOrderLabel"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/orders/{order}/labels/preview": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Preview shipping rates without purchasing a label */
        post: operations["previewOrderLabel"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/stripe/connect": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Create Stripe Express Connect onboarding link */
        post: operations["createStripeConnectLink"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/stripe/status": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Get Stripe Connect account status + dashboard login link */
        get: operations["getStripeStatus"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/dashboard/metrics": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Seller dashboard metrics */
        get: operations["getSellerDashboardMetrics"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/balance": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Seller ledger balance */
        get: operations["getSellerBalance"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/payouts": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List payouts for a store (paginated) */
        get: operations["listStorePayouts"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/payouts/{payout}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Get a single payout with bundled ledger entries */
        get: operations["getStorePayout"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/me/notifications": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List notifications for the authenticated user */
        get: {
            parameters: {
                query?: {
                    /** @description Filter by notification category. `system` returns rows whose category is NULL (legacy rows and unknown class types). Omit to return all categories. */
                    category?: "orders" | "shipping" | "payouts" | "system" | "promotions" | "price_drops" | "account";
                    filter?: "all" | "unread";
                    per_page?: number;
                    page?: number;
                };
                header?: never;
                path?: never;
                cookie?: never;
            };
            requestBody?: never;
            responses: {
                /** @description Paginated list of notifications */
                200: {
                    headers: {
                        [name: string]: unknown;
                    };
                    content: {
                        "application/json": components["schemas"]["NotificationInboxList"];
                    };
                };
            };
        };
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/me/notifications/unread-count": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Unread count for the authenticated user */
        get: {
            parameters: {
                query?: never;
                header?: never;
                path?: never;
                cookie?: never;
            };
            requestBody?: never;
            responses: {
                /** @description Unread count */
                200: {
                    headers: {
                        [name: string]: unknown;
                    };
                    content: {
                        "application/json": {
                            data: components["schemas"]["NotificationUnreadCount"];
                        };
                    };
                };
            };
        };
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/me/notifications/{id}/read": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        /** Mark a notification as read */
        patch: {
            parameters: {
                query?: never;
                header?: never;
                path: {
                    id: string;
                };
                cookie?: never;
            };
            requestBody?: never;
            responses: {
                /** @description No content */
                204: {
                    headers: {
                        [name: string]: unknown;
                    };
                    content?: never;
                };
                /** @description Not found (or not owned) */
                404: {
                    headers: {
                        [name: string]: unknown;
                    };
                    content?: never;
                };
            };
        };
        trace?: never;
    };
    "/v1/me/notifications/mark-all-read": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Mark all unread notifications as read */
        post: {
            parameters: {
                query?: never;
                header?: never;
                path?: never;
                cookie?: never;
            };
            requestBody?: never;
            responses: {
                /** @description Bulk update result */
                200: {
                    headers: {
                        [name: string]: unknown;
                    };
                    content: {
                        "application/json": {
                            data: {
                                updated: number;
                            };
                        };
                    };
                };
            };
        };
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/me/notification-preferences": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List notification preferences for the authenticated user */
        get: {
            parameters: {
                query?: never;
                header?: never;
                path?: never;
                cookie?: never;
            };
            requestBody?: never;
            responses: {
                /** @description Preferences list */
                200: {
                    headers: {
                        [name: string]: unknown;
                    };
                    content: {
                        "application/json": {
                            data: components["schemas"]["NotificationPreference"][];
                        };
                    };
                };
            };
        };
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        /** Update notification preferences */
        patch: {
            parameters: {
                query?: never;
                header?: never;
                path?: never;
                cookie?: never;
            };
            requestBody: {
                content: {
                    "application/json": components["schemas"]["NotificationPreferencesUpdateRequest"];
                };
            };
            responses: {
                /** @description Updated preferences list */
                200: {
                    headers: {
                        [name: string]: unknown;
                    };
                    content: {
                        "application/json": {
                            data: components["schemas"]["NotificationPreference"][];
                        };
                    };
                };
                /** @description Validation error (e.g. disabling a transactional category) */
                422: {
                    headers: {
                        [name: string]: unknown;
                    };
                    content?: never;
                };
            };
        };
        trace?: never;
    };
    "/v1/admin/dashboard/metrics": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Platform-wide dashboard metrics
         * @description Aggregate counts across every store. Admin only.
         */
        get: operations["adminDashboardMetrics"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/stores": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List every store on the platform
         * @description Paginated cross-tenant list with item counts. Admin only.
         */
        get: operations["adminListStores"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/stores/{store}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Get store detail (admin view) with counters and recent activity */
        get: operations["adminShowStore"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/stores/{store}/verify": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Verify a store (move from pending into the marketplace) */
        post: operations["adminVerifyStore"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/stores/{store}/suspend": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Suspend a store — cancels open orders, refunds them, hides from marketplace */
        post: operations["adminSuspendStore"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/stores/{store}/unsuspend": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Unsuspend a store — does NOT auto-restore is_verified */
        post: operations["adminUnsuspendStore"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/orders": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List every order on the platform
         * @description Paginated cross-tenant order list with buyer + store. Admin only.
         */
        get: operations["adminListOrders"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/orders/{order}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Get order detail (admin view) */
        get: operations["adminShowOrder"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/orders/{order}/refund": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Issue a partial or full refund */
        post: operations["adminOrderRefund"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/orders/{order}/force-cancel": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Force-cancel an order (full refund issued) */
        post: operations["adminOrderForceCancel"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/orders/{order}/reverse-transfer": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Reverse the Stripe Transfer for this order (standalone, outside dispute flow) */
        post: operations["adminOrderReverseTransfer"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/disputes": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List disputes */
        get: operations["adminListDisputes"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/disputes/{purchase}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Get dispute detail */
        get: operations["adminShowDispute"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/disputes/{purchase}/adjudicate": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Adjudicate a dispute */
        post: operations["adminAdjudicateDispute"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/disputes/{purchase}/submit-evidence": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Submit evidence to Stripe (freezes orders) */
        post: operations["adminSubmitEvidence"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/disputes/{purchase}/retry-reversal/{order}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Retry a Stripe Transfer reversal that previously failed */
        post: operations["adminRetryReversal"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/activity": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Read-only activity log of admin-driven actions */
        get: operations["adminListActivity"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/messages/bulk-delete": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Soft-delete up to 100 messages in a single call (admin moderation) */
        post: operations["adminBulkDeleteMessages"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/seller/reviews": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Visible reviews for the selected seller store (20 per page)
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         */
        get: operations["listStoreSellerReviews"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/seller/rating-summary": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Rating aggregate for the selected seller store
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         */
        get: operations["getStoreSellerRatingSummary"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/returns": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Returns for the selected seller store
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         */
        get: operations["listStoreReturns"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/threads": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Seller inbox for the selected store (excludes personal buyer threads)
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         */
        get: operations["listStoreThreads"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/returns/{return}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Return detail in the selected store
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         */
        get: operations["getStoreReturn"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/returns/{return}/approve": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Seller approves a return; issues an EasyPost return label and transitions to awaiting_shipment.
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         *     On success the response state is `awaiting_shipment` with the EasyPost label artifacts populated
         *     (`tracker_id`, `tracking_number`, `tracking_url`, `shipping_label_url`, `carrier`). If EasyPost
         *     label issuance fails, the return remains in state `approved` with `easypost_label_error` set; the
         *     seller can recover via `POST /v1/returns/{return}/retry-label`. Refund is deferred to the
         *     `mark-received` transition (manual seller action or carrier-delivered webhook).
         */
        post: operations["approveStoreReturn"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/returns/{return}/reject": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Seller declines a return
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         */
        post: operations["rejectStoreReturn"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/returns/{return}/mark-received": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Seller manually marks the return as received (e.g., carrier event missed)
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         *     Transitions the return through `received` → `refunded` → `closed`, issuing the deferred Stripe
         *     refund. Allowed from `awaiting_shipment` or `in_transit` only.
         */
        post: operations["markStoreReturnReceived"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/returns/{return}/retry-label": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Seller retries return label issuance after a prior EasyPost failure
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         *     Re-issues the EasyPost return label when a previous attempt left the return in `approved` state
         *     with `easypost_label_error` populated. On success the return transitions to `awaiting_shipment`
         *     with fresh label artifacts; on failure the return stays in `approved` with the new error message.
         */
        post: operations["retryStoreReturnLabel"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/returns/{return}/seller-close-without-refund": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Seller closes a return without refunding the buyer
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         *     Allowed from `approved`, `awaiting_shipment`, `in_transit`. NOT allowed from `received` or later
         *     (the package has arrived; the buyer is owed the refund). Reason text is required and visible to
         *     the buyer.
         */
        post: operations["closeStoreReturnWithoutRefund"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/orders/{order}/returns/proactive": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Seller initiates a proactive refund (keep-it or ship-back)
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged. Every item_ids entry must belong to the selected order.
         *     Creates a seller-initiated return on a delivered order without requiring a buyer request.
         *     `mode: 'keep-it'` issues the Stripe refund immediately and closes the return — no physical shipment.
         *     `mode: 'ship-back'` issues an EasyPost return label (seller pays) and follows the
         *     `awaiting_shipment → in_transit → received → refunded → closed` cascade.
         */
        post: operations["createStoreProactiveReturn"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/orders/{order}/messages": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List messages on an order's thread
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged. attachment_ids must belong to this order and current user. The after cursor remains thread-scoped (422 if invalid).
         */
        get: operations["listStoreOrderMessages"];
        put?: never;
        /**
         * Post a message to an order's thread
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged. attachment_ids must belong to this order and current user. The after cursor remains thread-scoped (422 if invalid).
         */
        post: operations["postStoreOrderMessage"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/orders/{order}/messages/attachments": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Stage an image attachment for a subsequent message POST
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         */
        post: operations["uploadStoreMessageAttachment"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/messages/{message}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        /**
         * Soft-delete a message (author or admin)
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         */
        delete: operations["deleteStoreMessage"];
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/seller/reviews/{review}/reports": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Report a review belonging to the selected seller store
         * @description Requires store.admin for the selected store (owner-only in v1, with platform-admin override). Child IDs must belong to this store; mismatches return 404. Legacy routes remain unchanged.
         */
        post: operations["createStoreReviewReport"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/orders/{order}/messages": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List messages on an order's thread */
        get: operations["listOrderMessages"];
        put?: never;
        /** Post a message to an order's thread */
        post: operations["postOrderMessage"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/messages/{message}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        /** Soft-delete a message (author or admin) */
        delete: operations["deleteMessage"];
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/orders/{order}/messages/attachments": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Stage an image attachment for a subsequent message POST */
        post: operations["uploadMessageAttachment"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/me/threads": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** My participating message threads (buyer + seller union) */
        get: operations["listMyThreads"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/orders/{order}/returns": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Buyer files a return on a delivered order */
        post: operations["createReturn"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/me/returns": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List the buyer's returns across all their orders */
        get: operations["listMyReturns"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/returns/{return}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Get a single return (buyer, seller, or admin viewable) */
        get: operations["getReturn"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/returns/{return}/cancel": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Buyer cancels a return they initiated (only while in requested state) */
        post: operations["cancelReturn"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/seller/returns": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List returns across all stores owned by the authenticated seller */
        get: operations["listSellerReturns"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/returns/{return}/approve": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Seller approves a return; issues an EasyPost return label and transitions to awaiting_shipment.
         * @description On success the response state is `awaiting_shipment` with the EasyPost label artifacts populated
         *     (`tracker_id`, `tracking_number`, `tracking_url`, `shipping_label_url`, `carrier`). If EasyPost
         *     label issuance fails, the return remains in state `approved` with `easypost_label_error` set; the
         *     seller can recover via `POST /v1/returns/{return}/retry-label`. Refund is deferred to the
         *     `mark-received` transition (manual seller action or carrier-delivered webhook).
         */
        post: operations["approveReturn"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/returns/{return}/reject": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Seller declines a return */
        post: operations["rejectReturn"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/returns/{return}/mark-received": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Seller manually marks the return as received (e.g., carrier event missed)
         * @description Transitions the return through `received` → `refunded` → `closed`, issuing the deferred Stripe
         *     refund. Allowed from `awaiting_shipment` or `in_transit` only.
         */
        post: operations["markReturnReceived"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/returns/{return}/retry-label": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Seller retries return label issuance after a prior EasyPost failure
         * @description Re-issues the EasyPost return label when a previous attempt left the return in `approved` state
         *     with `easypost_label_error` populated. On success the return transitions to `awaiting_shipment`
         *     with fresh label artifacts; on failure the return stays in `approved` with the new error message.
         */
        post: operations["retryReturnLabel"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/seller/orders/{order}/returns/proactive": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Seller initiates a proactive refund (keep-it or ship-back)
         * @description Creates a seller-initiated return on a delivered order without requiring a buyer request.
         *     `mode: 'keep-it'` issues the Stripe refund immediately and closes the return — no physical shipment.
         *     `mode: 'ship-back'` issues an EasyPost return label (seller pays) and follows the
         *     `awaiting_shipment → in_transit → received → refunded → closed` cascade.
         */
        post: operations["createProactiveReturn"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/returns/{return}/escalate": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Buyer escalates a return to admin
         * @description Allowed from `approved`, `awaiting_shipment`, `in_transit`, `received`. NOT allowed from
         *     `requested`, `rejected`, `cancelled`, `closed`, `refunded`. At most one escalation per return.
         */
        post: operations["escalateReturn"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/returns/{return}/seller-close-without-refund": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Seller closes a return without refunding the buyer
         * @description Allowed from `approved`, `awaiting_shipment`, `in_transit`. NOT allowed from `received` or later
         *     (the package has arrived; the buyer is owed the refund). Reason text is required and visible to
         *     the buyer.
         */
        post: operations["sellerCloseReturnWithoutRefund"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/returns": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Admin queue of escalated returns */
        get: operations["listAdminReturns"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/returns/{return}/resolve": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Admin resolves a return escalation
         * @description Closes the escalation and optionally forces a state transition on the underlying return.
         *     `action: 'force_refund'` issues the Stripe refund (honouring any persisted amount override or
         *     shipping-refund flag) and closes the return. `action: 'force_close_no_refund'` closes the return
         *     without refunding. `action: 'no_action'` resolves the escalation as a no-op (e.g., admin sided
         *     with the seller without changing the return's trajectory). All three write a
         *     `return.escalation_resolved` row to the activity log.
         */
        post: operations["resolveAdminReturn"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/stores/{store}/ledger": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Paginated ledger entries for a store (admin view) */
        get: operations["adminListStoreLedger"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/stores/{store}/ledger-adjustments": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Record a manual ledger adjustment for a store
         * @description Writes a credit or debit ledger entry against the store's balance. The
         *     admin user is recorded on the resulting `ManualAdjustment` row for the
         *     audit trail.
         */
        post: operations["adminPostStoreLedgerAdjustment"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/financials/balances": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Marketplace pending/available totals with per-store breakdown */
        get: operations["adminFinancialsBalances"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/financials/payouts": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Paginated cross-store payouts (defaults to state=failed) */
        get: operations["adminFinancialsListPayouts"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/payouts/{payout}/retry": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Retry a failed payout (resets state to scheduled and runs) */
        post: operations["adminRetryPayout"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/payouts/{payout}/void": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Void a payout — unbundles its ledger entries back to the pool
         * @description Only payouts in the `scheduled` or `failed` state can be voided.
         *     In-flight or succeeded transfers must be reversed via the Stripe Dashboard.
         */
        post: operations["adminVoidPayout"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/ledger": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Paginated ledger entries for the authenticated store owner */
        get: operations["listStoreLedger"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/statements/export.csv": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Download the store's ledger as a CSV statement
         * @description Streaming CSV export of ledger entries within the date range. If `from`
         *     and `to` are omitted, defaults to the current biweekly payout cycle
         *     window. The response is a UTF-8 CSV with a BOM so Excel auto-detects
         *     the encoding. The browser is instructed to download via
         *     `Content-Disposition: attachment`.
         */
        get: operations["exportStoreStatementsCsv"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/order-items/{order_item}/reviews": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Buyer creates a review for a delivered order_item */
        post: operations["createReview"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/order-items/{order_item}/review-attachments": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Buyer pre-uploads a photo for an upcoming review on a delivered order_item */
        post: operations["uploadReviewAttachment"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/reviews/{review}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        /** Buyer edits own review within the 30-day window */
        patch: operations["updateReview"];
        trace?: never;
    };
    "/v1/me/reviews": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List the authenticated user's own reviews */
        get: operations["listMyReviews"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/reviews": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Public paginated reviews for a store */
        get: operations["listStoreReviews"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/rating-summary": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Lightweight rating aggregate for a store (used by item badges + store detail) */
        get: operations["getStoreRatingSummary"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/seller/reviews": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Reviews on the authenticated seller's store (read-only for v1) */
        get: operations["listSellerReviews"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/reviews/{review}/reports": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Any logged-in user reports a review for moderation */
        post: operations["createReviewReport"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/review-reports": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Admin moderation queue for review reports */
        get: operations["listAdminReviewReports"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/review-reports/{report}/resolve": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Admin resolves a review report (keep or hide) */
        post: operations["resolveAdminReviewReport"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/reviews/{review}/hide": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Admin hides a review directly (without going through the report queue) */
        post: operations["hideAdminReview"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/reviews/{review}/restore": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Admin restores a hidden review back to visible (silent — no buyer notification) */
        post: operations["restoreAdminReview"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/reviews/bulk-hide": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Hide up to 100 reviews in a single call with partial-success semantics
         * @description Hides a batch of reviews with a single shared justification. Reviews that
         *     cannot be hidden (already hidden, missing, etc.) are skipped silently and
         *     reported in the `skipped` array; the request as a whole still returns 200.
         *     Each successful hide emits the same activity log + buyer notification as
         *     a single-review hide.
         */
        post: operations["adminBulkHideReviews"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/admin/stores/{store}/reviews": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Admin paginated list of reviews for a specific store (includes hidden) */
        get: operations["listAdminStoreReviews"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/kiosk/members/lookup": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Look up a member by phone (minimal PII) */
        get: operations["kioskMemberLookup"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/kiosk/buys": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Submit a completed kiosk check-in */
        post: operations["kioskCreateBuy"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/kiosk/buys/{buy}/status": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Read the current status of a buy */
        get: operations["kioskBuyStatus"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/checkin/{token}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Store branding for a check-in link
         * @description Public. Resolved from an opaque store link token. Cacheable.
         */
        get: operations["checkinBranding"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/checkin/{token}/requests": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Submit a remote check-in
         * @description Public. Creates a remote_check_in buy. Optional Sanctum bearer attaches the buy to a logged-in user; an absent/invalid bearer is ignored (never 401). Turnstile-verified.
         */
        post: operations["checkinSubmit"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/checkin/status/{statusToken}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Read a check-in's status by its signed status token
         * @description Public. Queue position + ETA only in `live` visibility mode.
         */
        get: operations["checkinStatus"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/pos/queue": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List the store's live work queue (all non-terminal buys)
         * @description Every non-terminal buy for the device's store, across all sources (QR check-in, kiosk, appointment) and stages (queued → quoted), ordered by arrival (created_at). Pass `updated_after` to fetch only rows changed since the client's high-water mark — the polling delta. The cursor is a filter, not the sort key; advance the watermark to the maximum `updated_at` seen across pages.
         */
        get: operations["posQueue"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/pos/checkins": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List the store's open remote check-ins */
        get: operations["posListCheckins"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/pos/checkins/lookup": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Resolve a single open check-in by phone or code */
        get: operations["posLookupCheckin"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/pos/checkins/{buy}/labels-printed": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** Mark container labels as printed (advisory, idempotent) */
        post: operations["posMarkLabelsPrinted"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/pos/checkins/{buy}/convert": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Convert a remote check-in to a queued buy (in-store capture)
         * @description remote_check_in → queued. Captures DL + terms + signature and grants loyalty.
         */
        post: operations["posConvertCheckin"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/pos/buys/{buy}/complete": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Set a terminal buy status and fire the completion SMS
         * @description Idempotent on an already-terminal buy. SMS gated on opt_txn.
         */
        post: operations["posCompleteBuy"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/pos/buys/{buy}/items": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List a buy's intake items
         * @description Returns every intake item on the buy (photos with slot + order, the quote, the per-item outcome, and the listing-conversion state), ordered by `sort_order`. Not paginated. Store-scoped — a buy in another store 404s.
         */
        get: operations["posListBuyItems"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/pos/buys/{buy}/items/{item}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        /**
         * Upsert an intake item (idempotent on the client UUID)
         * @description Materialize-or-update an intake item under the buy (I1). `{item}` is a client-generated UUID PK — a first reference creates the row (`201`), a later reference updates it (`200`). The body carries quote-time listing metadata; setting either offer (`cash_offer` / `store_credit_offer`) on a still-`pending` item moves it to `quoted` and stamps `quoted_at`. A non-UUID `{item}` 404s before the lookup (never reaches the uuid column). Rejected with `409` once the buy is finalized.
         */
        put: operations["posUpsertBuyItem"];
        post?: never;
        /**
         * Remove a mis-sorted intake item
         * @description Soft-deletes an intake item before finalize (a mis-sorted entry). Any attached photos were already moved into the item's media and are cleaned up by the existing media lifecycle. Rejected with `409` once the buy is finalized.
         */
        delete: operations["posDeleteBuyItem"];
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/pos/buys/{buy}/items/{item}/resolve": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Set an intake item's per-item outcome
         * @description Records the per-item outcome (I2/I9). `outcome: accepted` stamps `resolved_at`; `outcome: declined` **requires** a `disposition` (`returned_to_customer` | `recycled`) and is rejected `422` without one (and `422` if a `disposition` is sent while accepting). A `category_id` is NOT required here — it is only gated at finalize (I15). Re-resolving an already-terminal item, or resolving on a finalized buy, 409s.
         */
        post: operations["posResolveBuyItem"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/pos/buys/{buy}/finalize": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Finalize a buy — roll-up, settlement totals, draft listings
         * @description The terminal step (I7/I10). Requires **every** item resolved, and every **accepted** item to carry `title`, `condition`, `category_id` and `listing_price` (the fields the marketplace `items` table requires to convert, B2/I15) — otherwise `422` naming the offending item ids.
         *
         *     **Roll-up rule (I7):** `customer_rejected: true` → buy `declined`; else ≥1 accepted item → `accepted`; else (items exist, none accepted) → `no_buy`. Records `cash_total` / `store_credit_total` as the server-side sum of accepted offers (I8, recorded — not executed), sets `finalized_at`, and fires the completion SMS once (gated on `opt_txn`, guarded by `completed_notified_at`). A draft marketplace `Item` is then created per accepted item by a **queued** `ConvertAcceptedBuyItem` job (I5) — so finalize returns before the drafts exist; a conversion failure stamps `conversion_failed_at` on the item for `intake:retry-conversions` and never blocks settlement (I12).
         *
         *     **Idempotent:** a second finalize on an already-finalized buy is a no-op (`200`, no re-transition, no second SMS, no duplicate drafts) and never 422s. Supersedes `POST /v1/pos/buys/{buy}/complete` for item-bearing buys.
         */
        post: operations["posFinalizeBuy"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/storefronts/resolve": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Resolve a custom hostname to a storefront
         * @description Maps an inbound `Host` header to the store slug that should serve it.
         *     Called by the web tier's middleware on every custom-domain request.
         *     Only verified domains belonging to a verified, unsuspended store
         *     resolve; everything else is a 404.
         */
        get: operations["resolveStorefrontDomain"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/storefronts/{slug}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get a store's public site shell
         * @description Theme, navigation, hours, contact details and SEO defaults for a
         *     store's website. 404s unless the site is published and the store is
         *     verified and unsuspended — except for the store owner and admins, who
         *     see drafts so the editor can preview.
         */
        get: operations["getStorefront"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/storefronts/{slug}/pages/{pageSlug}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get one page of a store's public site
         * @description Returns the page's ordered blocks, with the site shell in `meta.storefront`.
         */
        get: operations["getStorefrontPage"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/site": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * Get the store's site for editing
         * @description Returns the store's site with its pages and domains. On first call the
         *     site is provisioned with a landing page plus About Us / Hours /
         *     Directions, so the editor never opens onto a blank canvas.
         *     Requires store owner role.
         */
        get: operations["getStoreSite"];
        /**
         * Update the store's site
         * @description Partial update. `theme` is merged into the stored palette rather than
         *     replacing it. Setting `is_published` stamps or clears `published_at`.
         *     Requires store owner role.
         */
        put: operations["updateStoreSite"];
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/site/slug": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        /**
         * Change the storefront address
         * @description Sets `stores.slug`, the public address of the storefront
         *     (`/s/{slug}`). Rejects reserved words and slugs taken by any other
         *     store, including soft-deleted ones. Requires store owner role.
         */
        put: operations["updateStoreSlug"];
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/site/pages": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List the site's pages */
        get: operations["listStoreSitePages"];
        put?: never;
        /**
         * Add a page
         * @description Requires store owner role. A site may hold at most 20 pages.
         */
        post: operations["createStoreSitePage"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/site/pages/reorder": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        /**
         * Reorder the site's pages
         * @description Send every page id for the site exactly once; array index becomes the
         *     page's position. Partial lists are rejected.
         */
        put: operations["reorderStoreSitePages"];
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/site/pages/{page}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        /**
         * Update a page
         * @description Partial update. `blocks`, when present, replaces the whole ordered
         *     list. The landing page cannot be unpublished.
         */
        put: operations["updateStoreSitePage"];
        post?: never;
        /**
         * Delete a page
         * @description The landing page cannot be deleted.
         */
        delete: operations["deleteStoreSitePage"];
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/domains": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** List custom domains */
        get: operations["listStoreDomains"];
        put?: never;
        /**
         * Claim a custom domain
         * @description Records the claim and returns the DNS records the seller must create.
         *     The domain stays inert until `POST …/verify` finds the TXT record.
         */
        post: operations["createStoreDomain"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/domains/{domain}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        /**
         * Remove a custom domain
         * @description If the removed domain was primary, the next verified domain is promoted.
         */
        delete: operations["deleteStoreDomain"];
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/domains/{domain}/verify": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Re-check a domain's TXT record
         * @description Looks up `_alqove.<hostname>` and compares it to
         *     `alqove-site-verification=<token>`. Returns 200 when verified and 422
         *     when not — the payload is the refreshed domain either way, so the
         *     editor can show `last_check_error`.
         */
        post: operations["verifyStoreDomain"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/domains/{domain}/primary": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        /**
         * Make a domain the store's primary
         * @description Only a verified domain may be primary. Demotes the previous primary.
         */
        put: operations["makeStoreDomainPrimary"];
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/me/memberships": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List the authenticated user's active store memberships
         * @description The single source the frontend renders store switching, nav, and actions from — each entry carries the resolved capability list, never a role name.
         */
        get: operations["listMyMemberships"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/members": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List store roster
         * @description Requires the team.view capability. Fields are stripped by the viewer's capabilities server-side — contact fields require team.manage, pay fields require pay.view.
         */
        get: operations["listStoreMembers"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/members/{membership}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        /**
         * Terminate a member
         * @description Requires team.manage and the target must rank below the actor. The owner membership cannot be terminated. Emits MembershipTerminated.
         */
        delete: operations["terminateStoreMember"];
        options?: never;
        head?: never;
        /**
         * Update a member's role, default position, or reactivate
         * @description Requires team.manage. The target must rank strictly below the actor; a role may not be raised to or above the actor's rank; the owner membership is immutable; reactivating a terminated member (rehire) is owner-only.
         */
        patch: operations["updateStoreMember"];
        trace?: never;
    };
    "/v1/stores/{store}/members/{membership}/pay-rates": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List a member's pay-rate history
         * @description Requires pay.view (owner-only in the v1 preset matrix).
         */
        get: operations["listMemberPayRates"];
        put?: never;
        /**
         * Append a pay rate
         * @description Requires pay.manage. Append-only — never edits prior rows.
         */
        post: operations["createMemberPayRate"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/invitations": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List pending store invitations
         * @description Requires team.manage. Only pending (unaccepted, unrevoked, unexpired) invites.
         */
        get: operations["listStoreInvitations"];
        put?: never;
        /**
         * Invite someone to the store by email
         * @description Requires team.manage. The role must rank below the inviter (owner is never invitable). If a user with the email already exists the invite is bound to that account. Any prior pending invite for the same email is auto-revoked. Emails the recipient a one-time accept link.
         */
        post: operations["createStoreInvitation"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/invitations/{invitation}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        /**
         * Revoke a pending invitation
         * @description Requires team.manage.
         */
        delete: operations["revokeStoreInvitation"];
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/invitations/accept": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /**
         * Accept a store invitation
         * @description Authenticated and throttled. The token travels in the request body, never a URL path. A bound invite can only be accepted by the account it was bound to; an unbound invite requires the caller's email to match. Returns the newly created membership.
         */
        post: operations["acceptInvitation"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/positions": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /**
         * List schedulable positions
         * @description Requires an active membership (store.member) — every member's schedule view reads these.
         */
        get: operations["listStorePositions"];
        put?: never;
        /**
         * Create a schedulable position
         * @description Requires schedule.manage.
         */
        post: operations["createStorePosition"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/v1/stores/{store}/positions/{position}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        /**
         * Update a schedulable position
         * @description Requires schedule.manage.
         */
        patch: operations["updateStorePosition"];
        trace?: never;
    };
    "/stores/{store}/schedule/settings": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** schedule.view: read typed scheduling settings */
        get: operations["getScheduleSettings"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        /** settings.schedule: update; timezone/week changes forbidden after approved/exported payroll */
        patch: operations["updateScheduleSettings"];
        trace?: never;
    };
    "/stores/{store}/schedule/week": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** schedule.view: one week; drafts require schedule.view_drafts */
        get: operations["getScheduleWeek"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/my/schedule": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Real active membership only: own published shifts, no client-selected membership */
        get: operations["getMySchedule"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/schedule/shifts": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** schedule.manage: create an assigned or open draft shift */
        post: operations["createScheduleShift"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/schedule/shifts/{shift}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        /** schedule.manage: exact revision required; soft delete */
        delete: operations["deleteScheduleShift"];
        options?: never;
        head?: never;
        /** schedule.manage: exact revision required; edit clears shift publication */
        patch: operations["updateScheduleShift"];
        trace?: never;
    };
    "/stores/{store}/schedule/publish": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** schedule.publish: atomic revalidation, publish stamps and publication row */
        post: operations["publishScheduleWeek"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/schedule/unpublish": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** schedule.publish: clear week stamps, advance revisions, remove publication row */
        post: operations["unpublishScheduleWeek"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/schedule/copy-week": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** schedule.manage: local-wall DST copy; preview reports conflicts, commit rejects atomically */
        post: operations["copyScheduleWeek"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/my/clock": {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        /**
         * Read authenticated active membership clock state
         * @description Full history determines state without midnight reset. Response punches contain today's store-local punches plus active clock-in/break-start, at most 500. Requires a real active membership; synthetic platform-admin access is not accepted.
         */
        get: operations["getMyClock"];
        put?: never;
        /**
         * Apply a server-timed clock or break intent
         * @description Requires state_revision from GET /my/clock plus a durable Idempotency-Key.
         *     The extra state_revision precondition prevents stale toggle requests using a new key.
         *     Same key and same validated request replay the immutable original response, even after manager edits.
         *     Refetch GET after every mutation/replay. Same key with different request returns 409.
         *     Clock-in requires an assigned published shift inside restrictive configured windows.
         *     Clock-out while on break is rejected; no automatic break closure. Late or stranded clock-out needs manager correction.
         *     Break start requires paid/unpaid; break end inherits it and rejects an explicitly mismatched type.
         *     Server captures UTC time inside Store then membership locks. Opposite actions within the same second return 409.
         *     Payroll recalculation, punch, audit and replay snapshot commit atomically. Approved/exported periods reject mutations.
         */
        post: operations["actOnMyClock"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/punches": {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        /**
         * List one membership's punches (punches.manage)
         * @description from/to are inclusive store-local calendar dates; difference may not exceed 31 days. Soft-deleted punches are omitted. Sorted by punched_at then id.
         */
        get: operations["listTimePunches"];
        put?: never;
        /**
         * Add a noted manager correction (punches.manage)
         * @description Requires note; server records actor. Membership must belong to store. Optional shift must be assigned to that membership and belong to store. Future instants rejected. Full chronological lifecycle is validated atomically; an open final session is allowed but payroll will refuse stranded approval/export. Manager corrections to historical terminated memberships remain possible. Duplicate type/second including deleted tombstones returns 409.
         */
        post: operations["createTimePunch"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/punches/{punch}": {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                punch: string;
            };
            cookie?: never;
        };
        get?: never;
        put?: never;
        post?: never;
        /**
         * Soft-delete a punch with revision and note (punches.manage)
         * @description Retains punch tombstone, deleting actor and before/after audit. Orphaning a paired break or clock-out is rejected. Reopening a session across later frozen payroll is also rejected. Pending payroll recalculates in the transaction.
         */
        delete: operations["deleteTimePunch"];
        options?: never;
        head?: never;
        /**
         * Correct a punch with revision and note (punches.manage)
         * @description Revision changes on every edit, including same-second edits. Membership cannot be changed. Before/after values and manager attribution are audited. Both original and resulting session ranges are checked against frozen payroll, including cross-week sessions. Omitted shift preserves its historical association even after unassignment/deletion; explicit null clears it.
         */
        patch: operations["updateTimePunch"];
        trace?: never;
    };
    "/stores/{store}/timesheets": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** timesheets.approve; normalized week list with monetary fields omitted without pay.view */
        get: operations["listPayrollTimesheets"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/timesheets/recalculate": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** timesheets.approve; rebuild pending membership weeks only */
        post: operations["recalculatePayrollTimesheets"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/timesheets/{timesheet}": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** timesheets.approve; tenant-scoped detail */
        get: operations["getPayrollTimesheet"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/timesheets/{timesheet}/approve": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** timesheets.approve; recalculate and guard pending sheet, then freeze approval */
        post: operations["approvePayrollTimesheet"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/timesheets/{timesheet}/unlock": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        get?: never;
        put?: never;
        /** timesheets.approve; only approved to pending, exported immutable */
        post: operations["unlockPayrollTimesheet"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/my/timesheets": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** Real active membership required; own most recent 52 sheets including own pay; client member IDs ignored */
        get: operations["getMyPayrollTimesheets"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/payroll/exports": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** payroll.export; most recent 100 immutable export summaries */
        get: operations["listPayrollExports"];
        put?: never;
        /** payroll.export; immutable snapshot replay precedes mutable payroll reads. All worked weeks must be approved; new keys cannot re-export an exported period. */
        post: operations["createPayrollExport"];
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/payroll/exports/{export}/download": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** payroll.export; CSV rebuilt exclusively from immutable scalar snapshot with SHA-256 verification */
        get: operations["downloadPayrollExport"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        patch?: never;
        trace?: never;
    };
    "/stores/{store}/payroll/rules": {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        /** schedule.view; non-private typed rule history and FLSA fallback */
        get: operations["listPayrollOvertimeRules"];
        put?: never;
        post?: never;
        delete?: never;
        options?: never;
        head?: never;
        /** settings.schedule; effective normalized week, rejects locked history impact, recalculates pending sheets */
        patch: operations["setPayrollOvertimeRules"];
        trace?: never;
    };
}
export type webhooks = Record<string, never>;
export interface components {
    schemas: {
        PayrollWeekRequest: {
            /** Format: date */
            week_start: string;
        };
        PayrollApprovalRequest: {
            /** @default false */
            acknowledge_oversized_sessions: boolean;
        };
        PayrollExportRequest: {
            week_starts: string[];
            /** @default false */
            acknowledge_oversized_sessions: boolean;
        };
        PayrollTimesheet: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_membership_id: string;
            member_name: string;
            /** Format: date */
            week_start_date: string;
            scheduled_minutes: number;
            regular_minutes: number;
            overtime_minutes: number;
            doubletime_minutes: number;
            unpaid_break_minutes: number;
            /** @description Omitted for managers without pay.view; own /my read includes own pay. Null means missing effective rates. */
            total_pay_cents?: number | null;
            /** @enum {string} */
            status: "pending" | "approved" | "exported";
            calculation_metadata: components["schemas"]["PayrollCalculationMetadata"];
        };
        PayrollCalculationMetadata: {
            /** @enum {integer} */
            schema_version?: 1;
            timezone?: string;
            /** Format: date-time */
            starts_at?: string;
            /** Format: date-time */
            ends_at?: string;
            daily_breakdown?: {
                [key: string]: {
                    regular_minutes?: number;
                    overtime_minutes?: number;
                    doubletime_minutes?: number;
                    total_minutes?: number;
                    consecutive_day?: number;
                };
            };
            stranded_clock_ins?: {
                /** Format: uuid */
                punch_id?: string;
                /** Format: date */
                date?: string;
            }[];
            open_sessions?: {
                /** Format: uuid */
                punch_id?: string;
            }[];
            oversized_sessions?: {
                /** Format: uuid */
                clock_in_punch_id?: string;
                /** Format: uuid */
                clock_out_punch_id?: string;
                minutes?: number;
            }[];
            punches?: {
                /** Format: uuid */
                id?: string;
                /** @enum {string} */
                type?: "clock_in" | "clock_out" | "break_start" | "break_end";
                /** @description Unix UTC seconds */
                ts?: number;
                /** @enum {string|null} */
                break_type?: "paid" | "unpaid" | null;
            }[];
        };
        PayrollExport: {
            /** Format: uuid */
            id: string;
            week_starts: string[];
            row_count: number;
            /** @description Sum of rounded integer minute components; displayed CSV totals derive from two-decimal component hours. */
            total_minutes: number;
            total_pay_cents: number | null;
            /** @enum {string} */
            rounding_mode: "none" | "nearest" | "up" | "down";
            rounding_increment_minutes: number;
            /** Format: date */
            period_start: string;
            /** Format: date */
            period_end: string;
            filename: string;
            csv_hash: string;
            /** Format: date-time */
            created_at: string;
            /**
             * @description Pay is earned pay from actual minute buckets and historical rates, NOT recomputed using export display-hour rounding (BK behavior).
             * @enum {string}
             */
            pay_basis: "actual_minutes";
            /** @description Missing rates produce blank CSV pay and unknown/null overall pay, never partial or guessed totals. */
            warnings: "missing_pay_rates"[];
        };
        PayrollOvertimeRules: {
            /** @enum {integer} */
            schema_version: 1;
            weekly_threshold_minutes?: number | null;
            weekly_countable_minutes_per_day_cap?: number | null;
            overtime_multiplier?: number;
            doubletime_multiplier?: number;
            daily_rules?: components["schemas"]["PayrollDailyRule"][];
            consecutive_day_rules?: components["schemas"]["PayrollConsecutiveRule"][];
        };
        PayrollDailyRule: {
            threshold_minutes: number;
            /** @enum {number} */
            multiplier: 1.5 | 2;
        };
        PayrollConsecutiveRule: {
            day_number: number;
            threshold_minutes: number;
            /** @enum {number} */
            multiplier: 1.5 | 2;
        };
        PayrollOvertimeRuleInput: {
            /**
             * Format: date
             * @description Normalized work-week label, not an arbitrary intraweek date.
             */
            effective_start_date: string;
            /** @enum {string} */
            preset_key: "US-FLSA" | "US-CA" | "CA-ON" | "custom";
            /** @description Required for custom preset. Absolute thresholds only. */
            rules?: components["schemas"]["PayrollOvertimeRules"];
        };
        PayrollOvertimeRule: {
            /** Format: uuid */
            id?: string;
            /** Format: uuid */
            store_id?: string;
            /** Format: date */
            effective_start_date?: string;
            preset_key?: string;
            /** @enum {integer} */
            schema_version?: 1;
            rules?: components["schemas"]["PayrollOvertimeRules"];
            /** Format: date-time */
            created_at?: string;
            /** Format: date-time */
            updated_at?: string;
        };
        PayrollOvertimeRuleHistory: {
            default?: {
                /** @enum {string} */
                preset_key?: "US-FLSA";
                rules?: components["schemas"]["PayrollOvertimeRules"];
            };
            history?: components["schemas"]["PayrollOvertimeRule"][];
        };
        /** @enum {string} */
        PunchType: "clock_in" | "clock_out" | "break_start" | "break_end";
        /** @enum {string|null} */
        PunchBreakType: "paid" | "unpaid" | null;
        TimePunch: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            /** Format: uuid */
            store_membership_id: string;
            /** Format: uuid */
            shift_id: string | null;
            punch_type: components["schemas"]["PunchType"];
            /**
             * Format: date-time
             * @description UTC instant truncated to whole seconds
             */
            punched_at: string;
            break_type: components["schemas"]["PunchBreakType"];
            note: string | null;
            /**
             * Format: uuid
             * @description Opaque optimistic concurrency token
             */
            revision: string;
            /** @description True when originally entered by a manager; later edits are independently audited */
            is_manual: boolean;
        };
        TimePunchEnvelope: {
            data: components["schemas"]["TimePunch"];
        };
        ClockState: {
            /** @enum {string} */
            status: "clocked_out" | "clocked_in" | "on_break";
            /** @description Pass unchanged on next intent; empty when no current punch history */
            state_revision: string;
            punches: components["schemas"]["TimePunch"][];
            /** @description Current clock-window/lifecycle actions; frozen payroll and concurrent changes can still reject submission */
            allowed_actions: ("clock" | "break")[];
            /** Format: date-time */
            server_time: string;
        };
        ClockEnvelope: {
            data: components["schemas"]["ClockState"];
        };
        ClockIntent: {
            /** @enum {string} */
            action: "clock" | "break";
            state_revision: string;
            break_type?: components["schemas"]["PunchBreakType"];
        };
        CreateTimePunch: {
            /** Format: uuid */
            store_membership_id: string;
            /** Format: uuid */
            shift_id?: string | null;
            punch_type: components["schemas"]["PunchType"];
            /**
             * Format: date-time
             * @description Explicit offset required; cannot be in the future
             */
            punched_at: string;
            break_type?: components["schemas"]["PunchBreakType"];
            note: string;
        };
        UpdateTimePunch: {
            /** Format: uuid */
            revision: string;
            note: string;
            /** Format: uuid */
            shift_id?: string | null;
            punch_type?: components["schemas"]["PunchType"];
            /** Format: date-time */
            punched_at?: string;
            break_type?: components["schemas"]["PunchBreakType"];
        };
        DeleteTimePunch: {
            /** Format: uuid */
            revision: string;
            note: string;
        };
        ScheduleSettings: {
            /**
             * @description IANA timezone
             * @default America/Los_Angeles
             */
            timezone: string;
            /**
             * @default mon
             * @enum {string}
             */
            work_week_start_day: "sun" | "mon" | "tue" | "wed" | "thu" | "fri" | "sat";
            /** @default 00:00 */
            work_week_start_time: string;
            /**
             * @default none
             * @enum {string}
             */
            payroll_rounding_mode: "none" | "nearest" | "up" | "down";
            /** @default 1 */
            payroll_rounding_increment_minutes: number;
            /** @default 0 */
            clock_in_early_minutes: number;
            /** @default 0 */
            clock_in_late_minutes: number;
            /** @default 0 */
            clock_out_late_minutes: number;
        };
        UpdateScheduleSettings: {
            /**
             * @description IANA timezone
             * @default America/Los_Angeles
             */
            timezone: string;
            /**
             * @default mon
             * @enum {string}
             */
            work_week_start_day: "sun" | "mon" | "tue" | "wed" | "thu" | "fri" | "sat";
            /** @default 00:00 */
            work_week_start_time: string;
            /**
             * @default none
             * @enum {string}
             */
            payroll_rounding_mode: "none" | "nearest" | "up" | "down";
            /** @default 1 */
            payroll_rounding_increment_minutes: number;
            /** @default 0 */
            clock_in_early_minutes: number;
            /** @default 0 */
            clock_in_late_minutes: number;
            /** @default 0 */
            clock_out_late_minutes: number;
        };
        Shift: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            /** Format: uuid */
            store_membership_id: string | null;
            member_name: string | null;
            /** Format: uuid */
            position_id: string | null;
            position_name: string | null;
            /** Format: date-time */
            starts_at: string;
            /** Format: date-time */
            ends_at: string;
            notes: string | null;
            /** Format: date-time */
            published_at: string | null;
            /** @description Opaque exact UTC updated_at token with SIX fractional digits. Preserve unchanged; edits, publish and unpublish advance it. */
            revision: string;
        };
        CreateShift: {
            /** Format: uuid */
            store_membership_id?: string | null;
            /** Format: uuid */
            position_id?: string | null;
            /** Format: date-time */
            starts_at: string;
            /** Format: date-time */
            ends_at: string;
            notes?: string | null;
        };
        UpdateShift: {
            /** Format: uuid */
            store_membership_id?: string | null;
            /** Format: uuid */
            position_id?: string | null;
            /** Format: date-time */
            starts_at?: string;
            /** Format: date-time */
            ends_at?: string;
            notes?: string | null;
            /** @description Opaque exact UTC updated_at token with SIX fractional digits. Preserve unchanged; edits, publish and unpublish advance it. */
            revision: string;
        };
        DeleteShift: {
            /** @description Opaque exact UTC updated_at token with SIX fractional digits. Preserve unchanged; edits, publish and unpublish advance it. */
            revision: string;
        };
        ScheduleWeekSelection: {
            /** Format: date */
            week_start: string;
        };
        SchedulePublication: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            /** Format: date */
            week_start: string;
            /** @description Shift count at last publication, NOT the current published count after draft edits. */
            shift_count: number;
            /** Format: date-time */
            published_at: string;
            /** Format: uuid */
            published_by: string | null;
            /** Format: date-time */
            created_at?: string;
            /** Format: date-time */
            updated_at?: string;
        };
        ScheduleWeek: {
            /** Format: date */
            week_start: string;
            /** Format: date-time */
            starts_at: string;
            /** Format: date-time */
            ends_at: string;
            timezone: string;
            shifts: components["schemas"]["Shift"][];
            publication: components["schemas"]["SchedulePublication"] | null;
        };
        CopyScheduleWeek: {
            /** Format: date */
            source_week_start: string;
            /** Format: date */
            target_week_start: string;
            /** @description REQUIRED. True never persists shifts; false explicitly commits. */
            preview: boolean;
        };
        CopyShiftCandidate: {
            /** Format: uuid */
            id: string | null;
            /** Format: uuid */
            store_id: string;
            /** Format: uuid */
            store_membership_id: string | null;
            member_name: string | null;
            /** Format: uuid */
            position_id: string | null;
            position_name: string | null;
            /** Format: date-time */
            starts_at: string;
            /** Format: date-time */
            ends_at: string;
            notes: string | null;
            /** Format: date-time */
            published_at: string | null;
            revision: string | null;
        };
        CopyScheduleWeekResult: {
            /** Format: date */
            source_week_start: string;
            /** Format: date */
            target_week_start: string;
            preview: boolean;
            shift_count: number;
            copied: number;
            conflict_count: number;
            conflicts: {
                /** Format: uuid */
                source_shift_id: string;
                message: string;
            }[];
            shifts: components["schemas"]["CopyShiftCandidate"][];
        };
        ScheduleDeleted: {
            /** @enum {boolean} */
            deleted: true;
        };
        /**
         * @description A store-scoped authorization capability. Endpoints check these, never role names.
         * @enum {string}
         */
        StoreCapability: "store.admin" | "team.view" | "team.manage" | "pay.view" | "pay.manage" | "schedule.view" | "schedule.view_drafts" | "schedule.manage" | "schedule.publish" | "punches.manage" | "timesheets.approve" | "payroll.export" | "settings.schedule";
        /**
         * @description v1 store role preset (a named bundle of capabilities).
         * @enum {string}
         */
        StoreRole: "owner" | "manager" | "shift_lead" | "sales";
        /** @description One of the authenticated user's own store memberships. */
        Membership: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            store_name?: string;
            role: components["schemas"]["StoreRole"];
            capabilities: components["schemas"]["StoreCapability"][];
            /** Format: uuid */
            default_position_id?: string | null;
            is_exempt: boolean;
            /** Format: date-time */
            hired_at?: string | null;
        };
        /** @description A roster row. Contact fields (email, phone, is_exempt, hired_at, terminated_at) appear only to viewers with team.manage; current_pay_rate_cents only to viewers with pay.view. */
        StoreMember: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            user_id: string;
            name?: string;
            role: components["schemas"]["StoreRole"];
            /** @enum {string} */
            status: "active" | "terminated";
            /** Format: uuid */
            default_position_id?: string | null;
            default_position?: components["schemas"]["Position"] | null;
            /** @description Present only to team.manage viewers */
            email?: string;
            /** @description Present only to team.manage viewers */
            phone?: string | null;
            /** @description Present only to team.manage viewers */
            is_exempt?: boolean;
            /**
             * Format: date-time
             * @description Present only to team.manage viewers
             */
            hired_at?: string | null;
            /**
             * Format: date-time
             * @description Present only to team.manage viewers
             */
            terminated_at?: string | null;
            /** @description Present only to pay.view viewers */
            current_pay_rate_cents?: number | null;
        };
        /** @description All fields optional; supply only what changes. */
        MembershipUpdateInput: {
            role?: components["schemas"]["StoreRole"];
            /** Format: uuid */
            default_position_id?: string | null;
            /**
             * @description Only reactivation (rehire, owner-only) — termination uses DELETE.
             * @enum {string}
             */
            status?: "active";
        };
        PayRate: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_membership_id: string;
            hourly_rate_cents: number;
            /** Format: date-time */
            effective_at: string;
            /** Format: date-time */
            created_at?: string;
        };
        PayRateInput: {
            hourly_rate_cents: number;
            /**
             * Format: date-time
             * @description Defaults to now when omitted.
             */
            effective_at?: string;
        };
        Position: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            name: string;
            color?: string | null;
            sort_order: number;
            is_active: boolean;
        };
        PositionInput: {
            name: string;
            color?: string | null;
            sort_order?: number;
        };
        PositionUpdateInput: {
            name?: string;
            color?: string | null;
            sort_order?: number;
            is_active?: boolean;
        };
        /** @description A pending or resolved store invitation. Never carries the token. */
        Invitation: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            email: string;
            role: components["schemas"]["StoreRole"];
            /** Format: uuid */
            default_position_id?: string | null;
            /** @enum {string} */
            status: "pending" | "accepted" | "revoked" | "expired";
            /** Format: date-time */
            expires_at: string;
            /** Format: date-time */
            accepted_at?: string | null;
            /** Format: date-time */
            revoked_at?: string | null;
            /** Format: date-time */
            created_at?: string;
        };
        InvitationInput: {
            /** Format: email */
            email: string;
            role: components["schemas"]["StoreRole"];
            /** Format: uuid */
            default_position_id?: string | null;
        };
        InvitationAcceptInput: {
            /** @description The one-time token from the invitation email link. */
            token: string;
        };
        ApiResponse: {
            /** @description Response payload */
            data?: unknown;
            message?: string | null;
        };
        PaginatedResponse: {
            data?: unknown[];
            meta?: components["schemas"]["PaginationMeta"];
            links?: components["schemas"]["PaginationLinks"];
        };
        PaginationMeta: {
            current_page?: number;
            last_page?: number;
            per_page?: number;
            total?: number;
        };
        PaginationLinks: {
            first?: string;
            last?: string;
            prev?: string | null;
            next?: string | null;
        };
        ApiError: {
            message: string;
            status: number;
        };
        ValidationError: {
            message: string;
            errors: {
                [key: string]: string[];
            };
        };
        KioskBuyResponse: {
            data: {
                /** Format: uuid */
                buy_id: string;
                /** @enum {string} */
                status: "remote_check_in" | "appointment" | "queued" | "sorting" | "sorted" | "in_progress" | "quoted" | "voided" | "no_buy" | "accepted" | "declined";
                /** @enum {string} */
                signature_state: "present" | "missing";
                queue_position: number;
                estimated_wait_minutes: number;
                loyalty_points: number;
                points_earned: number;
            };
        };
        CheckinBranding: {
            data: {
                name: string;
                logo?: string | null;
                description?: string | null;
                hours?: string | null;
                terms_version: string | null;
                /** @enum {string|null} */
                status_visibility: "confirmation_only" | "live" | null;
                checkin_enabled: boolean;
                checkin_paused: boolean;
            };
        };
        CheckinAccepted: {
            data: {
                checkin_code: string | null;
                status_token: string | null;
                status_url: string;
            };
        };
        CheckinStatus: {
            data: {
                /** @enum {string} */
                status: "remote_check_in" | "appointment" | "queued" | "sorting" | "sorted" | "in_progress" | "quoted" | "voided" | "no_buy" | "accepted" | "declined";
                status_label: string;
                container_count: number | null;
                /** @description Only in live visibility mode */
                queue_position?: number;
                /** @description Only in live visibility mode */
                estimated_wait_minutes?: number;
            };
        };
        PosCheckin: {
            /** Format: uuid */
            id: string;
            checkin_code?: string | null;
            first_name?: string | null;
            last_name?: string | null;
            container_count?: number | null;
            container_description?: string | null;
            /** Format: uuid */
            duplicate_of_buy_id?: string | null;
            /** @enum {string} */
            status: "remote_check_in" | "appointment" | "queued" | "sorting" | "sorted" | "in_progress" | "quoted" | "voided" | "no_buy" | "accepted" | "declined";
            /** Format: date-time */
            checked_in_at?: string | null;
            /** Format: date-time */
            labels_printed_at?: string | null;
        };
        PosQueueItem: {
            /** Format: uuid */
            id: string;
            /** @enum {string} */
            source: "kiosk" | "qr_code" | "mobile";
            /** @enum {string} */
            status: "remote_check_in" | "appointment" | "queued" | "sorting" | "sorted" | "in_progress" | "quoted" | "voided" | "no_buy" | "accepted" | "declined";
            status_label: string;
            checkin_code?: string | null;
            first_name?: string | null;
            last_name?: string | null;
            container_count?: number | null;
            container_description?: string | null;
            /** Format: uuid */
            duplicate_of_buy_id?: string | null;
            /** Format: date-time */
            checked_in_at?: string | null;
            /** Format: date-time */
            labels_printed_at?: string | null;
            /** Format: date-time */
            created_at: string;
            /** Format: date-time */
            updated_at: string;
        };
        /** @description An intake item under a buy — the thing being graded, quoted, and either bought or handed back. Returned by the POS item endpoints. All money fields are integer cents. */
        PosBuyItem: {
            /**
             * Format: uuid
             * @description Client-generated item id (the PK).
             */
            id: string;
            /** @enum {string} */
            status: "pending" | "quoted" | "accepted" | "declined";
            /**
             * @description Set only when `declined`.
             * @enum {string|null}
             */
            disposition?: "returned_to_customer" | "recycled" | null;
            title?: string | null;
            description?: string | null;
            category_id?: number | null;
            brand?: string | null;
            size?: string | null;
            /** @enum {string|null} */
            condition?: "NWT" | "NWOT" | "EUC" | "GUC" | "Fair" | "Poor" | null;
            /** @description Suggested marketplace price, cents. */
            listing_price?: number | null;
            /** @description Cash offered, cents. */
            cash_offer?: number | null;
            /** @description Store-credit alternative, cents. */
            store_credit_offer?: number | null;
            /**
             * Format: uuid
             * @description The draft marketplace Item created at finalize; null until converted.
             */
            converted_item_id?: string | null;
            /**
             * Format: date-time
             * @description Set when the listing conversion failed; cleared on a successful retry (I12).
             */
            conversion_failed_at?: string | null;
            sort_order: number;
            /** @description Ordered capture photos moved into the item's media. */
            photos: {
                /** Format: uri */
                url: string;
                /** @description Capture slot tag (e.g. Front, Back, Tag, Detail, Extra). */
                slot: string | null;
                order: number;
            }[];
            /** Format: date-time */
            quoted_at?: string | null;
            /** Format: date-time */
            resolved_at?: string | null;
            /** Format: date-time */
            created_at?: string | null;
            /** Format: date-time */
            updated_at?: string | null;
        };
        /** @description Body for `POST /v1/pos/buys/{buy}/finalize`. */
        FinalizeBuyRequest: {
            /**
             * @description Set true when the customer rejects the whole offer → buy `declined` regardless of per-item outcomes (I7). Defaults to false.
             * @default false
             */
            customer_rejected: boolean | null;
        };
        AuthResponse: {
            data?: {
                token?: string;
                user?: components["schemas"]["User"];
            };
        };
        LoginRequest: {
            /** Format: email */
            email: string;
            /** Format: password */
            password: string;
        };
        RegisterRequest: {
            name: string;
            /** Format: email */
            email: string;
            /** Format: password */
            password: string;
            /** Format: password */
            password_confirmation: string;
        };
        UpdateProfileRequest: {
            name?: string;
            /** Format: email */
            email?: string;
            /** Format: uri */
            avatar?: string | null;
        };
        User: {
            /** Format: uuid */
            id?: string;
            /** Format: email */
            email?: string;
            name?: string;
            avatar?: string | null;
            roles?: string[];
            /** Format: uuid */
            store_id?: string | null;
            /** Format: date-time */
            created_at?: string;
        };
        Store: {
            /** Format: uuid */
            id?: string;
            name?: string;
            /** @description Public storefront address — `/s/{slug}`. */
            slug?: string | null;
            description?: string | null;
            logo_image?: string | null;
            city?: string;
            state?: string;
            street1?: string | null;
            street2?: string | null;
            zip?: string | null;
            country?: string | null;
            is_verified?: boolean;
            /** @description Stripe Connect account ID. Present when the seller has completed Stripe onboarding. */
            stripe_connect_id?: string | null;
            /** @description True when the seller has a linked Stripe Connect account. */
            stripe_connected?: boolean;
            /** Format: date-time */
            created_at?: string;
        };
        ParcelPreset: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            name: string;
            weight_oz: number;
            length_in: number;
            width_in: number;
            height_in: number;
            is_default: boolean;
        };
        ParcelPresetInput: {
            name?: string;
            weight_oz?: number;
            length_in?: number;
            width_in?: number;
            height_in?: number;
            is_default?: boolean;
        };
        StoreSettings: {
            /** @description Flat shipping rate in cents */
            flat_shipping_rate?: number;
            /** @description Order total in cents above which shipping is free */
            free_shipping_threshold?: number | null;
            /** @description Minimum order total in cents */
            minimum_order_amount?: number | null;
            /** @description Number of business days to process an order before shipping */
            processing_days?: number;
            /** @description Number of days buyers have to initiate a return */
            return_window_days?: number;
            return_policy_text?: string | null;
        };
        CreateStoreRequest: {
            /** Format: uuid */
            owner_user_id: string;
            name: string;
            city: string;
            state: string;
            /** @description Flat shipping rate in cents */
            flat_shipping_rate: number;
            description?: string;
            logo_image?: string;
            /** @description Order total in cents above which shipping is free */
            free_shipping_threshold?: number;
            /** @description Minimum order total in cents */
            minimum_order_amount?: number;
            processing_days?: number;
            return_window_days?: number;
            return_policy_text?: string;
        };
        UpdateStoreRequest: {
            name?: string;
            description?: string | null;
            logo_image?: string | null;
            city?: string;
            state?: string;
        };
        UpdateStoreSettingsRequest: {
            /** @description Flat shipping rate in cents */
            flat_shipping_rate?: number;
            /** @description Order total in cents above which shipping is free */
            free_shipping_threshold?: number | null;
            /** @description Minimum order total in cents */
            minimum_order_amount?: number | null;
            processing_days?: number;
            return_window_days?: number;
            return_policy_text?: string | null;
        };
        ItemSummary: {
            /** Format: uuid */
            id?: string;
            title?: string;
            /** @description Price in cents */
            price?: number;
            /** @enum {string} */
            condition?: "NWT" | "NWOT" | "EUC" | "GUC" | "Fair" | "Poor";
            brand?: string | null;
            size?: string | null;
            image_url?: string | null;
            /** @enum {string} */
            status?: "draft" | "active" | "sold" | "removed";
            view_count?: number;
            save_count?: number;
            /** Format: date-time */
            published_at?: string | null;
            /** Format: date-time */
            created_at?: string;
            store?: {
                /** Format: uuid */
                id?: string;
                name?: string;
                city?: string;
                state?: string;
            };
            /**
             * Format: float
             * @description Denormalized store-level average rating (1..5). Populated from store aggregate; may be null until the store has any reviews.
             */
            store_average_rating?: number | null;
            /** @description Denormalized count of visible reviews on the store. */
            store_review_count?: number | null;
            /**
             * Format: float
             * @description Store-level dimension average (item-as-described, 1..5). Nullable when no reviews.
             */
            rating_item_as_described?: number | null;
            /**
             * Format: float
             * @description Store-level dimension average (shipping speed, 1..5). Nullable when no reviews.
             */
            rating_shipping_speed?: number | null;
            /**
             * Format: float
             * @description Store-level dimension average (communication, 1..5). Nullable when no reviews.
             */
            rating_communication?: number | null;
            /**
             * Format: float
             * @description Store-level dimension average (packaging, 1..5). Nullable when no reviews.
             */
            rating_packaging?: number | null;
        };
        PaginatedItemResponse: components["schemas"]["PaginatedResponse"] & {
            data?: components["schemas"]["ItemSummary"][];
        };
        ItemBrowseResponse: {
            data: components["schemas"]["ItemBrowseHit"][];
            meta: components["schemas"]["ItemBrowseMeta"];
            facets: components["schemas"]["ItemBrowseFacets"];
        };
        /**
         * @description A search hit from `GET /v1/items`. Projected from the Typesense
         *     document by `ItemBrowseResource`, so it is a different shape from
         *     `ItemSummary` (which the store-scoped seller listing returns) — notably
         *     the image field is `thumbnail_url`, and there is no lifecycle metadata.
         */
        ItemBrowseHit: {
            /** Format: uuid */
            id: string;
            title: string;
            brand?: string | null;
            /** @enum {string} */
            condition: "NWT" | "NWOT" | "EUC" | "GUC" | "Fair" | "Poor";
            size?: string | null;
            /** @description Price in cents */
            price: number;
            original_retail?: number | null;
            thumbnail_url?: string | null;
            store: {
                /** Format: uuid */
                id?: string;
                name?: string | null;
                city?: string | null;
                state?: string | null;
            };
            category_path?: string[];
        };
        ItemBrowseMeta: {
            total: number;
            page: number;
            per_page: number;
            total_pages: number;
        };
        ItemBrowseFacets: {
            category_path?: components["schemas"]["FacetCountList"];
            brand?: components["schemas"]["FacetCountList"];
            condition?: components["schemas"]["FacetCountList"];
            size?: components["schemas"]["FacetCountList"];
            colors?: components["schemas"]["FacetCountList"];
            store_id?: components["schemas"]["FacetCountList"];
            price?: {
                min: number;
                max: number;
            };
        } & {
            [key: string]: unknown;
        };
        FacetCountList: {
            value: string;
            count: number;
            /** @description Display name for the facet value when `value` is an opaque id (e.g. store_id). */
            label?: string;
        }[];
        StorePublic: {
            /** Format: uuid */
            id: string;
            name: string;
            /** @description Public storefront address — `/s/{slug}`. */
            slug?: string | null;
            city?: string | null;
            state?: string | null;
            total_sales?: number | null;
            is_verified: boolean;
        };
        CategoryTree: {
            id: number;
            name: string;
            slug: string;
            children: components["schemas"]["CategoryTree"][];
        };
        ItemDetail: {
            /** Format: uuid */
            id?: string;
            title?: string;
            description?: string;
            /** @description Price in cents */
            price?: number;
            /** @description Original retail price in cents */
            original_retail?: number | null;
            /** @enum {string} */
            condition?: "NWT" | "NWOT" | "EUC" | "GUC" | "Fair" | "Poor";
            brand?: string | null;
            size?: string | null;
            colors?: string[] | null;
            measurements?: {
                [key: string]: string;
            } | null;
            /** @enum {string} */
            status?: "draft" | "active" | "sold" | "removed";
            category?: {
                id?: number;
                name?: string;
                slug?: string;
            };
            /** @description Category ancestry ordered from root to leaf. */
            category_path?: {
                id: number;
                name: string;
                slug: string;
            }[];
            store?: {
                /** Format: uuid */
                id?: string;
                name?: string;
                city?: string;
                state?: string;
                is_verified?: boolean;
                is_suspended?: boolean;
                /**
                 * Format: float
                 * @description Store-level average rating (1..5). Nullable until the store has reviews.
                 */
                average_rating?: number | null;
                /** @description Count of visible reviews on the store. */
                review_count?: number;
                rating_breakdown?: {
                    /** Format: float */
                    item_as_described: number | null;
                    /** Format: float */
                    shipping_speed: number | null;
                    /** Format: float */
                    communication: number | null;
                    /** Format: float */
                    packaging: number | null;
                };
                policies?: {
                    /** @description Flat shipping rate in cents. */
                    flat_shipping_rate: number | null;
                    /** @description Order total in cents above which shipping is free. */
                    free_shipping_threshold: number | null;
                    /** @description Minimum order total in cents. */
                    minimum_order_amount: number | null;
                    /** @description Number of business days to process an order before shipping. */
                    processing_days: number | null;
                    /** @description Number of days buyers have to initiate a return. */
                    return_window_days: number | null;
                    return_policy_text: string | null;
                };
            };
            images?: components["schemas"]["ItemImage"][];
            view_count?: number;
            save_count?: number;
            /** Format: date-time */
            sold_at?: string | null;
            /** Format: date-time */
            created_at?: string;
            /** Format: date-time */
            updated_at?: string;
            /**
             * Format: float
             * @description Denormalized store-level average rating (1..5). Populated from store aggregate; may be null until the store has any reviews.
             */
            store_average_rating?: number | null;
            /** @description Denormalized count of visible reviews on the store. */
            store_review_count?: number | null;
            /**
             * Format: float
             * @description Store-level dimension average (item-as-described, 1..5). Nullable when no reviews.
             */
            rating_item_as_described?: number | null;
            /**
             * Format: float
             * @description Store-level dimension average (shipping speed, 1..5). Nullable when no reviews.
             */
            rating_shipping_speed?: number | null;
            /**
             * Format: float
             * @description Store-level dimension average (communication, 1..5). Nullable when no reviews.
             */
            rating_communication?: number | null;
            /**
             * Format: float
             * @description Store-level dimension average (packaging, 1..5). Nullable when no reviews.
             */
            rating_packaging?: number | null;
        };
        ItemImage: {
            id?: number;
            url?: string;
            thumb?: string;
            medium?: string;
            large?: string;
            og?: string;
            order?: number;
        };
        CreateItemRequest: {
            title: string;
            description: string;
            category_id: number;
            brand?: string;
            size?: string;
            /** @enum {string} */
            condition: "NWT" | "NWOT" | "EUC" | "GUC" | "Fair" | "Poor";
            colors?: string[];
            measurements?: {
                [key: string]: string;
            };
            /** @description Price in cents (minimum $1.00) */
            price: number;
            /** @description Original retail price in cents */
            original_retail?: number;
        };
        UpdateItemRequest: {
            title?: string;
            description?: string;
            category_id?: number;
            brand?: string;
            size?: string;
            /** @enum {string} */
            condition?: "NWT" | "NWOT" | "EUC" | "GUC" | "Fair" | "Poor";
            colors?: string[];
            measurements?: {
                [key: string]: string;
            };
            /** @description Price in cents (minimum $1.00) */
            price?: number;
            /** @description Original retail price in cents */
            original_retail?: number;
        };
        SnapPublishItemRequest: {
            title: string;
            description: string;
            category_id: number;
            brand?: string;
            size?: string;
            /** @enum {string} */
            condition: "NWT" | "NWOT" | "EUC" | "GUC" | "Fair" | "Poor";
            colors?: string[];
            measurements?: {
                [key: string]: string;
            };
            price: number;
            original_retail?: number;
            images: string[];
        };
        CartResponse: {
            data?: {
                stores?: components["schemas"]["CartStoreGroup"][];
                item_count?: number;
                subtotal?: number;
                shipping_total?: number;
                total?: number;
            };
        };
        CartStoreGroup: {
            store?: {
                /** Format: uuid */
                id?: string;
                name?: string;
                logo_image?: string | null;
            };
            items?: components["schemas"]["CartItemData"][];
            subtotal?: number;
            shipping?: number;
            free_shipping_threshold?: number | null;
        };
        CartItemData: {
            /** Format: uuid */
            id?: string;
            item?: {
                /** Format: uuid */
                id?: string;
                title?: string;
                price?: number;
                image_url?: string | null;
                condition?: string;
                is_available?: boolean;
            };
            /** Format: date-time */
            added_at?: string;
        };
        CartItemResponse: {
            data?: components["schemas"]["CartItemData"];
        };
        CheckoutRequest: {
            shipping_address: components["schemas"]["ShippingAddress"];
            excluded_item_ids?: string[];
        };
        ShippingAddress: {
            first_name: string;
            last_name: string;
            street: string;
            city: string;
            state: string;
            zip: string;
        };
        CheckoutResponse: {
            data?: {
                /** Format: uuid */
                checkout_id?: string;
                client_secret?: string;
                stores?: components["schemas"]["CheckoutStoreGroup"][];
                subtotal?: number;
                discount_total?: number;
                shipping_total?: number;
                tax_total?: number;
                total?: number;
            };
        };
        CheckoutStoreGroup: {
            store?: {
                /** Format: uuid */
                id?: string;
                name?: string;
            };
            items?: {
                /** Format: uuid */
                id?: string;
                title?: string;
                price?: number;
            }[];
            subtotal?: number;
            shipping?: number;
        };
        CheckoutConflictResponse: {
            error?: string;
            unavailable_items?: {
                /** Format: uuid */
                id?: string;
                title?: string;
                reason?: string;
            }[];
            available_items?: {
                /** Format: uuid */
                id?: string;
                title?: string;
                price?: number;
            }[];
            updated_totals?: {
                subtotal?: number;
                shipping_total?: number;
                total?: number;
            };
        };
        PurchaseListResponse: {
            data?: components["schemas"]["PurchaseSummary"][];
            meta?: components["schemas"]["PaginationMeta"];
        };
        PurchaseSummary: {
            /** Format: uuid */
            id?: string;
            total?: number;
            status?: string;
            order_count?: number;
            item_count?: number;
            /** Format: date-time */
            created_at?: string;
        };
        PurchaseDetailResponse: {
            data?: {
                /** Format: uuid */
                id?: string;
                /** Format: uuid */
                buyer_id?: string;
                subtotal?: number;
                discount_total?: number;
                shipping_total?: number;
                tax_total?: number;
                total?: number;
                status?: string;
                shipping_address?: components["schemas"]["ShippingAddress"];
                orders?: components["schemas"]["OrderDetail"][];
                /** Format: date-time */
                created_at?: string;
            };
        };
        OrderDetail: {
            /** Format: uuid */
            id?: string;
            store?: {
                /** Format: uuid */
                id?: string;
                name?: string;
            };
            subtotal?: number;
            shipping_cost?: number;
            status?: string;
            buyer?: {
                first_name?: string | null;
                last_name?: string | null;
            } | null;
            shipping_address?: {
                street?: string | null;
                city?: string | null;
                state?: string | null;
                zip?: string | null;
            } | null;
            tracking_number?: string | null;
            tracking_url?: string | null;
            carrier?: string | null;
            service?: string | null;
            /** Format: uri */
            shipping_label_url?: string | null;
            /** Format: date-time */
            label_purchased_at?: string | null;
            /** Format: date-time */
            ship_by?: string | null;
            /** Format: date-time */
            shipped_at?: string | null;
            /** Format: date-time */
            delivered_at?: string | null;
            cancelled_by?: string | null;
            cancellation_reason?: string | null;
            /** Format: date-time */
            cancelled_at?: string | null;
            is_delayed?: boolean;
            items?: components["schemas"]["OrderItemData"][];
            /**
             * Format: uuid
             * @description ID of the return currently open against this order, if any.
             */
            open_return_id?: string | null;
            /**
             * Format: date-time
             * @description Latest timestamp at which a buyer can still file a return; null when not delivered.
             */
            returns_open_until?: string | null;
            /** Format: date-time */
            created_at?: string;
        };
        Order: {
            /** Format: uuid */
            id?: string;
            /** Format: uuid */
            purchase_id?: string;
            /** Format: uuid */
            store_id?: string;
            status?: string;
            subtotal?: number;
            shipping_cost?: number;
            tax_amount?: number;
            platform_fee?: number;
            seller_payout?: number;
            tracking_number?: string | null;
            tracker_id?: string | null;
            tracking_url?: string | null;
            carrier?: string | null;
            service?: string | null;
            shipping_label_url?: string | null;
            /** Format: date-time */
            label_purchased_at?: string | null;
            stripe_transfer_id?: string | null;
            /** Format: date-time */
            transferred_at?: string | null;
            /** Format: date-time */
            ship_by?: string | null;
            /** Format: date-time */
            shipped_at?: string | null;
            /** Format: date-time */
            delivered_at?: string | null;
            cancelled_by?: string | null;
            cancellation_reason?: string | null;
            /** Format: date-time */
            cancelled_at?: string | null;
            is_delayed?: boolean;
            /** Format: uuid */
            open_return_id?: string | null;
            /** Format: date-time */
            returns_open_until?: string | null;
            /** Format: date-time */
            created_at?: string;
        };
        OrderItemData: {
            /** Format: uuid */
            id?: string;
            /** Format: uuid */
            item_id?: string;
            title_snapshot?: string;
            price_snapshot?: number;
            image_url_snapshot?: string | null;
        };
        OrderListResponse: {
            data?: components["schemas"]["OrderDetail"][];
            meta?: components["schemas"]["PaginationMeta"];
        };
        OrderDetailResponse: {
            data?: components["schemas"]["OrderDetail"];
        };
        NotificationInboxItem: {
            /** Format: uuid */
            id: string;
            /** @description Short class name (e.g., BuyerOrderShippedNotification) */
            type: string;
            title: string;
            body: string;
            cta_url: string;
            /** @enum {string} */
            icon: "package" | "truck" | "check" | "alert" | "x";
            /** @enum {string} */
            context_type: "order" | "purchase";
            /** Format: uuid */
            context_id: string;
            /** Format: date-time */
            read_at: string | null;
            /** Format: date-time */
            created_at: string;
        };
        NotificationInboxList: {
            data: components["schemas"]["NotificationInboxItem"][];
            meta: {
                unread_count: number;
                current_page: number;
                last_page: number;
                per_page: number;
                total: number;
            };
        };
        NotificationUnreadCount: {
            unread_count: number;
        };
        NotificationPreference: {
            /** @enum {string} */
            channel: "email" | "push";
            /** @enum {string} */
            category: "orders" | "shipping" | "promotions" | "price_drops" | "account";
            enabled: boolean;
            is_transactional: boolean;
        };
        NotificationPreferencesUpdateRequest: {
            preferences: {
                /** @enum {string} */
                channel: "email" | "push";
                /** @enum {string} */
                category: "orders" | "shipping" | "promotions" | "price_drops" | "account";
                enabled: boolean;
            }[];
        };
        SellerDashboardMetrics: {
            revenue_this_month: {
                current_cents: number;
                prior_cents: number;
            };
            active_listings: {
                current: number;
                delta_last_7_days: number;
            };
            orders_this_month: {
                current: number;
                prior: number;
            };
            next_payout: {
                amount_cents: number | null;
                /** Format: date */
                arrival_date: string | null;
            };
            action_counts: {
                orders_overdue: number;
                orders_today: number;
                orders_this_week: number;
                listings_needs_attention: number;
            };
        };
        SellerBalance: {
            available_cents: number;
            pending_cents: number;
            /** Format: date-time */
            next_payout_date: string;
            /** @description Whether Stripe is currently allowing transfers to this store's Connect account. False when onboarding is incomplete or a payout requirement has been flagged. */
            payouts_enabled: boolean;
            /** @description Human-readable explanation for why payouts are paused. Null when payouts_enabled is true. Surfaces in the Connect health banner. */
            disabled_reason: string | null;
        };
        Payout: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            /** @enum {string} */
            state: "scheduled" | "in_flight" | "succeeded" | "failed" | "void";
            /** Format: date-time */
            period_start: string;
            /** Format: date-time */
            period_end: string;
            /** Format: date-time */
            scheduled_for: string;
            gross_cents: number;
            debits_cents: number;
            net_cents: number;
            stripe_transfer_id: string | null;
            /** Format: date-time */
            transferred_at: string | null;
            /** Format: date-time */
            failed_at: string | null;
            failure_reason: string | null;
            retries: number;
            /** Format: date-time */
            created_at: string;
            /** Format: date-time */
            updated_at: string;
        };
        PayoutLedgerEntry: {
            /** Format: uuid */
            id: string;
            /** @enum {string} */
            entry_type: "order_earned" | "order_refunded" | "label_cost_debit" | "payout_settled" | "adjustment_credit" | "adjustment_debit";
            /** @enum {string} */
            direction: "credit" | "debit";
            amount_cents: number;
            description: string | null;
            source_type: string | null;
            source_id: string | null;
            /** Format: date-time */
            available_at: string;
            /** Format: date-time */
            created_at: string;
        };
        PayoutDetail: components["schemas"]["Payout"] & {
            entries: components["schemas"]["PayoutLedgerEntry"][];
        };
        AdminDashboardMetrics: {
            total_stores: number;
            verified_stores: number;
            active_items: number;
            total_sales_cents: number;
            active_orders: number;
            open_disputes: number;
            overdue_disputes: number;
        };
        AdminStoreSummary: {
            /** Format: uuid */
            id: string;
            name: string;
            city: string | null;
            state: string | null;
            is_verified: boolean;
            item_count: number;
            total_sales?: number | null;
            /** Format: date-time */
            created_at: string;
        };
        AdminOrderSummary: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            purchase_id: string;
            store: {
                /** Format: uuid */
                id: string;
                name: string;
            };
            buyer: {
                first_name: string | null;
                last_name: string | null;
            };
            /** @enum {string} */
            status: "pending" | "processing" | "shipped" | "delivered" | "cancelled" | "refunded";
            subtotal: number;
            shipping_cost: number;
            total: number;
            item_count: number;
            /** Format: date-time */
            created_at: string;
        };
        AdminDisputeSummary: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            purchase_id: string;
            stripe_dispute_id: string;
            /** @enum {string} */
            status: "needs_response" | "under_review" | "won" | "lost" | "warning_needs_response" | "warning_under_review" | "warning_closed" | "charge_refunded";
            reason?: string | null;
            amount_cents: number;
            /** Format: date-time */
            evidence_due_by?: string | null;
            buyer_first_name?: string | null;
            buyer_last_name?: string | null;
            /** @enum {string|null} */
            outcome?: "submitted_evidence" | "accepted" | "resolved" | null;
            /** Format: date-time */
            decided_at?: string | null;
            /** Format: date-time */
            created_at: string;
        };
        AdminDisputeDetail: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            purchase_id: string;
            stripe_dispute_id: string;
            status: string;
            reason?: string | null;
            amount_cents: number;
            /** Format: date-time */
            evidence_due_by?: string | null;
            outcome?: string | null;
            /** Format: date-time */
            decided_at?: string | null;
            decision_justification?: string | null;
            buyer_first_name?: string | null;
            buyer_last_name?: string | null;
            /** Format: date-time */
            created_at?: string;
            purchase: {
                /** Format: uuid */
                id: string;
                stripe_payment_intent_id?: string | null;
                shipping_address?: {
                    [key: string]: unknown;
                };
                subtotal?: number;
                shipping_total?: number;
            };
            orders: {
                /** Format: uuid */
                id: string;
                store?: {
                    /** Format: uuid */
                    id?: string;
                    name?: string;
                };
                status: string;
                subtotal: number;
                shipping_cost: number;
                stripe_transfer_id?: string | null;
                /** Format: date-time */
                transferred_at?: string | null;
                /** Format: date-time */
                transfer_reversed_at?: string | null;
                tracking_number?: string | null;
                tracking_url?: string | null;
                /** Format: date-time */
                shipped_at?: string | null;
            }[];
        };
        AdjudicateRequest: {
            /** @enum {string} */
            outcome: "submitted_evidence" | "accepted" | "resolved";
            justification: string;
            per_order_actions?: {
                /** Format: uuid */
                order_id: string;
                reverse_transfer: boolean;
            }[];
        };
        AdminOrderDetail: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            purchase_id?: string;
            status: string;
            subtotal: number;
            shipping_cost: number;
            tax_amount?: number;
            total: number;
            tracking_number?: string | null;
            tracking_url?: string | null;
            carrier?: string | null;
            /** Format: date-time */
            ship_by?: string | null;
            /** Format: date-time */
            shipped_at?: string | null;
            /** Format: date-time */
            delivered_at?: string | null;
            /** Format: date-time */
            cancelled_at?: string | null;
            cancellation_reason?: string | null;
            stripe_transfer_id?: string | null;
            /** Format: date-time */
            transferred_at?: string | null;
            stripe_transfer_reversal_id?: string | null;
            /** Format: date-time */
            transfer_reversed_at?: string | null;
            stripe_refund_id?: string | null;
            /** Format: date-time */
            created_at: string;
            store: {
                /** Format: uuid */
                id: string;
                name: string;
            };
            buyer: {
                first_name: string | null;
                last_name: string | null;
            };
            items: {
                /** Format: uuid */
                id: string;
                /** Format: uuid */
                item_id?: string | null;
                title_snapshot: string;
                price_snapshot: number;
                image_url_snapshot?: string | null;
            }[];
            purchase: {
                /** Format: uuid */
                id: string;
                stripe_payment_intent_id?: string | null;
                shipping_address?: {
                    [key: string]: unknown;
                };
            };
        };
        JustificationBody: {
            justification: string;
        };
        AdminRefundBody: {
            amount_cents: number;
            justification: string;
        };
        AdminStoreDetail: components["schemas"]["AdminStoreSummary"] & {
            is_suspended: boolean;
            /** Format: date-time */
            suspended_at?: string | null;
            suspension_reason?: string | null;
            owner: {
                /** Format: uuid */
                id?: string;
                email?: string;
                name?: string;
            } | null;
            counters: {
                items_active: number;
                items_draft: number;
                orders_open: number;
                orders_total: number;
                lifetime_revenue_cents: number;
            };
            recent_orders: {
                /** Format: uuid */
                id: string;
                status: string;
                total: number;
                /** Format: date-time */
                created_at: string;
            }[];
            recent_items: {
                /** Format: uuid */
                id: string;
                title: string;
                price: number;
                status: string;
                /** Format: date-time */
                created_at: string;
            }[];
        };
        AdminActivityEntry: {
            id: number;
            event: string;
            actor?: {
                /** Format: uuid */
                id?: string;
                name?: string;
            } | null;
            subject: {
                type: string | null;
                id: string | null;
            };
            properties: {
                [key: string]: unknown;
            };
            /** Format: date-time */
            created_at: string;
        };
        Message: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            thread_id: string;
            /** Format: uuid */
            author_user_id?: string | null;
            /** @enum {string} */
            author_role: "buyer" | "seller" | "admin" | "system";
            /** @description Null when the message is soft-deleted and the viewer is not an admin. */
            body?: string | null;
            attachments?: {
                url: string;
                thumb_url: string;
                content_type: string;
                size_bytes: number;
            }[];
            /** Format: date-time */
            created_at: string;
            /** Format: date-time */
            deleted_at?: string | null;
            /**
             * Format: uuid
             * @description Only populated for admin viewers.
             */
            deleted_by_user_id?: string | null;
            /** @description True when the message is soft-deleted and the deleter was an admin (not the author). */
            deleted_by_admin?: boolean;
        };
        MessageAttachmentUpload: {
            /** Format: uuid */
            id: string;
            url: string;
            content_type: string;
            size_bytes: number;
        };
        MessageThreadSummary: {
            /** Format: uuid */
            thread_id: string;
            /** Format: uuid */
            order_id: string;
            counterparty_name?: string | null;
            unread_count: number;
            last_message_snippet?: string | null;
            /** Format: date-time */
            last_message_at?: string | null;
        };
        OrderReturn: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            order_id: string;
            /** @enum {string} */
            initiated_by: "buyer" | "seller";
            /** @enum {string} */
            state: "requested" | "approved" | "rejected" | "awaiting_shipment" | "in_transit" | "received" | "refunded" | "closed" | "cancelled" | "escalated";
            /** @enum {string} */
            reason: "damaged" | "wrong_item" | "not_as_described" | "doesnt_fit" | "changed_mind" | "other";
            reason_text?: string | null;
            /** @enum {string} */
            return_shipping_payer: "seller" | "buyer" | "none";
            restocking_fee_cents: number;
            refund_amount_cents?: number | null;
            /** @default false */
            refund_original_shipping: boolean;
            refund_amount_override_cents?: number | null;
            stripe_refund_id?: string | null;
            tracking_number?: string | null;
            carrier?: string | null;
            tracker_id?: string | null;
            /** Format: uri */
            tracking_url?: string | null;
            /** Format: uri */
            shipping_label_url?: string | null;
            easypost_label_error?: string | null;
            items: components["schemas"]["ReturnItem"][];
            /** Format: date-time */
            approved_at?: string | null;
            /** Format: date-time */
            rejected_at?: string | null;
            /** Format: date-time */
            label_issued_at?: string | null;
            /** Format: date-time */
            in_transit_at?: string | null;
            /** Format: date-time */
            received_at?: string | null;
            /** Format: date-time */
            refunded_at?: string | null;
            /** Format: date-time */
            closed_at?: string | null;
            /** Format: date-time */
            cancelled_at?: string | null;
            escalation?: components["schemas"]["ReturnEscalation"] | null;
            /** Format: date-time */
            created_at: string;
            /** Format: date-time */
            updated_at: string;
        };
        OrderReturnSummary: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            order_id: string;
            /** @enum {string} */
            state: "requested" | "approved" | "rejected" | "awaiting_shipment" | "in_transit" | "received" | "refunded" | "closed" | "cancelled" | "escalated";
            /** @enum {string} */
            reason: "damaged" | "wrong_item" | "not_as_described" | "doesnt_fit" | "changed_mind" | "other";
            refund_amount_cents?: number | null;
            counterparty_name?: string | null;
            escalation?: {
                /** @enum {string} */
                state?: "open" | "resolved";
                reason?: string;
            } | null;
            /** Format: date-time */
            created_at: string;
            /** Format: date-time */
            updated_at: string;
        };
        ReturnItem: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            order_item_id: string;
            quantity: number;
            title_snapshot?: string | null;
            price_snapshot?: number | null;
        };
        CreateReturnRequest: {
            /** @enum {string} */
            reason: "damaged" | "wrong_item" | "not_as_described" | "doesnt_fit" | "changed_mind" | "other";
            reason_text?: string | null;
            item_ids: string[];
            attachment_ids?: string[];
        };
        ApproveReturnRequest: {
            restocking_fee_cents?: number;
        };
        RejectReturnRequest: {
            reason_text: string;
        };
        ProactiveRefundRequest: {
            /** @enum {string} */
            mode: "keep-it" | "ship-back";
            item_ids: string[];
            amount_cents?: number | null;
            /** @default false */
            refund_original_shipping: boolean;
            reason?: ("damaged" | "wrong_item" | "not_as_described" | "doesnt_fit" | "changed_mind" | "other") | null;
            reason_text?: string | null;
        };
        EscalateReturnRequest: {
            reason: string;
        };
        SellerCloseReturnRequest: {
            reason: string;
        };
        AdminResolveReturnRequest: {
            /** @enum {string} */
            action: "force_refund" | "force_close_no_refund" | "no_action";
            resolution: string;
        };
        ReturnEscalation: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            return_id: string;
            /** Format: uuid */
            escalated_by_user_id: string;
            reason: string;
            /** @enum {string} */
            state: "open" | "resolved";
            /** Format: uuid */
            resolved_by_admin_id?: string | null;
            resolution?: string | null;
            action?: ("force_refund" | "force_close_no_refund" | "no_action") | null;
            /** Format: date-time */
            resolved_at?: string | null;
            /** Format: date-time */
            created_at: string;
            /** Format: date-time */
            updated_at: string;
        };
        /**
         * @description Generic ledger row shape returned by the admin/seller ledger and
         *     statement endpoints. Same field set as `PayoutLedgerEntry` plus the
         *     nullable `payout_id` link (an entry that has been bundled into a
         *     payout records the payout id here, otherwise null).
         */
        LedgerEntry: {
            /** Format: uuid */
            id: string;
            /** @enum {string} */
            entry_type: "order_earned" | "order_refunded" | "label_cost_debit" | "payout_settled" | "adjustment_credit" | "adjustment_debit";
            /** @enum {string} */
            direction: "credit" | "debit";
            amount_cents: number;
            description: string | null;
            source_type: string | null;
            source_id: string | null;
            /** Format: date-time */
            available_at: string;
            /** Format: uuid */
            payout_id: string | null;
            /** Format: date-time */
            created_at: string;
        };
        /**
         * @description A manual credit or debit recorded by an admin against a store's
         *     ledger. The `admin` block is populated when the relation is eager
         *     loaded (the create endpoint always returns it).
         */
        ManualAdjustment: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            /** @enum {string} */
            type: "credit" | "debit";
            amount_cents: number;
            reason: string;
            admin?: {
                /** Format: uuid */
                id: string;
                name: string;
                email: string;
            } | null;
            /** Format: date-time */
            created_at: string;
        };
        /**
         * @description Admin-facing payout shape: extends `Payout` with the store identity
         *     (flat `store_name` for the queue UI) and the void resolution block
         *     (`voided_at`, `voided_by`, `resolution_note`).
         */
        AdminPayout: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            store_name?: string | null;
            /** @enum {string} */
            state: "scheduled" | "in_flight" | "succeeded" | "failed" | "void";
            /** Format: date-time */
            period_start: string;
            /** Format: date-time */
            period_end: string;
            /** Format: date-time */
            scheduled_for: string;
            gross_cents: number;
            debits_cents: number;
            net_cents: number;
            stripe_transfer_id: string | null;
            /** Format: date-time */
            transferred_at: string | null;
            /** Format: date-time */
            failed_at: string | null;
            failure_reason: string | null;
            retries: number;
            /** Format: date-time */
            voided_at: string | null;
            voided_by: {
                /** Format: uuid */
                id: string;
                name: string;
                email: string;
            } | null;
            resolution_note: string | null;
            /** Format: date-time */
            created_at: string;
            /** Format: date-time */
            updated_at: string;
        };
        /**
         * @description Marketplace-wide pending/available totals plus a per-store breakdown.
         *     Both totals and per-store values are derived from the same SQL
         *     aggregate over `seller_ledger`.
         */
        FinancialsBalance: {
            total_pending_cents: number;
            total_available_cents: number;
            stores: {
                /** Format: uuid */
                store_id: string;
                store_name: string | null;
                pending_cents: number;
                available_cents: number;
            }[];
        };
        AdminLedgerAdjustmentRequest: {
            /** @enum {string} */
            type: "credit" | "debit";
            amount_cents: number;
            reason: string;
        };
        AdminPayoutRetryRequest: {
            resolution_note?: string | null;
        };
        AdminPayoutVoidRequest: {
            resolution_note: string;
        };
        Review: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            order_item_id: string;
            /** Format: uuid */
            order_id?: string;
            /** Format: uuid */
            store_id: string;
            /** Format: uuid */
            reviewer_user_id: string;
            rating: number;
            rating_item_as_described?: number;
            rating_shipping_speed?: number;
            rating_communication?: number;
            rating_packaging?: number;
            title?: string | null;
            body: string;
            /** @enum {string} */
            state: "visible" | "hidden";
            /** Format: date-time */
            edited_at?: string | null;
            /** Format: uuid */
            hidden_by_admin_id?: string | null;
            /** Format: date-time */
            hidden_at?: string | null;
            hide_reason?: string | null;
            /** @description Server-computed flag — true when the review is visible, owned by the requester, and still within the editable window. Replaces client-side clock math. */
            is_editable?: boolean;
            photos?: {
                /** Format: uri */
                url?: string;
                /** Format: uri */
                thumb_url?: string;
            }[];
            /** Format: date-time */
            created_at: string;
            /** Format: date-time */
            updated_at: string;
        };
        ReviewSummary: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            buyer?: {
                name?: string;
            };
            rating: number;
            rating_item_as_described?: number;
            rating_shipping_speed?: number;
            rating_communication?: number;
            rating_packaging?: number;
            title?: string | null;
            body: string;
            /** @enum {string} */
            state: "visible";
            /** Format: date-time */
            edited_at?: string | null;
            /** @description Server-computed flag — true when the review is owned by the requester and still within the editable window. Replaces client-side clock math. */
            is_editable?: boolean;
            photos?: {
                /** Format: uri */
                url?: string;
                /** Format: uri */
                thumb_url?: string;
            }[];
            /** Format: date-time */
            created_at: string;
        };
        SellerReview: components["schemas"]["Review"] & {
            /** @description Per-review report rollup, only present on the seller-facing list. Counts include all reports across all states; `latest_*` mirror the most recent report. */
            report_status?: {
                count: number;
                /** @enum {string|null} */
                latest_outcome: "keep" | "hide" | null;
                /** @enum {string|null} */
                latest_state: "open" | "resolved" | null;
            };
        };
        RatingSummary: {
            average_rating: number | null;
            review_count: number;
            distribution: {
                1?: number;
                2?: number;
                3?: number;
                4?: number;
                5?: number;
            };
            dimensions: {
                item_as_described?: number | null;
                shipping_speed?: number | null;
                communication?: number | null;
                packaging?: number | null;
            };
        };
        ReviewAttachmentUpload: {
            /** Format: uuid */
            id: string;
            /** Format: uri */
            url?: string | null;
            /** Format: uri */
            thumb_url?: string | null;
        };
        NewReviewInput: {
            rating: number;
            rating_item_as_described?: number;
            rating_shipping_speed?: number;
            rating_communication?: number;
            rating_packaging?: number;
            title?: string;
            body: string;
            attachment_ids?: string[];
        };
        EditReviewInput: {
            rating: number;
            rating_item_as_described?: number;
            rating_shipping_speed?: number;
            rating_communication?: number;
            rating_packaging?: number;
            title?: string;
            body: string;
            attachment_ids?: string[];
        };
        ReviewReport: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            review_id: string;
            /** @enum {string} */
            reason: "inappropriate" | "spam" | "not_about_purchase" | "personal_info" | "other";
            reason_text?: string | null;
            /** @enum {string} */
            state: "open" | "resolved";
            /** @enum {string|null} */
            action?: "keep" | "hide" | null;
            resolution_note?: string | null;
            /** Format: date-time */
            resolved_at?: string | null;
            /** Format: date-time */
            created_at: string;
            /** Format: date-time */
            updated_at: string;
            reporter?: {
                /** Format: uuid */
                id?: string;
                name?: string;
            };
            resolved_by?: {
                /** Format: uuid */
                id?: string;
                name?: string;
            } | null;
            review?: {
                /** Format: uuid */
                id?: string;
                /** Format: uuid */
                store_id?: string;
                store_name?: string;
                reviewer_name?: string;
                rating?: number;
                title?: string | null;
                body?: string;
                /** @enum {string} */
                state?: "visible" | "hidden";
                /** Format: date-time */
                created_at?: string;
            };
        };
        CreateReviewReportInput: {
            /** @enum {string} */
            reason: "inappropriate" | "spam" | "not_about_purchase" | "personal_info" | "other";
            reason_text?: string;
        };
        ResolveReviewReportInput: {
            /** @enum {string} */
            action: "keep" | "hide";
            resolution_note: string;
        };
        HideReviewInput: {
            reason: string;
        };
        RestoreReviewInput: {
            reason: string;
        };
        BulkHideReviewsInput: {
            review_ids: string[];
            /** @description Shared moderation note recorded against each successfully hidden review. */
            justification: string;
        };
        BulkHideReviewsResult: {
            data: {
                /** @description Review ids that were transitioned from visible to hidden by this call. */
                hidden: string[];
                /** @description Review ids that could not be hidden, with a structured reason per id. */
                skipped: {
                    /** Format: uuid */
                    id: string;
                    /** @description Short machine-readable reason, e.g. `not_found`, `already_hidden`, `forbidden`. */
                    reason: string;
                }[];
            };
        };
        /** @description Presentation tokens the storefront renderer turns into CSS variables. */
        StoreSiteTheme: {
            /** @description Hex colour, e.g. `#1f3a2e`. */
            primary_color?: string;
            accent_color?: string;
            background_color?: string;
            text_color?: string;
            /** @enum {string} */
            font?: "sans" | "serif" | "mono";
            /** @enum {string} */
            corner_radius?: "none" | "sm" | "md" | "lg";
            /** @enum {string} */
            header_style?: "solid" | "transparent" | "minimal";
        };
        StoreSiteHoursEntry: {
            /** @description 0 = Sunday, matching JavaScript's `Date#getDay()`. */
            day: number;
            closed: boolean;
            /** @description 24-hour `HH:MM`. Required unless `closed`. */
            open?: string | null;
            close?: string | null;
        };
        StoreSiteSocialLink: {
            /** @enum {string} */
            platform: "instagram" | "facebook" | "tiktok" | "x" | "pinterest" | "youtube" | "website";
            url: string;
        };
        /**
         * @description One section of a page. Array order is render order. The shape of `data`
         *     depends on `type`; a renderer that does not know a type skips the block
         *     rather than failing the page.
         */
        StoreSiteBlock: {
            /** @description Stable id so the editor can key on the block across saves. */
            id: string;
            /** @enum {string} */
            type: "hero" | "rich_text" | "products" | "hours" | "map" | "contact" | "gallery" | "cta" | "faq" | "divider";
            /**
             * @description Type-specific payload. `hero`: headline, subhead, image_url, overlay,
             *     align, cta_label, cta_href. `rich_text`: heading, body, align.
             *     `products`: heading, source (`newest` | `category` | `picked`),
             *     category_slug, item_ids, limit, show_view_all — the block stores a
             *     query, not resolved listings. `hours`: heading, note. `map`: heading,
             *     address_override, note, show_directions_link. `contact`: heading,
             *     body, show_email, show_phone, show_message_link. `gallery`: heading,
             *     images[{url, alt}]. `cta`: headline, body, label, href, background.
             *     `faq`: heading, items[{question, answer}]. `divider`: no payload.
             */
            data: {
                [key: string]: unknown;
            };
        };
        StorefrontNavLink: {
            slug: string;
            label: string;
            is_home: boolean;
        };
        /** @description Everything the renderer needs before it knows which page it is drawing. */
        StorefrontShell: {
            store: {
                /** Format: uuid */
                id?: string;
                slug?: string | null;
                name?: string;
                description?: string | null;
                logo_image?: string | null;
                street1?: string | null;
                street2?: string | null;
                city?: string | null;
                state?: string | null;
                zip?: string | null;
                country?: string | null;
                is_verified?: boolean;
                average_rating?: number | null;
                review_count?: number | null;
            };
            theme: components["schemas"]["StoreSiteTheme"];
            logo_url?: string | null;
            favicon_url?: string | null;
            tagline?: string | null;
            hours?: components["schemas"]["StoreSiteHoursEntry"][];
            social_links?: components["schemas"]["StoreSiteSocialLink"][];
            contact_email?: string | null;
            contact_phone?: string | null;
            directions_note?: string | null;
            seo?: {
                title?: string | null;
                description?: string | null;
                og_image_url?: string | null;
            };
            /** @description Always the slug path, so a custom domain still points search engines at one URL. */
            canonical_url?: string;
            nav: components["schemas"]["StorefrontNavLink"][];
        };
        StorefrontPage: {
            slug: string;
            title: string;
            is_home: boolean;
            blocks: components["schemas"]["StoreSiteBlock"][];
            seo?: {
                title?: string | null;
                description?: string | null;
            };
        };
        StorefrontResolution: {
            hostname: string;
            /** Format: uuid */
            store_id: string;
            store_slug: string;
            is_primary: boolean;
        };
        /** @description Owner-facing page shape — includes the visibility flags the public resource hides. */
        StoreSitePage: {
            /** Format: uuid */
            id: string;
            slug: string;
            title: string;
            nav_label?: string | null;
            is_home: boolean;
            show_in_nav?: boolean;
            is_published?: boolean;
            position?: number;
            blocks: components["schemas"]["StoreSiteBlock"][];
            seo_title?: string | null;
            seo_description?: string | null;
            /** Format: date-time */
            updated_at?: string | null;
        };
        StoreDomain: {
            /** Format: uuid */
            id: string;
            hostname: string;
            is_verified: boolean;
            is_primary: boolean;
            /** Format: date-time */
            verified_at?: string | null;
            /** Format: date-time */
            last_checked_at?: string | null;
            last_check_error?: string | null;
            /** @description The exact records the seller pastes into their DNS provider. */
            dns_instructions: {
                txt?: {
                    name?: string;
                    value?: string;
                };
                cname?: {
                    name?: string;
                    value?: string;
                };
            };
        };
        StoreSite: {
            /** Format: uuid */
            id: string;
            /** Format: uuid */
            store_id: string;
            store_slug?: string | null;
            store_name?: string | null;
            is_published: boolean;
            /** Format: date-time */
            published_at?: string | null;
            theme: components["schemas"]["StoreSiteTheme"];
            logo_url?: string | null;
            favicon_url?: string | null;
            tagline?: string | null;
            hours?: components["schemas"]["StoreSiteHoursEntry"][];
            social_links?: components["schemas"]["StoreSiteSocialLink"][];
            contact_email?: string | null;
            contact_phone?: string | null;
            directions_note?: string | null;
            seo_title?: string | null;
            seo_description?: string | null;
            og_image_url?: string | null;
            public_url?: string;
            pages?: components["schemas"]["StoreSitePage"][];
            domains?: components["schemas"]["StoreDomain"][];
        };
        /** @description Partial update; `theme` is merged into the stored palette. */
        UpdateStoreSiteRequest: {
            is_published?: boolean;
            theme?: components["schemas"]["StoreSiteTheme"];
            logo_url?: string | null;
            favicon_url?: string | null;
            tagline?: string | null;
            hours?: components["schemas"]["StoreSiteHoursEntry"][];
            social_links?: components["schemas"]["StoreSiteSocialLink"][];
            contact_email?: string | null;
            contact_phone?: string | null;
            directions_note?: string | null;
            seo_title?: string | null;
            seo_description?: string | null;
            og_image_url?: string | null;
        };
        UpdateStoreSlugRequest: {
            slug: string;
        };
        CreateStoreSitePageRequest: {
            /** @description Slugified server-side; must be unique within the site. */
            slug: string;
            title: string;
            nav_label?: string | null;
            show_in_nav?: boolean;
            is_published?: boolean;
            blocks?: components["schemas"]["StoreSiteBlock"][];
            seo_title?: string | null;
            seo_description?: string | null;
        };
        /** @description Partial update. `blocks`, when present, replaces the whole ordered list. */
        UpdateStoreSitePageRequest: {
            slug?: string;
            title?: string;
            nav_label?: string | null;
            show_in_nav?: boolean;
            is_published?: boolean;
            blocks?: components["schemas"]["StoreSiteBlock"][];
            seo_title?: string | null;
            seo_description?: string | null;
        };
        ReorderStoreSitePagesRequest: {
            /** @description Every page id for the site, exactly once. Index becomes position. */
            page_ids: string[];
        };
        CreateStoreDomainRequest: {
            /** @description Scheme, port and path are stripped server-side. */
            hostname: string;
        };
    };
    responses: never;
    parameters: {
        /** @description Store UUID */
        StoreId: string;
        /** @description Store slug — the public address of the storefront */
        StorefrontSlug: string;
        /** @description Store site page UUID */
        StoreSitePageId: string;
        /** @description Store domain UUID */
        StoreDomainId: string;
        /** @description Store membership UUID */
        MembershipId: string;
        /** @description Store position UUID */
        PositionId: string;
        /** @description Store invitation UUID */
        InvitationId: string;
    };
    requestBodies: never;
    headers: never;
    pathItems: never;
}
export type $defs = Record<string, never>;
export interface operations {
    healthCheck: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Service is healthy */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        /** @example ok */
                        status?: string;
                        /** Format: date-time */
                        timestamp?: string;
                    };
                };
            };
        };
    };
    login: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["LoginRequest"];
            };
        };
        responses: {
            /** @description Authentication successful */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AuthResponse"];
                };
            };
            /** @description Invalid credentials */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    register: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["RegisterRequest"];
            };
        };
        responses: {
            /** @description Registration successful */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["AuthResponse"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    logout: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Logout successful */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        /** @example Logged out successfully */
                        message?: string;
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    authMe: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Authenticated user */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["User"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    socialRedirect: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                provider: "google" | "apple";
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description OAuth redirect URL */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: {
                            /** Format: uri */
                            url?: string;
                        };
                    };
                };
            };
        };
    };
    getUserProfile: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description User profile */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["User"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    updateUserProfile: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["UpdateProfileRequest"];
            };
        };
        responses: {
            /** @description Updated user profile */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["User"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    getStore: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Store details */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Store"];
                    };
                };
            };
            /** @description Store not found */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    updateStore: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["UpdateStoreRequest"];
            };
        };
        responses: {
            /** @description Updated store */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Store"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store not found */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    listStores: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description OK */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StorePublic"][];
                    };
                };
            };
        };
    };
    createStore: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CreateStoreRequest"];
            };
        };
        responses: {
            /** @description Store created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Store"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    getStoreSettings: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Store settings */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreSettings"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store not found */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    updateStoreSettings: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["UpdateStoreSettingsRequest"];
            };
        };
        responses: {
            /** @description Updated store settings */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreSettings"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store not found */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    listItems: {
        parameters: {
            query?: {
                /** @description Full-text search query */
                q?: string;
                /** @description Category slug to filter by */
                category_slug?: string;
                /** @description Filter by brand(s) */
                brand?: string[];
                /** @description Filter by size(s) */
                size?: string[];
                /** @description Filter by condition(s) */
                condition?: ("NWT" | "NWOT" | "EUC" | "GUC" | "Fair" | "Poor")[];
                /** @description Filter by color(s) */
                colors?: string[];
                /** @description Filter by store UUID(s) */
                store_id?: string[];
                min_price?: number;
                max_price?: number;
                sort?: "relevance" | "newest" | "price_asc" | "price_desc" | "popular";
                page?: number;
                per_page?: number;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated list of items with faceted counts */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ItemBrowseResponse"];
                };
            };
        };
    };
    getItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                item: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Item detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ItemDetail"];
                    };
                };
            };
            /** @description Item not found or not active */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    listStoreItems: {
        parameters: {
            query?: {
                status?: "draft" | "active" | "sold" | "removed";
                /** @description Special composite filter. `needs-attention` returns items that need the seller's action (currently: drafts never published). */
                filter?: "needs-attention";
                per_page?: number;
                /** @description Partial match on title or brand. */
                q?: string;
                sort?: "listed_desc" | "listed_asc" | "price_asc" | "price_desc" | "views_desc";
            };
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated list of store items */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["PaginatedItemResponse"];
                };
            };
        };
    };
    createItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CreateItemRequest"];
            };
        };
        responses: {
            /** @description Item created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ItemDetail"];
                    };
                };
            };
        };
    };
    getStoreItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                item: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Item detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ItemDetail"];
                    };
                };
            };
        };
    };
    updateItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                item: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["UpdateItemRequest"];
            };
        };
        responses: {
            /** @description Item updated */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ItemDetail"];
                    };
                };
            };
        };
    };
    deleteItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                item: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Item deleted */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        message?: string;
                    };
                };
            };
        };
    };
    uploadItemImages: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                item: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "multipart/form-data": {
                    images: string[];
                };
            };
        };
        responses: {
            /** @description Images uploaded, returns updated item */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ItemDetail"];
                    };
                };
            };
        };
    };
    removeItemImage: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                item: string;
                mediaId: number;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Image removed */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        message?: string;
                    };
                };
            };
        };
    };
    publishItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                item: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Item published */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ItemDetail"];
                    };
                };
            };
            /** @description Invalid status transition */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    removeItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                item: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Item removed */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ItemDetail"];
                    };
                };
            };
            /** @description Invalid status transition */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    relistItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                item: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Item relisted */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ItemDetail"];
                    };
                };
            };
            /** @description Invalid status transition */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    listCategories: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description OK */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["CategoryTree"][];
                    };
                };
            };
        };
    };
    snapPublishItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "multipart/form-data": components["schemas"]["SnapPublishItemRequest"];
            };
        };
        responses: {
            /** @description Item created and published */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ItemDetail"];
                    };
                };
            };
        };
    };
    listParcelPresets: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Preset list */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ParcelPreset"][];
                    };
                };
            };
        };
    };
    createParcelPreset: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["ParcelPresetInput"];
            };
        };
        responses: {
            /** @description Created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ParcelPreset"];
                    };
                };
            };
        };
    };
    deleteParcelPreset: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                preset: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Deleted */
            204: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Cannot delete last preset */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    updateParcelPreset: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                preset: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["ParcelPresetInput"];
            };
        };
        responses: {
            /** @description Updated */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ParcelPreset"];
                    };
                };
            };
        };
    };
    getCart: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Cart contents */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["CartResponse"];
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    addCartItem: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    /** Format: uuid */
                    item_id: string;
                };
            };
        };
        responses: {
            /** @description Item added to cart */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["CartItemResponse"];
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Item unavailable or already sold */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    removeCartItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                item_id: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Item removed */
            204: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    initiateCheckout: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CheckoutRequest"];
            };
        };
        responses: {
            /** @description Checkout initiated */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["CheckoutResponse"];
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Items unavailable or locked */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["CheckoutConflictResponse"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    cancelCheckout: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                checkout_id: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Checkout cancelled */
            204: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    stripeWebhook: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Webhook processed */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    listPurchases: {
        parameters: {
            query?: {
                page?: number;
                per_page?: number;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Purchase list */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["PurchaseListResponse"];
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    getPurchase: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                purchase_id: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Purchase detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["PurchaseDetailResponse"];
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Purchase not found */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    listStoreOrders: {
        parameters: {
            query?: {
                page?: number;
                per_page?: number;
                /** @description `paid` = pending+processing (not yet shipped). Other values filter by exact enum. */
                status?: "all" | "paid" | "pending" | "processing" | "shipped" | "delivered" | "cancelled" | "refunded" | "disputed";
                /** @description Search across order ID prefix and buyer first/last name. */
                q?: string;
                sort?: "placed_desc" | "placed_asc" | "ship_by_asc" | "ship_by_desc" | "total_asc" | "total_desc";
                /** @description Ship-by bucket. Only meaningful when status=paid. */
                bucket?: "overdue" | "today" | "week";
            };
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Order list */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["OrderListResponse"];
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    getStoreOrder: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                order: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Order detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["OrderDetailResponse"];
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Order not found */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    easypostWebhook: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": Record<string, never>;
            };
        };
        responses: {
            /** @description Accepted */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid signature */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    buyerCancelOrder: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                order: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Order cancelled, items relisted, refund issued */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Order"];
                    };
                };
            };
            /** @description Not this buyer's order */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Cannot cancel from current status */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    sellerCancelOrder: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    /** @enum {string} */
                    reason: "sold_locally" | "item_damaged" | "other";
                    note?: string | null;
                };
            };
        };
        responses: {
            /** @description Order cancelled, items marked removed, refund issued */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Order"];
                    };
                };
            };
            /** @description Order does not belong to this store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Cannot cancel from current status */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid reason */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    buyOrderLabel: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    /** Format: uuid */
                    parcel_preset_id: string;
                };
            };
        };
        responses: {
            /** @description Label purchased, order marked shipped */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Order"];
                    };
                };
            };
            /** @description Order cannot be shipped from current status */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation failure */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Shipping provider error */
            502: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    previewOrderLabel: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    /** Format: uuid */
                    parcel_preset_id: string;
                };
            };
        };
        responses: {
            /** @description List of rate options */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: {
                            id?: string;
                            carrier?: string;
                            service?: string;
                            amount_cents?: number;
                            estimated_days?: number | null;
                        }[];
                    };
                };
            };
            /** @description Order or preset not found / not owned by store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation error or incomplete store ship-from */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    createStripeConnectLink: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Onboarding URL */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: {
                            /** Format: uri */
                            onboarding_url?: string;
                        };
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    getStripeStatus: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Current Connect state for the store */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: {
                            charges_enabled?: boolean;
                            details_submitted?: boolean;
                            dashboard_url?: string | null;
                            onboarding_url?: string | null;
                        };
                    };
                };
            };
        };
    };
    getSellerDashboardMetrics: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Aggregated KPI + action-count payload for the seller dashboard. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["SellerDashboardMetrics"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    getSellerBalance: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Available + pending balance and next payout date for the store. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["SellerBalance"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden (not the store owner) */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    listStorePayouts: {
        parameters: {
            query?: {
                state?: "scheduled" | "in_flight" | "succeeded" | "failed" | "void";
                page?: number;
                per_page?: number;
            };
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated payouts ordered by scheduled_for desc */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Payout"][];
                        meta?: components["schemas"]["PaginationMeta"];
                        links?: components["schemas"]["PaginationLinks"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden (not the store owner) */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    getStorePayout: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                payout: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Payout with the ledger entries it settled */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayoutDetail"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden (not the store owner) */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Payout not found or not in this store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminDashboardMetrics: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Platform metrics */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminDashboardMetrics"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminListStores: {
        parameters: {
            query?: {
                /** @description Search by store name */
                q?: string;
                verified?: true | false;
                sort?: "created_desc" | "created_asc" | "name_asc" | "name_desc";
                page?: number;
                per_page?: number;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated list of stores */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminStoreSummary"][];
                        meta?: components["schemas"]["PaginationMeta"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminShowStore: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Store detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminStoreDetail"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminVerifyStore: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["JustificationBody"];
            };
        };
        responses: {
            /** @description Updated store detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminStoreDetail"];
                    };
                };
            };
            /** @description Store is suspended (must be unsuspended first) */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminSuspendStore: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["JustificationBody"];
            };
        };
        responses: {
            /** @description Updated store detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminStoreDetail"];
                    };
                };
            };
            /** @description Already suspended */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminUnsuspendStore: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["JustificationBody"];
            };
        };
        responses: {
            /** @description Updated store detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminStoreDetail"];
                    };
                };
            };
            /** @description Store is not suspended */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminListOrders: {
        parameters: {
            query?: {
                status?: "all" | "pending" | "processing" | "shipped" | "delivered" | "cancelled" | "refunded";
                store_id?: string;
                sort?: "created_desc" | "created_asc" | "total_desc" | "total_asc";
                page?: number;
                per_page?: number;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated list of orders */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminOrderSummary"][];
                        meta?: components["schemas"]["PaginationMeta"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminShowOrder: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                order: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Order detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminOrderDetail"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminOrderRefund: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["AdminRefundBody"];
            };
        };
        responses: {
            /** @description Updated order detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminOrderDetail"];
                    };
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    adminOrderForceCancel: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["JustificationBody"];
            };
        };
        responses: {
            /** @description Updated order detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminOrderDetail"];
                    };
                };
            };
            /** @description Order is not in a cancellable state */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminOrderReverseTransfer: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["JustificationBody"];
            };
        };
        responses: {
            /** @description Updated order detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminOrderDetail"];
                    };
                };
            };
            /** @description Already reversed */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description No transfer to reverse */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminListDisputes: {
        parameters: {
            query?: {
                status?: "needs_response" | "under_review" | "won" | "lost" | "warning_needs_response" | "warning_under_review" | "warning_closed" | "charge_refunded";
                page?: number;
                per_page?: number;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated dispute list */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminDisputeSummary"][];
                        meta?: components["schemas"]["PaginationMeta"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminShowDispute: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                purchase: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Dispute detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminDisputeDetail"];
                    };
                };
            };
            /** @description No dispute on that purchase */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminAdjudicateDispute: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                purchase: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["AdjudicateRequest"];
            };
        };
        responses: {
            /** @description Updated dispute detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminDisputeDetail"];
                    };
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    adminSubmitEvidence: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                purchase: string;
            };
            cookie?: never;
        };
        requestBody?: {
            content: {
                "application/json": {
                    extra_text?: string;
                };
            };
        };
        responses: {
            /** @description Updated dispute detail */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminDisputeDetail"];
                    };
                };
            };
        };
    };
    adminRetryReversal: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                purchase: string;
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    justification: string;
                };
            };
        };
        responses: {
            /** @description Reversal id */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: {
                            reversal_id?: string;
                        };
                    };
                };
            };
            /** @description Already reversed */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error or no transfer to reverse */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminListActivity: {
        parameters: {
            query?: {
                causer_id?: string;
                subject_type?: "Dispute" | "Order" | "Store" | "User" | "Review" | "ReviewReport";
                /** @description Filter to activity entries whose event name starts with the given prefix (e.g. `review.` matches `review.admin_hidden`, `review.report_resolved_keep`, etc.). */
                event_prefix?: string;
                from?: string;
                to?: string;
                page?: number;
                per_page?: number;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated activity entries */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminActivityEntry"][];
                        meta?: components["schemas"]["PaginationMeta"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminBulkDeleteMessages: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    message_ids: string[];
                };
            };
        };
        responses: {
            /** @description Bulk delete summary. Already-deleted ids are skipped silently. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: {
                            /** @description Messages actually transitioned to soft-deleted by this call. */
                            deleted_count: number;
                            /** @description Distinct ids in the request body. */
                            requested_count: number;
                        };
                    };
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    listStoreSellerReviews: {
        parameters: {
            query?: {
                page?: number;
            };
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated visible reviews. Each review includes a `report_status` rollup so the seller can see whether any of their reviews have been reported and how moderation resolved them. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["SellerReview"][];
                        meta?: components["schemas"]["PaginationMeta"];
                        links?: components["schemas"]["PaginationLinks"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    getStoreSellerRatingSummary: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Store's rating aggregate + distribution + per-dimension averages */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["RatingSummary"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    listStoreReturns: {
        parameters: {
            query?: {
                state?: "requested" | "approved" | "rejected" | "awaiting_shipment" | "in_transit" | "received" | "refunded" | "closed" | "cancelled" | "escalated";
            };
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Returns sorted by updated_at desc */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturnSummary"][];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    listStoreThreads: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Thread summaries sorted by latest activity */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["MessageThreadSummary"][];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    getStoreReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                return: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Return resource */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    approveStoreReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                return: string;
            };
            cookie?: never;
        };
        requestBody?: {
            content: {
                "application/json": components["schemas"]["ApproveReturnRequest"];
            };
        };
        responses: {
            /** @description Approved return; state is `awaiting_shipment` on label success or `approved` with `easypost_label_error` on label failure */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    rejectStoreReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                return: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["RejectReturnRequest"];
            };
        };
        responses: {
            /** @description Rejected return */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state or short reason text */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    markStoreReturnReceived: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                return: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Return moved through received → refunded → closed */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state for mark-received */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    retryStoreReturnLabel: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                return: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Label issued; return moved to awaiting_shipment */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state or no prior label error to retry */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    closeStoreReturnWithoutRefund: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                return: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["SellerCloseReturnRequest"];
            };
        };
        responses: {
            /** @description Return closed without refund */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state or missing reason */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    createStoreProactiveReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["ProactiveRefundRequest"];
            };
        };
        responses: {
            /** @description Return created (state = closed for keep-it, awaiting_shipment for ship-back) */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Order already has an open return */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    listStoreOrderMessages: {
        parameters: {
            query?: {
                /** @description Incremental fetch — return messages created after the given message id. */
                after?: string;
            };
            header?: never;
            path: {
                store: string;
                order: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Message list (full thread) */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Message"][];
                        meta?: {
                            total?: number;
                            has_more?: boolean;
                        };
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    postStoreOrderMessage: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    body: string;
                    attachment_ids?: string[];
                };
            };
        };
        responses: {
            /** @description Message created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Message"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Conversation closed (order cancelled longer than the compose window) */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    uploadStoreMessageAttachment: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "multipart/form-data": {
                    /**
                     * Format: binary
                     * @description JPEG, PNG, or HEIC, up to 5 MB.
                     */
                    file: string;
                };
            };
        };
        responses: {
            /** @description Attachment id (use as element of `attachment_ids` on POST /messages) */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["MessageAttachmentUpload"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    deleteStoreMessage: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                message: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Deleted (or already deleted — endpoint is idempotent) */
            204: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    createStoreReviewReport: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                review: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CreateReviewReportInput"];
            };
        };
        responses: {
            /** @description Report opened; admins notified */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ReviewReport"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store admin capability required; existing action restrictions also apply */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store or child resource not found in the selected scope */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error or eligibility failure */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    listOrderMessages: {
        parameters: {
            query?: {
                /** @description Incremental fetch — return messages created after the given message id. */
                after?: string;
            };
            header?: never;
            path: {
                order: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Message list (full thread) */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Message"][];
                        meta?: {
                            total?: number;
                            has_more?: boolean;
                        };
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Not a participant */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    postOrderMessage: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    body: string;
                    attachment_ids?: string[];
                };
            };
        };
        responses: {
            /** @description Message created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Message"];
                    };
                };
            };
            /** @description Not a participant */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Conversation closed (order cancelled longer than the compose window) */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    deleteMessage: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                message: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Deleted (or already deleted — endpoint is idempotent) */
            204: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Not the author and not an admin */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    uploadMessageAttachment: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "multipart/form-data": {
                    /**
                     * Format: binary
                     * @description JPEG, PNG, or HEIC, up to 5 MB.
                     */
                    file: string;
                };
            };
        };
        responses: {
            /** @description Attachment id (use as element of `attachment_ids` on POST /messages) */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["MessageAttachmentUpload"];
                    };
                };
            };
            /** @description Not a participant */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    listMyThreads: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Thread summaries sorted by latest activity */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["MessageThreadSummary"][];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    createReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CreateReturnRequest"];
            };
        };
        responses: {
            /** @description Return created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation or window/state error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    listMyReturns: {
        parameters: {
            query?: {
                state?: "requested" | "approved" | "rejected" | "awaiting_shipment" | "in_transit" | "received" | "refunded" | "closed" | "cancelled" | "escalated";
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Returns sorted by updated_at desc */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturnSummary"][];
                    };
                };
            };
        };
    };
    getReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                return: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Return resource */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Not found */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    cancelReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                return: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Cancelled return */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state for cancel */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    listSellerReturns: {
        parameters: {
            query?: {
                state?: "requested" | "approved" | "rejected" | "awaiting_shipment" | "in_transit" | "received" | "refunded" | "closed" | "cancelled" | "escalated";
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Returns sorted by updated_at desc */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturnSummary"][];
                    };
                };
            };
        };
    };
    approveReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                return: string;
            };
            cookie?: never;
        };
        requestBody?: {
            content: {
                "application/json": components["schemas"]["ApproveReturnRequest"];
            };
        };
        responses: {
            /** @description Approved return; state is `awaiting_shipment` on label success or `approved` with `easypost_label_error` on label failure */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    rejectReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                return: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["RejectReturnRequest"];
            };
        };
        responses: {
            /** @description Rejected return */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state or short reason text */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    markReturnReceived: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                return: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Return moved through received → refunded → closed */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state for mark-received */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    retryReturnLabel: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                return: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Label issued; return moved to awaiting_shipment */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state or no prior label error to retry */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    createProactiveReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                order: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["ProactiveRefundRequest"];
            };
        };
        responses: {
            /** @description Return created (state = closed for keep-it, awaiting_shipment for ship-back) */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Order already has an open return */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    escalateReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                return: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["EscalateReturnRequest"];
            };
        };
        responses: {
            /** @description Escalation created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ReturnEscalation"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    sellerCloseReturnWithoutRefund: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                return: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["SellerCloseReturnRequest"];
            };
        };
        responses: {
            /** @description Return closed without refund */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturn"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid state or missing reason */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    listAdminReturns: {
        parameters: {
            query?: {
                include_resolved?: boolean;
                state?: "requested" | "approved" | "rejected" | "awaiting_shipment" | "in_transit" | "received" | "refunded" | "closed" | "cancelled" | "escalated";
                page?: number;
                per_page?: number;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Returns with at least one open escalation (default), sortable by updated_at */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["OrderReturnSummary"][];
                        meta?: components["schemas"]["PaginationMeta"];
                        links?: components["schemas"]["PaginationLinks"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    resolveAdminReturn: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                return: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["AdminResolveReturnRequest"];
            };
        };
        responses: {
            /** @description Resolved escalation + updated return */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: {
                            escalation?: components["schemas"]["ReturnEscalation"];
                            return?: components["schemas"]["OrderReturn"];
                        };
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description No open escalation */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminListStoreLedger: {
        parameters: {
            query?: {
                page?: number;
                per_page?: number;
                /** @description Lower bound on `created_at` (ISO 8601 date or date-time) */
                from?: string;
                /** @description Upper bound on `created_at` (date-only inputs are interpreted as end-of-day, inclusive) */
                to?: string;
            };
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated ledger entries ordered by created_at desc */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["LedgerEntry"][];
                        meta?: components["schemas"]["PaginationMeta"];
                        links?: components["schemas"]["PaginationLinks"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminPostStoreLedgerAdjustment: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["AdminLedgerAdjustmentRequest"];
            };
        };
        responses: {
            /** @description Adjustment recorded */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["ManualAdjustment"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation failed */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminFinancialsBalances: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Aggregated balances */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["FinancialsBalance"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminFinancialsListPayouts: {
        parameters: {
            query?: {
                /**
                 * @description Filter by payout state. Pass `all` to disable the state filter. The
                 *     default value is `failed` — the admin queue is primarily concerned
                 *     with payouts that need intervention.
                 */
                state?: "scheduled" | "in_flight" | "succeeded" | "failed" | "void" | "all";
                page?: number;
                per_page?: number;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated admin payouts ordered by scheduled_for desc */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["AdminPayout"][];
                        meta?: components["schemas"]["PaginationMeta"];
                        links?: components["schemas"]["PaginationLinks"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminRetryPayout: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                payout: string;
            };
            cookie?: never;
        };
        requestBody?: {
            content: {
                "application/json": components["schemas"]["AdminPayoutRetryRequest"];
            };
        };
        responses: {
            /** @description Payout retried (resulting state reflects the retry attempt) */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["AdminPayout"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Payout is not in the failed state */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    adminVoidPayout: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                payout: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["AdminPayoutVoidRequest"];
            };
        };
        responses: {
            /** @description Voided payout (state=void, ledger entries unbundled) */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["AdminPayout"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Payout cannot be voided in its current state */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    listStoreLedger: {
        parameters: {
            query?: {
                page?: number;
                per_page?: number;
                /** @description Lower bound on `created_at` (ISO 8601 date or date-time) */
                from?: string;
                /** @description Upper bound on `created_at` (date-only inputs are interpreted as end-of-day, inclusive) */
                to?: string;
            };
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated ledger entries ordered by created_at desc */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["LedgerEntry"][];
                        meta?: components["schemas"]["PaginationMeta"];
                        links?: components["schemas"]["PaginationLinks"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — not the store owner */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    exportStoreStatementsCsv: {
        parameters: {
            query?: {
                from?: string;
                to?: string;
            };
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description CSV file */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "text/csv": string;
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden — not the store owner */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid date in the `from` or `to` query parameter */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    createReview: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                order_item: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["NewReviewInput"];
            };
        };
        responses: {
            /** @description Review created and store aggregate recomputed */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Review"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description A review already exists for this order_item */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error or order not yet delivered */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    uploadReviewAttachment: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                order_item: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "multipart/form-data": {
                    /** Format: binary */
                    file: string;
                };
            };
        };
        responses: {
            /** @description Upload staged; returned id usable as an attachment_ids entry on the review POST */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ReviewAttachmentUpload"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Order not yet delivered */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    updateReview: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                review: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["EditReviewInput"];
            };
        };
        responses: {
            /** @description Review updated and store aggregate recomputed */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Review"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error or edit window expired */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    listMyReviews: {
        parameters: {
            query?: {
                page?: number;
                per_page?: number;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated reviews authored by the current user */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Review"][];
                        meta?: components["schemas"]["PaginationMeta"];
                        links?: components["schemas"]["PaginationLinks"];
                    };
                };
            };
        };
    };
    listStoreReviews: {
        parameters: {
            query?: {
                page?: number;
                per_page?: number;
            };
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated visible reviews for the store */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ReviewSummary"][];
                        meta?: components["schemas"]["PaginationMeta"];
                        links?: components["schemas"]["PaginationLinks"];
                    };
                };
            };
        };
    };
    getStoreRatingSummary: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Store's rating aggregate + distribution + per-dimension averages */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["RatingSummary"];
                    };
                };
            };
        };
    };
    listSellerReviews: {
        parameters: {
            query?: {
                page?: number;
                per_page?: number;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated reviews + the store's aggregate. Each review includes a `report_status` rollup so the seller can see whether any of their reviews have been reported and how moderation resolved them. */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["SellerReview"][];
                        meta?: components["schemas"]["PaginationMeta"];
                        links?: components["schemas"]["PaginationLinks"];
                    };
                };
            };
            /** @description User does not own a store */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    createReviewReport: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                review: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CreateReviewReportInput"];
            };
        };
        responses: {
            /** @description Report opened; admins notified */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ReviewReport"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error or eligibility failure */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    listAdminReviewReports: {
        parameters: {
            query?: {
                state?: "open" | "resolved" | "all";
                page?: number;
                per_page?: number;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated review reports */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ReviewReport"][];
                        meta?: components["schemas"]["PaginationMeta"];
                        links?: components["schemas"]["PaginationLinks"];
                    };
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    resolveAdminReviewReport: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                report: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["ResolveReviewReportInput"];
            };
        };
        responses: {
            /** @description Report resolved (and the underlying review hidden if action = hide); sibling reports auto-resolved with same action */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["ReviewReport"];
                    };
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Already resolved or validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    hideAdminReview: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                review: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["HideReviewInput"];
            };
        };
        responses: {
            /** @description Review hidden, store aggregate recomputed, buyer notified */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Review"];
                    };
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Already hidden or validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    restoreAdminReview: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                review: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["RestoreReviewInput"];
            };
        };
        responses: {
            /** @description Review restored */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Review"];
                    };
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Not currently hidden or validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    adminBulkHideReviews: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["BulkHideReviewsInput"];
            };
        };
        responses: {
            /** @description Bulk hide summary (partial success allowed). */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["BulkHideReviewsResult"];
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error (empty list */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    listAdminStoreReviews: {
        parameters: {
            query?: {
                state?: "visible" | "hidden" | "all";
                page?: number;
                per_page?: number;
            };
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated reviews */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Review"][];
                        meta?: components["schemas"]["PaginationMeta"];
                        links?: components["schemas"]["PaginationLinks"];
                    };
                };
            };
            /** @description Forbidden — admin role required */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    kioskMemberLookup: {
        parameters: {
            query: {
                /** @description Raw US 10/11-digit or E.164; normalized server-side. */
                phone: string;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Lookup result */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: {
                            found: boolean;
                            first_name?: string | null;
                            last_initial?: string | null;
                            loyalty_points?: number | null;
                        };
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
            /** @description Kiosk locked */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Too many requests */
            429: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    kioskCreateBuy: {
        parameters: {
            query?: never;
            header: {
                "Idempotency-Key": string;
            };
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    /** Format: uuid */
                    idempotency_key: string;
                    /** @description Raw US 10/11-digit or E.164 */
                    phone: string;
                    first_name: string;
                    last_name: string;
                    address?: string | null;
                    city?: string | null;
                    state?: string | null;
                    dl_number?: string | null;
                    /** Format: email */
                    email?: string | null;
                    opt_loyalty: boolean;
                    opt_txn: boolean;
                    opt_promo: boolean;
                    terms_version: string;
                    /** @description base64-encoded PNG, max 256 KB decoded */
                    signature_png_base64: string;
                };
            };
        };
        responses: {
            /** @description Idempotent replay of an existing buy (same key + same fingerprint) */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["KioskBuyResponse"];
                };
            };
            /** @description New buy created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["KioskBuyResponse"];
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Idempotency key was previously used with a different request body */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
            /** @description Kiosk locked */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    kioskBuyStatus: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                buy: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Current buy status (narrow payload, no submit fields) */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: {
                            /** @enum {string} */
                            status: "remote_check_in" | "appointment" | "queued" | "sorting" | "sorted" | "in_progress" | "quoted" | "voided" | "no_buy" | "accepted" | "declined";
                            queue_position: number;
                            estimated_wait_minutes: number;
                        };
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Buy not found */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Kiosk locked */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    checkinBranding: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                token: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Store branding */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["CheckinBranding"];
                };
            };
            /** @description Dead or revoked link */
            410: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store not accepting check-ins (suspended/disabled/paused) */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Too many requests */
            429: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    checkinSubmit: {
        parameters: {
            query?: never;
            header: {
                "Idempotency-Key": string;
            };
            path: {
                token: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    /** Format: uuid */
                    idempotency_key: string;
                    /** @description Raw US 10/11-digit or E.164 */
                    phone: string;
                    first_name: string;
                    last_name: string;
                    container_count: number;
                    container_description?: string | null;
                    opt_loyalty: boolean;
                    opt_txn: boolean;
                    opt_promo: boolean;
                    turnstile_token?: string | null;
                };
            };
        };
        responses: {
            /** @description Idempotent replay (same key + same fingerprint) */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["CheckinAccepted"];
                };
            };
            /** @description New check-in created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["CheckinAccepted"];
                };
            };
            /** @description Bot verification failed */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Idempotency key reused with a different body */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Dead or revoked link */
            410: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
            /** @description Store not accepting check-ins */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Too many requests */
            429: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    checkinStatus: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                statusToken: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Check-in status */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["CheckinStatus"];
                };
            };
            /** @description Unknown status token */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Too many requests */
            429: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    posQueue: {
        parameters: {
            query?: {
                /** @description ISO-8601 timestamp; returns only buys with updated_at after this instant. */
                updated_after?: string;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated active queue */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PosQueueItem"][];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Invalid updated_after */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store not active */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    posListCheckins: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Paginated open check-ins */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PosCheckin"][];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store not active */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    posLookupCheckin: {
        parameters: {
            query?: {
                phone?: string;
                code?: string;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Check-in */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PosCheckin"];
                    };
                };
            };
            /** @description No phone or code provided */
            400: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description No matching check-in */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store not active */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    posMarkLabelsPrinted: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                buy: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Updated check-in */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PosCheckin"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Not found / cross-store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store not active */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    posConvertCheckin: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                buy: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    dl_number?: string | null;
                    terms_version: string;
                    /** @description base64-encoded PNG, max 256 KB decoded */
                    signature_png_base64: string;
                };
            };
        };
        responses: {
            /** @description Converted buy */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PosCheckin"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Not found / cross-store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Buy is not awaiting conversion */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
            /** @description Store not active */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    posCompleteBuy: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                buy: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    /** @enum {string} */
                    outcome: "accepted" | "no_buy" | "declined";
                };
            };
        };
        responses: {
            /** @description Completed buy */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PosCheckin"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Not found / cross-store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
            /** @description Store not active */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    posListBuyItems: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                buy: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description The buy's items */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PosBuyItem"][];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Not found / cross-store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store not active */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    posUpsertBuyItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                buy: string;
                /** @description Client-generated UUID for the intake item. */
                item: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    title?: string | null;
                    description?: string | null;
                    brand?: string | null;
                    size?: string | null;
                    /** @description Existing category id; required only at finalize (I15). */
                    category_id?: number | null;
                    /** @enum {string|null} */
                    condition?: "NWT" | "NWOT" | "EUC" | "GUC" | "Fair" | "Poor" | null;
                    /** @description Suggested marketplace price, cents (I14). */
                    listing_price?: number | null;
                    /** @description Cash offered to the customer, cents. */
                    cash_offer?: number | null;
                    /** @description Store-credit alternative, cents. */
                    store_credit_offer?: number | null;
                };
            };
        };
        responses: {
            /** @description Item updated */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PosBuyItem"];
                    };
                };
            };
            /** @description Item materialized */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PosBuyItem"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Not found / cross-store / non-UUID item */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Buy already finalized */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
            /** @description Store not active */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    posDeleteBuyItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                buy: string;
                item: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Item soft-deleted */
            204: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Not found / cross-store / non-UUID item */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Buy already finalized */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Store not active */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    posResolveBuyItem: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                buy: string;
                item: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": {
                    /** @enum {string} */
                    outcome: "accepted" | "declined";
                    /**
                     * @description Required when `outcome=declined`; prohibited otherwise.
                     * @enum {string|null}
                     */
                    disposition?: "returned_to_customer" | "recycled" | null;
                };
            };
        };
        responses: {
            /** @description Resolved item */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PosBuyItem"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Not found / cross-store / non-UUID item */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Item already terminal */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error (missing/forbidden disposition) */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
            /** @description Store not active */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    posFinalizeBuy: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                buy: string;
            };
            cookie?: never;
        };
        requestBody?: {
            content: {
                "application/json": components["schemas"]["FinalizeBuyRequest"];
            };
        };
        responses: {
            /** @description Finalized buy (terminal status set; totals recorded) */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PosCheckin"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Not found / cross-store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description An item is unresolved */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
            /** @description Store not active */
            423: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    resolveStorefrontDomain: {
        parameters: {
            query: {
                /** @description Hostname to resolve. Scheme, port and path are stripped. */
                hostname: string;
            };
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Resolved storefront */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StorefrontResolution"];
                    };
                };
            };
            /** @description No verified domain matches this hostname */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    getStorefront: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store slug — the public address of the storefront */
                slug: components["parameters"]["StorefrontSlug"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Storefront shell */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StorefrontShell"];
                    };
                };
            };
            /** @description No published storefront at this slug */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    getStorefrontPage: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store slug — the public address of the storefront */
                slug: components["parameters"]["StorefrontSlug"];
                /** @description Page slug, e.g. `home`, `about`, `hours`. */
                pageSlug: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Storefront page */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StorefrontPage"];
                        meta?: {
                            storefront?: components["schemas"]["StorefrontShell"];
                        };
                    };
                };
            };
            /** @description Page not found or not published */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    getStoreSite: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Store site */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreSite"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    updateStoreSite: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["UpdateStoreSiteRequest"];
            };
        };
        responses: {
            /** @description Updated site */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreSite"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    updateStoreSlug: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["UpdateStoreSlugRequest"];
            };
        };
        responses: {
            /** @description Updated site */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreSite"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Slug is malformed, reserved or taken */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    listStoreSitePages: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Pages in nav order */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreSitePage"][];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    createStoreSitePage: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CreateStoreSitePageRequest"];
            };
        };
        responses: {
            /** @description Page created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreSitePage"];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    reorderStoreSitePages: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["ReorderStoreSitePagesRequest"];
            };
        };
        responses: {
            /** @description Pages in the new order */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreSitePage"][];
                    };
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    updateStoreSitePage: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                /** @description Store site page UUID */
                page: components["parameters"]["StoreSitePageId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["UpdateStoreSitePageRequest"];
            };
        };
        responses: {
            /** @description Updated page */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreSitePage"];
                    };
                };
            };
            /** @description Page not found on this store's site */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Validation error */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    deleteStoreSitePage: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                /** @description Store site page UUID */
                page: components["parameters"]["StoreSitePageId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Page deleted */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        message?: string;
                    };
                };
            };
            /** @description Page not found on this store's site */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
            /** @description Page cannot be deleted */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    listStoreDomains: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Domains */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreDomain"][];
                    };
                };
            };
            /** @description Forbidden */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    createStoreDomain: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CreateStoreDomainRequest"];
            };
        };
        responses: {
            /** @description Domain claimed, pending verification */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreDomain"];
                    };
                };
            };
            /** @description Hostname is malformed, reserved, already claimed, or over the per-store cap */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    deleteStoreDomain: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                /** @description Store domain UUID */
                domain: components["parameters"]["StoreDomainId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Domain removed */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        message?: string;
                    };
                };
            };
            /** @description Domain not found on this store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    verifyStoreDomain: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                /** @description Store domain UUID */
                domain: components["parameters"]["StoreDomainId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Domain verified */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreDomain"];
                        meta?: {
                            verified?: boolean;
                        };
                    };
                };
            };
            /** @description TXT record missing or mismatched */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreDomain"];
                        meta?: {
                            verified?: boolean;
                        };
                    };
                };
            };
            /** @description Too many verification attempts for this store */
            429: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ApiError"];
                };
            };
        };
    };
    makeStoreDomainPrimary: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                /** @description Store domain UUID */
                domain: components["parameters"]["StoreDomainId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Domain promoted */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreDomain"];
                    };
                };
            };
            /** @description Domain is not verified */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ValidationError"];
                };
            };
        };
    };
    listMyMemberships: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Membership list */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Membership"][];
                    };
                };
            };
        };
    };
    listStoreMembers: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Roster */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreMember"][];
                    };
                };
            };
            /** @description Viewer lacks team.view */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    terminateStoreMember: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                /** @description Store membership UUID */
                membership: components["parameters"]["MembershipId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Terminated */
            204: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Capability or target-rank rule violated */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Membership does not belong to this store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    updateStoreMember: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                /** @description Store membership UUID */
                membership: components["parameters"]["MembershipId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["MembershipUpdateInput"];
            };
        };
        responses: {
            /** @description Updated */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["StoreMember"];
                    };
                };
            };
            /** @description Capability or target-rank rule violated */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Membership does not belong to this store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    listMemberPayRates: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                /** @description Store membership UUID */
                membership: components["parameters"]["MembershipId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Pay-rate history, newest first */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["PayRate"][];
                    };
                };
            };
            /** @description Viewer lacks pay.view */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Membership does not belong to this store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    createMemberPayRate: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                /** @description Store membership UUID */
                membership: components["parameters"]["MembershipId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["PayRateInput"];
            };
        };
        responses: {
            /** @description Created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["PayRate"];
                    };
                };
            };
            /** @description Viewer lacks pay.manage */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Membership does not belong to this store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    listStoreInvitations: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Pending invitations */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Invitation"][];
                    };
                };
            };
            /** @description Viewer lacks team.manage */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    createStoreInvitation: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["InvitationInput"];
            };
        };
        responses: {
            /** @description Created (token is emailed, never returned) */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Invitation"];
                    };
                };
            };
            /** @description Capability or inviter-rank rule violated */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description default_position_id does not belong to this store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description That person already has a membership at this store */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    revokeStoreInvitation: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                /** @description Store invitation UUID */
                invitation: components["parameters"]["InvitationId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Revoked */
            204: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invitation does not belong to this store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description An accepted invitation cannot be revoked */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    acceptInvitation: {
        parameters: {
            query?: never;
            header?: never;
            path?: never;
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["InvitationAcceptInput"];
            };
        };
        responses: {
            /** @description Accepted — membership created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Membership"];
                    };
                };
            };
            /** @description The caller already has a membership at this store */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid, expired, revoked, or wrong-account token */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    listStorePositions: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Position list */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Position"][];
                    };
                };
            };
            /** @description Not a member of this store */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    createStorePosition: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["PositionInput"];
            };
        };
        responses: {
            /** @description Created */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Position"];
                    };
                };
            };
            /** @description Viewer lacks schedule.manage */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    updateStorePosition: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                /** @description Store UUID */
                store: components["parameters"]["StoreId"];
                /** @description Store position UUID */
                position: components["parameters"]["PositionId"];
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["PositionUpdateInput"];
            };
        };
        responses: {
            /** @description Updated */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data?: components["schemas"]["Position"];
                    };
                };
            };
            /** @description Viewer lacks schedule.manage */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Position does not belong to this store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    getScheduleSettings: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["ScheduleSettings"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing capability or real active self membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store, settings, or nested child not found in store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Exact revision stale, assigned shift overlap, copy conflict, or immutable payroll history */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid fields, inactive assignee/position, invalid interval or same normalized copy week */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    updateScheduleSettings: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["UpdateScheduleSettings"];
            };
        };
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["ScheduleSettings"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing capability or real active self membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store, settings, or nested child not found in store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Exact revision stale, assigned shift overlap, copy conflict, or immutable payroll history */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid fields, inactive assignee/position, invalid interval or same normalized copy week */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    getScheduleWeek: {
        parameters: {
            query: {
                /** @description Local date label, normalized to configured start day; not an instant. */
                week_start: string;
                position_id?: string;
            };
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["ScheduleWeek"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing capability or real active self membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store, settings, or nested child not found in store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Exact revision stale, assigned shift overlap, copy conflict, or immutable payroll history */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid fields, inactive assignee/position, invalid interval or same normalized copy week */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    getMySchedule: {
        parameters: {
            query: {
                /** @description Local date label, normalized to configured start day; not an instant. */
                week_start: string;
                position_id?: string;
            };
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["ScheduleWeek"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing capability or real active self membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store, settings, or nested child not found in store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Exact revision stale, assigned shift overlap, copy conflict, or immutable payroll history */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid fields, inactive assignee/position, invalid interval or same normalized copy week */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    createScheduleShift: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CreateShift"];
            };
        };
        responses: {
            /** @description Success */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["Shift"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing capability or real active self membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store, settings, or nested child not found in store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Exact revision stale, assigned shift overlap, copy conflict, or immutable payroll history */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid fields, inactive assignee/position, invalid interval or same normalized copy week */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    deleteScheduleShift: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                shift: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["DeleteShift"];
            };
        };
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["ScheduleDeleted"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing capability or real active self membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store, settings, or nested child not found in store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Exact revision stale, assigned shift overlap, copy conflict, or immutable payroll history */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid fields, inactive assignee/position, invalid interval or same normalized copy week */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    updateScheduleShift: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                shift: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["UpdateShift"];
            };
        };
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["Shift"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing capability or real active self membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store, settings, or nested child not found in store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Exact revision stale, assigned shift overlap, copy conflict, or immutable payroll history */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid fields, inactive assignee/position, invalid interval or same normalized copy week */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    publishScheduleWeek: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["ScheduleWeekSelection"];
            };
        };
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["ScheduleWeek"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing capability or real active self membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store, settings, or nested child not found in store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Exact revision stale, assigned shift overlap, copy conflict, or immutable payroll history */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid fields, inactive assignee/position, invalid interval or same normalized copy week */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    unpublishScheduleWeek: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["ScheduleWeekSelection"];
            };
        };
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["ScheduleWeek"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing capability or real active self membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store, settings, or nested child not found in store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Exact revision stale, assigned shift overlap, copy conflict, or immutable payroll history */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid fields, inactive assignee/position, invalid interval or same normalized copy week */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    copyScheduleWeek: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CopyScheduleWeek"];
            };
        };
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["CopyScheduleWeekResult"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing capability or real active self membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store, settings, or nested child not found in store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Exact revision stale, assigned shift overlap, copy conflict, or immutable payroll history */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid fields, inactive assignee/position, invalid interval or same normalized copy week */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    getMyClock: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Current authoritative clock state */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ClockEnvelope"];
                };
            };
            /** @description No active membership at this store */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Historical punch sequence requires manager repair */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    actOnMyClock: {
        parameters: {
            query?: never;
            header: {
                "Idempotency-Key": string;
            };
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["ClockIntent"];
            };
        };
        responses: {
            /** @description Applied or exact durable replay (refetch GET for current state) */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["ClockEnvelope"];
                };
            };
            /** @description Membership inactive or absent; even old replay keys require active membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Stale state revision, key/hash conflict, same-second action, or frozen payroll period */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid intent, missing idempotency key, spoofed identity/time, invalid break, or require_manager_override clock window */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    listTimePunches: {
        parameters: {
            query: {
                store_membership_id: string;
                from: string;
                to: string;
            };
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Bounded member punch list */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["TimePunch"][];
                    };
                };
            };
            /** @description Missing punches.manage capability */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Membership does not belong to store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid or unbounded dates */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    createTimePunch: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["CreateTimePunch"];
            };
        };
        responses: {
            /** @description Created manual punch and recalculated pending payroll */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["TimePunchEnvelope"];
                };
            };
            /** @description Missing punches.manage capability */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Membership or shift tenant/assignment mismatch */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Frozen payroll period or duplicate type/second */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid chronology, break type, note or timestamp */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    deleteTimePunch: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                punch: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["DeleteTimePunch"];
            };
        };
        responses: {
            /** @description Deleted */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: {
                            /** @constant */
                            deleted: true;
                        };
                    };
                };
            };
            /** @description Missing punches.manage capability */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Punch is missing, deleted or belongs to another store */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Stale revision or frozen payroll */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Note/revision absent or deletion invalidates sequence */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    updateTimePunch: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                punch: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["UpdateTimePunch"];
            };
        };
        responses: {
            /** @description Updated punch and recalculated pending payroll */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": components["schemas"]["TimePunchEnvelope"];
                };
            };
            /** @description Missing punches.manage capability */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Punch or supplied shift tenant mismatch */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Stale revision, duplicate type/second or frozen payroll */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Invalid correction or resulting chronological lifecycle */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    listPayrollTimesheets: {
        parameters: {
            query: {
                week_start: string;
            };
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayrollTimesheet"][];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing store capability or real membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store/resource missing or cross-store child */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Locked/stale period, already exported, request-hash conflict, or corrupt immutable snapshot */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation or punch guard failure. errors.stranded_clock_ins hard-blocks all open sessions, errors.oversized_sessions requires explicit acknowledgement. */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    recalculatePayrollTimesheets: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["PayrollWeekRequest"];
            };
        };
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayrollTimesheet"][];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing store capability or real membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store/resource missing or cross-store child */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Locked/stale period, already exported, request-hash conflict, or corrupt immutable snapshot */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation or punch guard failure. errors.stranded_clock_ins hard-blocks all open sessions, errors.oversized_sessions requires explicit acknowledgement. */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    getPayrollTimesheet: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                timesheet: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayrollTimesheet"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing store capability or real membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store/resource missing or cross-store child */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Locked/stale period, already exported, request-hash conflict, or corrupt immutable snapshot */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation or punch guard failure. errors.stranded_clock_ins hard-blocks all open sessions, errors.oversized_sessions requires explicit acknowledgement. */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    approvePayrollTimesheet: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                timesheet: string;
            };
            cookie?: never;
        };
        requestBody?: {
            content: {
                "application/json": components["schemas"]["PayrollApprovalRequest"];
            };
        };
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayrollTimesheet"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing store capability or real membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store/resource missing or cross-store child */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Locked/stale period, already exported, request-hash conflict, or corrupt immutable snapshot */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation or punch guard failure. errors.stranded_clock_ins hard-blocks all open sessions, errors.oversized_sessions requires explicit acknowledgement. */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    unlockPayrollTimesheet: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                timesheet: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayrollTimesheet"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing store capability or real membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store/resource missing or cross-store child */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Locked/stale period, already exported, request-hash conflict, or corrupt immutable snapshot */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation or punch guard failure. errors.stranded_clock_ins hard-blocks all open sessions, errors.oversized_sessions requires explicit acknowledgement. */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    getMyPayrollTimesheets: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayrollTimesheet"][];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing store capability or real membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store/resource missing or cross-store child */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Locked/stale period, already exported, request-hash conflict, or corrupt immutable snapshot */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation or punch guard failure. errors.stranded_clock_ins hard-blocks all open sessions, errors.oversized_sessions requires explicit acknowledgement. */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    listPayrollExports: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayrollExport"][];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing store capability or real membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store/resource missing or cross-store child */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Locked/stale period, already exported, request-hash conflict, or corrupt immutable snapshot */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation or punch guard failure. errors.stranded_clock_ins hard-blocks all open sessions, errors.oversized_sessions requires explicit acknowledgement. */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    createPayrollExport: {
        parameters: {
            query?: never;
            header: {
                "Idempotency-Key": string;
            };
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["PayrollExportRequest"];
            };
        };
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayrollExport"];
                    };
                };
            };
            /** @description Success */
            201: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayrollExport"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing store capability or real membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store/resource missing or cross-store child */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Locked/stale period, already exported, request-hash conflict, or corrupt immutable snapshot */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation or punch guard failure. errors.stranded_clock_ins hard-blocks all open sessions, errors.oversized_sessions requires explicit acknowledgement. */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    downloadPayrollExport: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
                export: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Immutable UTF-8 RFC4180 CSV; formula-leading text neutralized; blank pay means missing rates */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "text/csv": string;
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing store capability or real membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store/resource missing or cross-store child */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Locked/stale period, already exported, request-hash conflict, or corrupt immutable snapshot */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation or punch guard failure. errors.stranded_clock_ins hard-blocks all open sessions, errors.oversized_sessions requires explicit acknowledgement. */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    listPayrollOvertimeRules: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody?: never;
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayrollOvertimeRuleHistory"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing store capability or real membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store/resource missing or cross-store child */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Locked/stale period, already exported, request-hash conflict, or corrupt immutable snapshot */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation or punch guard failure. errors.stranded_clock_ins hard-blocks all open sessions, errors.oversized_sessions requires explicit acknowledgement. */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
    setPayrollOvertimeRules: {
        parameters: {
            query?: never;
            header?: never;
            path: {
                store: string;
            };
            cookie?: never;
        };
        requestBody: {
            content: {
                "application/json": components["schemas"]["PayrollOvertimeRuleInput"];
            };
        };
        responses: {
            /** @description Success */
            200: {
                headers: {
                    [name: string]: unknown;
                };
                content: {
                    "application/json": {
                        data: components["schemas"]["PayrollOvertimeRule"];
                    };
                };
            };
            /** @description Unauthenticated */
            401: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Missing store capability or real membership */
            403: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Store/resource missing or cross-store child */
            404: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Locked/stale period, already exported, request-hash conflict, or corrupt immutable snapshot */
            409: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
            /** @description Validation or punch guard failure. errors.stranded_clock_ins hard-blocks all open sessions, errors.oversized_sessions requires explicit acknowledgement. */
            422: {
                headers: {
                    [name: string]: unknown;
                };
                content?: never;
            };
        };
    };
}