@zenky/storefront-vue 0.9.46 → 0.10.0

package/dist/cart/index.d.ts

@@ -0,0 +1,559 @@
+import { ProductModifiersRequest, OrderProductVariant, PaymentMethod, OrderPaymentMethodRequest, OrderAuthenticationMethod, OrderCredentials, Order, OrderCheckoutTotal, OrderSettings, OrderPaymentMethod, OrderDeliveryMethod, InclusionRequest, ZenkyStorefront, SetOrderCustomerRequest, SetOrderDeliveryRequest, OrderPromocode, OrderCheckoutResult, RecaptchaAction } from '@zenky/storefront-api';
+import { ComputedRef, MaybeRefOrGetter, Ref } from 'vue';
+import { ActivityReporter, Notifier, Result } from '../ports/index.js';
+import '@zenky/integrations-sdk';
+
+/** WebSocket события канала заказа */
+declare const ORDER_EVENTS: {
+    readonly PriceRecalculated: "orders.price.recalculated";
+    readonly Reload: "orders.reload";
+    readonly Submitted: "orders.submitted";
+    readonly Repeated: "orders.repeated";
+    readonly PromotionsNotFound: "orders.promotions.not_found";
+    readonly RewardsDisplaySelection: "orders.rewards.display_selection";
+    readonly RewardsReload: "orders.rewards.reload";
+};
+
+/** Нормализация строки адреса для сравнения (lowercase, схлопывание запятых/пробелов). */
+declare function normalizeAddress(value: string | null | undefined): string;
+
+interface CartLineKeyParams {
+    productVariantId: string;
+    modifiers?: ProductModifiersRequest[];
+    promotionId?: string;
+    promotionRewardId?: string;
+}
+/** Детерминированный ключ строки корзины: variant + sorted modifiers + promotion. */
+declare function buildCartLineKey(params: CartLineKeyParams): string;
+declare function variantLineKey(variant: OrderProductVariant): string;
+
+interface MainPaymentRequestParams {
+    method: PaymentMethod | null;
+    billMinor: number | null;
+    cardTokenId: string | null;
+    saveCard: boolean;
+    currency: string;
+}
+/**
+ * Основной (не-бонусный) payment-request из выбранного способа оплаты.
+ * Единый источник для UI и reconciliation; `bill` конвертируется minor→major здесь.
+ */
+declare function buildMainPaymentRequest(params: MainPaymentRequestParams): OrderPaymentMethodRequest | null;
+
+/**
+ * Утилиты для построения пресетов «с какой суммы приготовить сдачу» (cash bill)
+ * в минорных единицах валюты (копейки/тыйны/сатанги).
+ *
+ * UI отображает пресеты как пилюли: «1100 ₽», «1500 ₽», «5000 ₽» и т.п.
+ */
+/**
+ * Номиналы банкнот по странам в **мажорных** единицах валюты.
+ * Набор банкнот зависит от страны (рубли РФ ≠ тенге KZ), а конвертация
+ * мажор → минор — от валюты (через `majorToMinor`, который сам учитывает
+ * число дробных знаков по ISO-коду). Поэтому `getCashDenominationsMinor`
+ * принимает и страну (выбор набора), и валюту (фактор конвертации).
+ */
+declare const CASH_DENOMINATIONS_MAJOR: Record<string, number[]>;
+/**
+ * Шаги округления вверх в **мажорных** единицах: 10 / 50 / 100 / 200 / 500 / 1000.
+ * Конвертируются в минорные по валюте через `getDefaultRoundStepsMinor` —
+ * чтобы работать для валют с любым числом дробных знаков, а не только ×100.
+ */
+declare const DEFAULT_ROUND_STEPS_MAJOR: readonly number[];
+declare function getDefaultRoundStepsMinor(currency?: string): number[];
+/** Номиналы в минорных единицах для страны магазина (с фолбэком на RU). */
+declare function getCashDenominationsMinor(country: string | null | undefined, currency?: string): number[];
+interface CashChangePresetsOptions {
+    /** Сумма заказа в минорных единицах. */
+    totalMinor: number;
+    /** Номиналы банкнот в минорных единицах (см. `getCashDenominationsMinor`). */
+    denominationsMinor: number[];
+    /** Шаги округления — переопределяй только если знаешь зачем. */
+    roundStepsMinor?: readonly number[];
+}
+/**
+ * Строит пресеты сдачи в минорных единицах:
+ * объединяем округлённые вверх суммы (до 10/50/100/200/500/1000) и все
+ * банкноты > total, дедупим, сортируем по возрастанию.
+ *
+ * Округления — strict (`total + 1`), чтобы сдача всегда была > 0.
+ *
+ * Примеры (для RU, total в рублях для краткости):
+ *   total = 1080: 1090 / 1100 / 1200 / 1500 / 2000 / 5000 / 10000
+ *   total = 1130: 1140 / 1150 / 1200 / 1500 / 2000 / 5000 / 10000
+ *   total = 3060: 3070 / 3100 / 3200 / 3500 / 4000 / 5000 / 10000
+ *   total = 3982: 3990 / 4000 / 5000 / 10000
+ *   total = 0:    все банкноты как есть.
+ */
+declare function buildCashChangePresets({ totalMinor, denominationsMinor, roundStepsMinor, }: CashChangePresetsOptions): number[];
+
+/**
+ * Единый формат логов ошибок для всех cart/checkout-операций + извлечение
+ * читаемых сообщений из ZenkyError для UI (toast / inline).
+ *
+ * Контракт ошибок Zenky API (см. `ApiError` в SDK):
+ *   {
+ *     err: {
+ *       message: string,             // локализованное — "Адрес доставки не указан."
+ *       original_message: string,    // англ. оригинал
+ *       http_code: number,
+ *       error_code: string,          // 'addresses.not_specified' | 'validation' | etc.
+ *       meta: any,                   // для validation: { errors: { [field]: string[] } }
+ *     }
+ *   }
+ *
+ * Для validation-ошибок (`error_code === 'validation'`) — берём сообщения из
+ * `meta.errors`, не верхнеуровневое generic сообщение.
+ */
+interface CartErrorScope {
+    /** Префикс — operation name (`cart-add` / `delivery` / `promocode-apply` / etc.) */
+    scope: string;
+    /** Параметры операции — id'шники, входы, что в данный момент в credentials */
+    context?: Record<string, unknown>;
+}
+/**
+ * Залогировать ошибку cart/checkout-операции в едином формате.
+ * Безопасно для любого `unknown` — не падает на не-ZenkyError ошибках.
+ */
+declare function logCartError({ scope, context }: CartErrorScope, e: unknown): void;
+/**
+ * Достаёт `error_code` бэка (например `addresses.not_specified`).
+ * Возвращает undefined для не-Zenky ошибок.
+ */
+declare function getCartErrorCode(e: unknown): string | undefined;
+/**
+ * Достаёт HTTP-код бэка (например 401 для требующей авторизации операции).
+ * Возвращает undefined для не-Zenky ошибок.
+ */
+declare function getCartErrorHttpCode(e: unknown): number | undefined;
+/**
+ * Достаёт field → [messages] из ZenkyError для валидации.
+ * Возвращает {} если ошибка не validation или meta.errors пусто.
+ */
+declare function getValidationErrors(e: unknown): Record<string, string[]>;
+/**
+ * Вытащить читаемое сообщение для UI (toast / inline).
+ *
+ * Приоритет:
+ *  1. Если validation-ошибка → склеиваем все сообщения из `meta.errors` (по всем полям)
+ *  2. Иначе — `err.message` (generic от бэка)
+ *  3. Иначе — `fallback`
+ */
+declare function getCartErrorMessage(e: unknown, fallback: string): string;
+
+/**
+ * Race-safe выполнение мутаций корзины.
+ *
+ * Проблема: SDK Zenky не поддерживает AbortSignal — нельзя физически отменить
+ * запрос на полпути. Если пользователь быстро жмёт `+ → доставка → оплата`,
+ * ответы могут прийти в произвольном порядке и устаревший ответ перепишет
+ * свежее состояние (race condition).
+ *
+ * Решение: версионирование per-kind. У каждого вида операции свой счётчик —
+ * новый вызов инкрементирует его, после await callback проверяет «я ещё актуален?»
+ * через `isStale()`. Если устарел — side-effect (`cartStore.setOrder`) пропускается.
+ * HTTP-запрос всё равно завершается на бэке (минорный overhead), но фронт
+ * игнорирует результат → race гарантированно не пройдёт.
+ *
+ * Дополнительно — debounce per-kind. Быстрые подряд клики «++++» схлопываются
+ * в один запрос после паузы.
+ *
+ * Состояние версий общее для composables одного storefront runtime, но изолировано
+ * между SSR-запросами и отдельными Vue-приложениями.
+ */
+/**
+ * `cart-line-${lineKey}` — динамический ключ строки корзины: add и remove одной
+ * строки делят kind, т.к. конфликтуют по одному ресурсу.
+ */
+type MutationKind = 'delivery' | 'delivery-settle' | 'payment' | 'promocode' | 'bonuses' | 'customer' | 'total' | 'settings' | 'checkout' | `cart-line-${string}`;
+interface MutationOptions {
+    /** Уникальный kind — мутации одного kind заменяют друг друга */
+    kind: MutationKind;
+    /** Debounce в мс перед отправкой (0 = без debounce) */
+    debounce?: number;
+}
+interface CartMutationComposable {
+    /**
+     * Запустить мутацию. Внутри callback'а можно делать side-effect только
+     * если `isStale()` вернул `false` — иначе старый результат затрёт свежий.
+     *
+     * Возвращает результат `fn` или `undefined` если был stale.
+     *
+     * @example
+     *   await run({ kind: 'payment', debounce: 300 }, async (isStale) => {
+     *     const order = await sdk.orders.setOrderPayments(...)
+     *     if (isStale()) return  // Пришёл новый клик — наш результат устарел
+     *     cartStore.setOrder(order)
+     *     return order
+     *   })
+     */
+    run: <T>(options: MutationOptions, fn: (isStale: () => boolean) => Promise<T>) => Promise<T | undefined>;
+    /** Получить текущую версию kind'а — для тестов / отладки */
+    getVersion: (kind: MutationKind) => number;
+    /**
+     * Bump-нуть версии всех kind с указанным префиксом — все in-flight операции,
+     * матчащие префикс, станут stale и их side-effect'ы будут проигнорированы.
+     *
+     * Используется при `clearAndResetCart` / `logout` — отменить все pending
+     * мутации старого заказа, чтобы поздние ответы не записались в свежий стейт.
+     */
+    bumpKindsWithPrefix: (prefix: string) => void;
+}
+declare function useCartMutation(): CartMutationComposable;
+
+interface CartQuantities {
+    getProductQuantity: (productId: string) => ComputedRef<number>;
+    getVariantQuantity: (productVariantId: MaybeRefOrGetter<string | null>, modifiers: MaybeRefOrGetter<ProductModifiersRequest[]>) => ComputedRef<number>;
+}
+declare function useCartQuantities(): CartQuantities;
+
+interface CheckoutFlowFlags {
+    /** Режим из настроек магазина (Disabled / Preauth / Confirmation) */
+    mode: ComputedRef<OrderAuthenticationMethod>;
+    /** Нужна авторизация перед submit (открывается AuthModal вместо checkoutOrder) */
+    needsAuth: ComputedRef<boolean>;
+    /** Нужно показать CustomerForm в корзине (phone + name) */
+    needsCustomerForm: ComputedRef<boolean>;
+}
+/**
+ * Определяет поведение чекаута в зависимости от настроек магазина.
+ *
+ * Матрица:
+ *   ┌──────────────┬──────────┬──────────────────┐
+ *   │ mode         │ needsAuth│ needsCustomerForm│
+ *   ├──────────────┼──────────┼──────────────────┤
+ *   │ Preauth      │ true     │ false            │
+ *   │ Confirmation │ false    │ true  (гости)    │
+ *   │ Disabled     │ false    │ true  (гости)    │
+ *   └──────────────┴──────────┴──────────────────┘
+ *
+ * Нужна ли SMS-подтверждение — фронт не вычисляет: бэк возвращает
+ * `confirmation.required` в ответе `checkoutOrder`, и UI реагирует на него.
+ *
+ * Примечание: `needsCustomerForm` сейчас возвращает true для гостей во всех
+ * режимах кроме Preauth. Для авторизованных клиентов форма не нужна
+ * (данные автозаполняются через authStore).
+ */
+declare function useCheckoutFlow(): CheckoutFlowFlags;
+
+interface CartCredentials {
+    orderIdCookie: Ref<string | null>;
+    orderTokenCookie: Ref<string | null>;
+    getStoreId: () => string;
+    getCityId: () => string;
+    getApiToken: () => string | undefined;
+    buildCredentials: (orderId: string, orderToken: string) => OrderCredentials;
+    getCredentials: () => OrderCredentials;
+    persistCredentials: (savedOrder: Order) => void;
+    clearPersistedCredentials: () => void;
+    isOrderActive: (order: Order) => boolean;
+}
+/**
+ * Управление credentials заказа. Персистенс order-id/token — через порт `storage`
+ * (ядро не знает про useCookie). Рефы инициализируются из storage, persist пишет в оба.
+ */
+declare function useCartCredentials(): CartCredentials;
+
+interface OrderTotal {
+    total: ComputedRef<OrderCheckoutTotal | null>;
+    loading: Ref<boolean>;
+    fetchTotal: () => Promise<void>;
+}
+declare function useOrderTotal(): OrderTotal;
+
+interface OrderSettingsComposable {
+    /** Полный снепшот настроек — читается из `cartStore.orderSettings` */
+    settings: ComputedRef<OrderSettings | null>;
+    paymentMethods: ComputedRef<OrderPaymentMethod[]>;
+    deliveryMethods: ComputedRef<OrderDeliveryMethod[]>;
+    loading: Ref<boolean>;
+    /**
+     * Перезапросить настройки с бэка. Вызывается:
+     * - при старте (через useCartInitialization)
+     * - после setOrderDeliveryMethod (набор payment-методов меняется от доставки)
+     */
+    fetchSettings: () => Promise<void>;
+}
+declare function useOrderSettings(): OrderSettingsComposable;
+
+interface OrderCredentialsLike {
+    id: string;
+    token?: string | null;
+}
+interface RetryOptions {
+    /**
+     * ID существующей online-payment транзакции (`order.payments[].id` где
+     * `is_online === true && status === 'pending'`). Используется как fallback
+     * если основной retry-эндпоинт вернул ошибку (typically 409
+     * `order_is_not_submitted` для свежих pending-заказов).
+     */
+    transactionId?: string | null;
+    /**
+     * Куда вернуть юзера после оплаты. По дефолту `window.location.href` —
+     * на success-странице это правильно (вернёт обратно на success), но
+     * со страницы заказа `/me/orders/[id]` лучше передать success-URL явно,
+     * иначе после оплаты юзер останется на странице заказа без `?payment=`
+     * query и не увидит результат оплаты.
+     */
+    currentUrl?: string;
+}
+/**
+ * Повторная попытка онлайн-оплаты заказа.
+ *
+ * **Стратегия (двухуровневая)**:
+ * 1. `sdk.orders.retryOnlinePayment` — официальный retry-эндпоинт (submitted-заказы).
+ * 2. `getOnlinePaymentRedirect(transactionId)` — fallback для pending-заказов (409
+ *    `order_is_not_submitted`).
+ *
+ * Возвращает `redirect_url` или `null` если оба способа упали.
+ */
+declare function useOnlinePaymentRetry(): {
+    retry(creds: OrderCredentialsLike, options?: RetryOptions): Promise<string | null>;
+};
+
+declare function useCartAddressSync(): void;
+
+declare const ORDER_WITH: InclusionRequest;
+interface CartInitialization {
+    initializeOrder: () => Promise<void>;
+}
+declare function useCartInitialization(credentials: CartCredentials, sdk: ZenkyStorefront): CartInitialization;
+
+interface OrderBonusesComposable {
+    maxAvailable: ComputedRef<number>;
+    apply: (additionalPayments?: OrderPaymentMethodRequest[], pin?: string, amount?: number) => Promise<void>;
+    remove: (mainPayment: OrderPaymentMethodRequest | null) => Promise<void>;
+}
+interface OrderBonusesDeps {
+    activity?: ActivityReporter;
+}
+declare function useOrderBonuses(deps?: OrderBonusesDeps): OrderBonusesComposable;
+
+interface PaymentSelection {
+    method: PaymentMethod;
+    bill?: number | null;
+    save_card?: boolean;
+    card_token_id?: string | null;
+}
+interface PaymentSelectionComposable {
+    setPayment: (selection: PaymentSelection) => Promise<void>;
+    syncPaymentNow: (selection: PaymentSelection) => Promise<void>;
+    clearPayments: () => Promise<void>;
+}
+declare function usePaymentSelection(): PaymentSelectionComposable;
+
+interface BonusesReconciliation {
+    reconcileAfterOrderChange: () => Promise<void>;
+}
+interface BonusesReconciliationDeps {
+    notifier: Notifier;
+    activity?: ActivityReporter;
+}
+/** Headless-синхронизация применённых бонусов после order-change (от server-state + intent). */
+declare function useBonusesReconciliation(deps: BonusesReconciliationDeps): BonusesReconciliation;
+
+interface CartRecalculation {
+    recalculateAfterOrderChange: () => Promise<void>;
+}
+interface CartRecalculationDeps {
+    notifier: Notifier;
+    activity?: ActivityReporter;
+}
+/**
+ * Orchestration после order-change: total → синхронизация бонусов → промо/min-price.
+ * Вызывать явно после мутаций заказа; не привязывать к каждому fetchTotal (цикл).
+ */
+declare function useCartRecalculation(deps: CartRecalculationDeps): CartRecalculation;
+
+/**
+ * View прикреплённого покупателя для UI. `national` форматируется потребителем
+ * (нужна app-специфичная маска страны — Nuxt useAppConfig), ядро его не считает.
+ */
+interface CachedCustomerView {
+    first_name: string;
+    last_name: string;
+    phone: {
+        number: string;
+        national: string;
+        country: string;
+    };
+}
+/**
+ * Контракт client-local кэша покупателя. Реализация — на стороне потребителя
+ * (localStorage + app-форматтер телефона), инжектится параметром в
+ * `useCustomerAttach` / `useCartCustomerAttachment`.
+ */
+interface AttachedCustomerCache {
+    forOrder: (orderId: MaybeRefOrGetter<string | null | undefined>) => ComputedRef<CachedCustomerView | null>;
+    set: (orderId: string, request: SetOrderCustomerRequest) => void;
+    clear: () => void;
+}
+
+interface CustomerAttachComposable {
+    /** Прикреплён ли покупатель к заказу (есть `order.customer`) */
+    isAttached: ComputedRef<boolean>;
+    /**
+     * Привязать customer к заказу (phone + имя + опционально фамилия / дата рождения).
+     * После успешного вызова заказ перечитываем с includes — чтобы `order.customer`
+     * попал в `cartStore.order` и компоненты могли его увидеть.
+     *
+     * Обёрнуто в activity('custom') — блокирует кнопку «Оформить» на время запроса.
+     */
+    attach: (request: SetOrderCustomerRequest) => Promise<void>;
+}
+/**
+ * Работа с прикреплением клиента к заказу.
+ *
+ * Используется в двух режимах OrderAuthenticationMethod:
+ * - `Disabled` — гость заполняет phone+name, `attach` до `checkoutOrder`
+ * - `Confirmation` — гость заполняет phone+name, после `checkoutOrder` придёт SMS
+ *
+ * Для `Preauth` обычно не нужно — customer прикрепляется автоматически,
+ * когда SDK имеет `api_token` клиента (см. `authStore`).
+ *
+ * @param cache client-local кэш покупателя (реализация потребителя — localStorage).
+ */
+declare function useCustomerAttach(cache: AttachedCustomerCache): CustomerAttachComposable;
+
+/**
+ * Привязывает customer'а авторизованного юзера к текущему заказу.
+ *
+ * Срабатывает в двух кейсах:
+ * 1) Юзер залогинился (auth state изменилась) — `notifyOnPhoneChange = true`,
+ *    в этом сценарии возможно был анонимный customer с другим телефоном —
+ *    показываем тост, если телефон реально изменился.
+ * 2) У авторизованного юзера появился новый заказ без customer'а
+ *    (например, после очистки корзины и добавления товара) — `notifyOnPhoneChange = false`,
+ *    тост не нужен, это безшумная синхронизация.
+ *
+ * @param cache client-local кэш покупателя (реализация потребителя — localStorage).
+ */
+declare function useCartCustomerAttachment(cache: AttachedCustomerCache): void;
+
+interface CartStockWatcher {
+    /**
+     * Реагирует на смену склада в обновлённом заказе: переключает stock,
+     * перегружает каталог при смене хэша и валидирует товары корзины.
+     */
+    handleStockChange: (updatedOrder: Order) => Promise<void>;
+}
+declare function useCartStockWatcher(): CartStockWatcher;
+
+interface DeliveryIntervalInput {
+    date: string;
+    id: string;
+}
+interface SettleOptions {
+    awaitSettle?: boolean;
+}
+interface OrderDeliveryDeps {
+    activity?: ActivityReporter;
+    notifier?: Notifier;
+}
+interface OrderDelivery {
+    setDelivery: (request: SetOrderDeliveryRequest, options?: SettleOptions) => Promise<Result>;
+    setDeliveryInterval: (selection: DeliveryIntervalInput, options?: SettleOptions) => Promise<Result>;
+    resetDeliveryInterval: (options?: SettleOptions) => Promise<Result>;
+    setDeliveryTime: (deliverAt: string, options?: SettleOptions) => Promise<Result>;
+}
+declare function useOrderDelivery(deps?: OrderDeliveryDeps): OrderDelivery;
+
+interface OrderPromocodeComposable {
+    /** Применённый к заказу промокод (читается из cartStore.order.promocode) */
+    applied: ComputedRef<OrderPromocode | null>;
+    isApplied: ComputedRef<boolean>;
+    loading: Ref<boolean>;
+    /** Сообщение об ошибке (невалидный / просрочен / не подходит к заказу) */
+    errorMessage: Ref<string | null>;
+    /** Применить промокод. Обёрнуто в activity('promocode'). */
+    apply: (code: string) => Promise<void>;
+    /** Убрать ранее применённый промокод */
+    remove: () => Promise<void>;
+    /** Сбросить состояние ошибки (например, при редактировании поля) */
+    clearError: () => void;
+}
+interface OrderPromocodeDeps {
+    notifier?: Notifier;
+    activity?: ActivityReporter;
+}
+declare function useOrderPromocode(deps?: OrderPromocodeDeps): OrderPromocodeComposable;
+
+declare function useCartDeliveryAttachment(): void;
+
+interface CartItemRequest {
+    productId: string;
+    productVariantId: string;
+    quantity?: number;
+    modifiers?: ProductModifiersRequest[];
+    productName?: string;
+    variantLabel?: string;
+    promotionId?: string;
+    promotionRewardId?: string;
+}
+interface CartDependencies {
+    notifier: Notifier;
+    activity: ActivityReporter;
+}
+interface CartOperations {
+    addToCart: (request: CartItemRequest) => Promise<void>;
+    removeFromCart: (request: CartItemRequest) => Promise<void>;
+    refreshCart: (options?: {
+        silent?: boolean;
+    }) => Promise<void>;
+    clearAndResetCart: () => void;
+}
+declare function useCartOperations(credentials: CartCredentials, initialization: CartInitialization, sdk: ZenkyStorefront, deps: CartDependencies): CartOperations;
+
+/** Провайдер reCAPTCHA-payload (реализация потребителя — Google reCAPTCHA v3). */
+type RecaptchaPayloadProvider = (action: RecaptchaAction) => Promise<{
+    token: string;
+} | undefined>;
+interface CheckoutSubmitComposable {
+    /** Последний результат `checkoutOrder` — нужен для UI (ConfirmationModal / online redirect) */
+    result: Ref<OrderCheckoutResult | null>;
+    /** Идёт ли сейчас submit */
+    submitting: Ref<boolean>;
+    /**
+     * Отправить заказ.
+     * Собирает `OrderCheckoutRequest` из `cartStore` (notes + persons_count).
+     * Возвращает `OrderCheckoutResult` с флагами confirmation/online_payment.
+     */
+    submit: () => Promise<OrderCheckoutResult | null>;
+    /** Подтвердить SMS-код (после checkoutOrder с confirmation.required) */
+    confirm: (code: string) => Promise<boolean>;
+    /** Переотправить код (с backoff — должен следить UI) */
+    resendCode: () => Promise<boolean>;
+    /** Отменить pending-заказ (cancelOrder) */
+    cancel: () => Promise<boolean>;
+}
+/**
+ * Финальный submit заказа + SMS-подтверждение.
+ *
+ * @param getRecaptchaPayload провайдер reCAPTCHA-токена (app-специфичен, инжектится).
+ */
+declare function useCheckoutSubmit(getRecaptchaPayload: RecaptchaPayloadProvider): CheckoutSubmitComposable;
+
+declare function useOrderChannel(): void;
+
+interface StorefrontCart {
+    order: Ref<Order | null>;
+    variants: ComputedRef<OrderProductVariant[]>;
+    itemCount: ComputedRef<number>;
+    totalPrice: ComputedRef<number>;
+    loading: Ref<boolean>;
+    initializing: Ref<boolean>;
+    hasOrder: ComputedRef<boolean>;
+    getProductQuantity: (productId: string) => ComputedRef<number>;
+    getVariantQuantity: (productVariantId: MaybeRefOrGetter<string | null>, modifiers: MaybeRefOrGetter<ProductModifiersRequest[]>) => ComputedRef<number>;
+    initializeOrder: () => Promise<void>;
+    addToCart: (request: CartItemRequest) => Promise<void>;
+    removeFromCart: (request: CartItemRequest) => Promise<void>;
+    refreshCart: (options?: {
+        silent?: boolean;
+    }) => Promise<void>;
+    clearAndResetCart: () => void;
+    recalculate: () => Promise<void>;
+}
+declare function useStorefrontCart(): StorefrontCart;
+
+export { type AttachedCustomerCache, type BonusesReconciliation, type BonusesReconciliationDeps, CASH_DENOMINATIONS_MAJOR, type CachedCustomerView, type CartCredentials, type CartDependencies, type CartErrorScope, type CartInitialization, type CartItemRequest, type CartLineKeyParams, type CartMutationComposable, type CartOperations, type CartQuantities, type CartRecalculation, type CartRecalculationDeps, type CartStockWatcher, type CashChangePresetsOptions, type CheckoutFlowFlags, type CheckoutSubmitComposable, type CustomerAttachComposable, DEFAULT_ROUND_STEPS_MAJOR, type MainPaymentRequestParams, type MutationKind, type MutationOptions, ORDER_EVENTS, ORDER_WITH, type OrderBonusesComposable, type OrderBonusesDeps, type OrderCredentialsLike, type OrderDelivery, type OrderDeliveryDeps, type OrderPromocodeComposable, type OrderPromocodeDeps, type OrderSettingsComposable, type OrderTotal, type PaymentSelection, type PaymentSelectionComposable, type RecaptchaPayloadProvider, type RetryOptions, type StorefrontCart, buildCartLineKey, buildCashChangePresets, buildMainPaymentRequest, getCartErrorCode, getCartErrorHttpCode, getCartErrorMessage, getCashDenominationsMinor, getDefaultRoundStepsMinor, getValidationErrors, logCartError, normalizeAddress, useBonusesReconciliation, useCartAddressSync, useCartCredentials, useCartCustomerAttachment, useCartDeliveryAttachment, useCartInitialization, useCartMutation, useCartOperations, useCartQuantities, useCartRecalculation, useCartStockWatcher, useCheckoutFlow, useCheckoutSubmit, useCustomerAttach, useOnlinePaymentRetry, useOrderBonuses, useOrderChannel, useOrderDelivery, useOrderPromocode, useOrderSettings, useOrderTotal, usePaymentSelection, useStorefrontCart, variantLineKey };

package/dist/cart/index.js

@@ -0,0 +1,13 @@
+export { CASH_DENOMINATIONS_MAJOR, DEFAULT_ROUND_STEPS_MAJOR, ORDER_EVENTS, ORDER_WITH, buildCartLineKey, buildCashChangePresets, buildMainPaymentRequest, getCartErrorCode, getCartErrorHttpCode, getCartErrorMessage, getCashDenominationsMinor, getDefaultRoundStepsMinor, getValidationErrors, logCartError, normalizeAddress, useBonusesReconciliation, useCartAddressSync, useCartCustomerAttachment, useCartDeliveryAttachment, useCartInitialization, useCartMutation, useCartOperations, useCartQuantities, useCartRecalculation, useCartStockWatcher, useCheckoutFlow, useCheckoutSubmit, useCustomerAttach, useOnlinePaymentRetry, useOrderBonuses, useOrderChannel, useOrderDelivery, useOrderPromocode, useOrderSettings, useOrderTotal, usePaymentSelection, useStorefrontCart, variantLineKey } from '../chunk-OQLU7FSR.js';
+export { useCartCredentials } from '../chunk-4MJKN7PL.js';
+import '../chunk-5QCUH3FF.js';
+import '../chunk-Z3IW4ODZ.js';
+import '../chunk-BWUKMWHL.js';
+import '../chunk-PWHIDGKW.js';
+import '../chunk-EYRCAUUP.js';
+import '../chunk-VL3T36VM.js';
+import '../chunk-V3VVDQIR.js';
+import '../chunk-RO25KNM5.js';
+import '../chunk-AL5W5JSD.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/cart/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/catalog/index.d.ts

@@ -0,0 +1,73 @@
+import { NestedCategory, Product, Store, City, Stock, RemoteCatalog, ZenkyStorefront, CollectionsListRequest, ProductsCollection } from '@zenky/storefront-api';
+
+/**
+ * Рекурсивный поиск категории в дереве по `short_id`.
+ *
+ * `NestedCategory[]` — это дерево: корневые категории на верхнем уровне,
+ * вложенные — внутри `children[]`. Простой `tree.find()` найдёт только
+ * корневые. Для вложенных (например «Куртки» внутри «Мужская» внутри «Одежда»)
+ * нужно рекурсивно обойти все ветки.
+ *
+ * Возвращает первое совпадение (DFS pre-order).
+ */
+declare function findCategoryByShortId(tree: NestedCategory[], shortId: string): NestedCategory | null;
+/**
+ * Находит корневого предка категории по `parent_id`.
+ *
+ * Для вложенной «Куртки» (parent: «Мужская») вернёт «Одежда» (корень ветки).
+ * Для корневой «Одежда» вернёт саму себя.
+ *
+ * Используется в `CategoryTabs`, чтобы подсветить корневой таб когда юзер
+ * находится на вложенной категории.
+ */
+declare function findRootAncestor(tree: NestedCategory[], category: NestedCategory): NestedCategory | null;
+/** Рекурсивный поиск по `id` (не `short_id`). Используется в findRootAncestor. */
+declare function findCategoryById(tree: NestedCategory[], id: string): NestedCategory | null;
+/**
+ * Возвращает путь от корневой категории до указанной (включительно).
+ *
+ * Пример для «Куртки» в ветке «Одежда → Мужская → Куртки»:
+ *   → [Одежда, Мужская, Куртки]
+ *
+ * Используется для построения хлебных крошек.
+ */
+declare function getCategoryPath(tree: NestedCategory[], target: NestedCategory): NestedCategory[];
+
+interface SubcategoryGroup {
+    category: NestedCategory;
+    products: Product[];
+}
+interface GroupedProducts {
+    rootDirect: Product[];
+    groups: SubcategoryGroup[];
+}
+declare function collectDescendantIds(category: NestedCategory): string[];
+declare function groupProductsBySubcategory(rootCategory: NestedCategory, products: Product[]): GroupedProducts;
+
+declare function getCity(store: Store, cityId?: string | null): City | null;
+declare function getStock(city: City, stockId?: string | null): Stock | null;
+declare function getRemoteCatalog(store: Store, city: City, stock: Stock | null): RemoteCatalog | null;
+
+/**
+ * Загрузка списка коллекций товаров магазина.
+ * Pure composable — SDK передаётся параметром (DI), Nuxt не нужен.
+ *
+ * NOTE: одиночный `getCollection(id)` в storefront API не предусмотрен,
+ * для получения товаров коллекции используется `GET /products?collection_id=...`.
+ * Чтобы получить метаданные коллекции — ищем в списке через `loadCollections`.
+ */
+declare function useCollections(sdk: ZenkyStorefront): {
+    loadCollections: (storeId: string, request?: CollectionsListRequest) => Promise<ProductsCollection[]>;
+};
+
+/** URL-хелперы каталога — единая точка правды для путей категорий/коллекций. */
+declare const catalogRoutes: {
+    /** Корневая страница каталога: список категорий + коллекций */
+    readonly index: () => string;
+    /** Страница конкретной категории */
+    readonly category: (shortId: string, slug: string | null) => string;
+    /** Страница конкретной коллекции */
+    readonly collection: (id: string) => string;
+};
+
+export { type GroupedProducts, type SubcategoryGroup, catalogRoutes, collectDescendantIds, findCategoryById, findCategoryByShortId, findRootAncestor, getCategoryPath, getCity, getRemoteCatalog, getStock, groupProductsBySubcategory, useCollections };

package/dist/catalog/index.js

@@ -0,0 +1,4 @@
+export { catalogRoutes, collectDescendantIds, findCategoryById, findCategoryByShortId, findRootAncestor, getCategoryPath, groupProductsBySubcategory, useCollections } from '../chunk-2OD7CLKD.js';
+export { getCity, getRemoteCatalog, getStock } from '../chunk-EYRCAUUP.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}